> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sovrnti.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Compare products

> Settle a shortlist: put 2–3 products side by side.

Put 2–3 products side by side on Innovation, Control and Scale: one column each, rows grouped by area. In Claude.ai and supported clients the table renders inline, with a country picker.

You choose the products. Pass 2–3 product ids — typically the ones you just saw in a [Snapshot](/mcp/tools/sovrnti_market_get_snapshot) — and the tool builds the grid for exactly those.

## What you get

The standardized comparison grid. Each axis (Innovation, Control, Scale) holds rows; each row maps to a real capability group or control dimension in the graph — no aggregate, coverage, or verdict row mixed in:

```json theme={null}
{
	"market": { "marketId": "mkt-collaboration", "name": "Collaboration & Productivity" },
	"products": [
		{ "productId": "google-workspace", "name": "Google Workspace" },
		{ "productId": "proton-workspace", "name": "Proton" }
	],
	"dimensions": [
		{
			"name": "Control",
			"rows": [
				{
					"label": "Legal Control",
					"sub": "Jurisdiction of laws; resistance to foreign legal demands",
					"type": "band4",
					"values": { "google-workspace": 1, "proton-workspace": 3.5 }
				}
			]
		}
	],
	"countryFilter": null
}
```

Every row is `type: "band4"` (a 0–4 scale with half steps). The shared comparison-row contract also defines `text` (free string) and `boolean` (`yes` / `partial` / `no`) cell types for other comparison tools, but this tool only ever emits `band4`. A `null` value means the product has no data for that row in the current view. `countryFilter` is the country lens actually applied, or `null` for the baseline view. For a composite 0–100 score per axis, use [Snapshot](/mcp/tools/sovrnti_market_get_snapshot), [CapaIndex](/mcp/tools/sovrnti_market_get_capaindex), or [Sovrnti Max](/mcp/tools/sovrnti_market_get_sovrntimax) — Compare's rows are deliberately the leaf-level detail underneath those composites, not another place to report them.

## How to use it

Ask your assistant:

```text theme={null}
Compare Google Workspace and Proton in the collaboration market.
```

Or pin a jurisdiction:

```text theme={null}
Compare Microsoft 365, Google Workspace and Proton for collaboration, viewed from France.
```

Your assistant pulls a [Snapshot](/mcp/tools/sovrnti_market_get_snapshot) (or calls [List markets](/mcp/tools/sovrnti_markets_list)) to get the product ids and market first, then runs the comparison for the products you named.

## Troubleshooting

* **`invalid-input`** — pass 2 or 3 product ids, and a two-letter country code (e.g. `FR`) or none. Fewer than 2 or more than 3 products is rejected.
* **`market-not-found`** — the market is well-formed but doesn't exist. Ask your assistant to list markets first.
* **`insufficient-credits`** — wallet empty. Top up in your organization's billing page.
* **Empty cells or a missing product** — a product with no evaluation in the selected country shows blank cells; switch the country lens (or use the baseline view) to see it.

## See also

* [Get snapshot](/mcp/tools/sovrnti_market_get_snapshot) — the whole market on Innovation × Control × Scale, and where the product ids come from.
* [Get Capability Index](/mcp/tools/sovrnti_market_get_capaindex) — every product ranked by capability alone.
* [List markets](/mcp/tools/sovrnti_markets_list) — find the right market first.