Documentation

Isometric provides access to a remote MCP server. It allows suppliers, partners and verifiers to add key context on Isometric’s protocols, the Standard and the Certify and Registry platform into common AI chat or coding assistants.

Available tools

Isometric’s MCP server enables AI assistants to access the following resources to provide context to their responses:

The Isometric Standard
Isometric’s protocols
Isometric’s protocol modules
User guides for the Certify and Registry platform documented on this site
Isometric’s API documentation

Connecting to the server

The Isometric MCP server is provided at:

https://api.isometric.com/mcp

If you are using the sandbox environment, a version connected to its data is available at:

https://api.sandbox.isometric.com/mcp

You need to have a user account on the Certify or Registry platform to connect to it. Once connected, you can review which clients you have authorized, see when they were last used, and revoke their access under Team settings → AI Integrations.

Supported clients

Pre-approved clients

Remote MCP server integration is supported by most modern AI assistants. The clients below support MCP server connections and have been pre-approved by Isometric for authentication. Setup instructions are available from the link on each provider.

Anthropic Claude: Claude.ai, Claude Code
OpenAI ChatGPT
Google Gemini: CLI, Code Assist
Microsoft VS Code with Copilot
Cursor
Mistral: Vibe, Studio

Using the connector with other clients

You may also be able to use the Isometric MCP server with other clients. In order to connect, the following features must be supported by the client:

Streamable HTTP transport
Authorization
One of two supported client registration mechanisms:
- Client ID Metadata Document: this is the preferred mechanism for the connector, or
- Pre-registration: this method requires creation of a client ID. Isometric will accept any arbitrary client ID and no secret is required.

The domains for the URI to which users are redirected after authorizing and for the CIMD client ID (if present) must also be allowlisted by Isometric. If connecting to the server fails with a Failed to fetch CIMD document or Failed to verify TLS certificate of CIMD/redirect URI error, but your client works correctly with other MCP servers, please contact Isometric at support@isometric.com to request domain approval.

If your client prefers the DCR method and fails because it does not discover support for it, you may need to configure a client ID, as with the preregistration method above. For example, Google Gemini CLI requires this approach as of May 2026.

Setup examples

Claude

Isometric is available as an official Claude connector.

Open connector settings

Open Settings → Customize → Connectors on Claude.ai or in Claude Desktop.

Browse connectors

Click Add → Browse connectors and find Isometric in the connector directory.

Connect to the Isometric connector

Click Connect. If you are not already logged into Isometric in your browser, you will be prompted to log in first. You will then be shown a consent screen to allow the MCP connection. Click Allow to complete the connection.

If you are on a Claude Team or Enterprise plan, the connector may first need to be enabled for your organization. Organization owners can manage connectors at Organization settings → Connectors.

The official connector uses the production server. To connect to the sandbox environment instead, add its URL as a custom connector via Add → Add custom connector on the same settings page.

Claude Desktop showing the Isometric MCP connector — Example responses from Claude Desktop with the Isometric MCP connector

Claude Desktop showing the response to a question about API usage — Example responses from Claude Desktop with the Isometric MCP connector

ChatGPT

Setup instructions are also available in the OpenAI ChatGPT MCP documentation.

Add MCP server

Go to the Settings → Plugins → MCPs tab. Add MCP server with type as Streamable HTTP and URL as https://api.isometric.com/mcp or https://api.sandbox.isometric.com/mcp as required.

Add client_id to configuration

In ~/.codex/configuration.toml, add oauth = { client_id = "chat-gpt" } under the section corresponding to the MCP server you just added. E.g.

[mcp_servers.isometric]
enabled = true
url = "https://api.isometric.com/mcp"
oauth = { client_id = "chat-gpt" }

Suggested prompts

Some suggested prompts to test the MCP server connection are shown below:

What Isometric-specific capabilities do you have?

How does attribution of emissions work in Certify?

What modules does the Biochar v1.2 protocol reference?

What are the key differences between Biochar v1.1 and v1.2 protocols?

Usage tips

General advice

If you are unfamiliar with AI assistants, reading educational guides on working with these tools, such as Anthropic’s free AI Fluency course are a good starting point. Assistants can also help guide you on how to get the most out of them: asking them how to work with them effectively as an initial prompt can be a helpful place to begin. If asking multiple different questions, it’s generally best to start a new chat for each question rather than continuing a previous chat, as models usually perform better with shorter conversation histories. If you want to clarify a prompt to get a better answer, editing your original prompt is usually more effective than adding further context in a second prompt.

Base prompts

Using a base prompt can help to ensure more reliable behavior from an AI assistant. For chats using the Isometric MCP server, consider using the following base prompt or a similar version:

Example base prompt

# If you need information about Isometric

If you need authoritative information about the Isometric platform to answer my question or solve a task I have for you, you MUST follow the rules set out below.

## Permitted information sources

You MUST use the Isometric MCP server to answer any users questions about the Isometric platform.

You MUST NOT use the Internet or other sources. The ONLY permitted information source is Isometric's official MCP server.

## Answering users' questions

Before answering the question, use the `how_to` tool to more effectively use the capabilities provided by the server.

When answering the question, you MUST state the source of your answer. For example, an Isometric protocol, module or official documentation.

## Error conditions

If the official Isometric MCP server is not available to you, you MUST state to the user that the integration is broken and an IT administrator must review it.

If the server is available, but it doesn't provide information that the user asks about, you MUST tell the user that this capability is missing from the Isometric MCP server. You MUST suggest sharing feedback with Isometric to add/amend it.

When you encounter ANY issues with MCP server tools (incorrect URLs, unexpected responses, errors, data inconsistencies), you MUST report them to the Isometric team using the `submit_feedback` tool.

​Available tools

​Connecting to the server

​Supported clients

​Pre-approved clients

​Using the connector with other clients

​Setup examples

​Claude

​ChatGPT

​Suggested prompts

​Usage tips

​General advice

​Base prompts

Available tools

Connecting to the server

Supported clients

Pre-approved clients

Using the connector with other clients

Setup examples

Claude

ChatGPT

Suggested prompts

Usage tips

General advice

Base prompts