Documentation

Capabilities

Isometric’s remote MCP server, available at https://api.isometric.com/mcp, connects your AI assistant to the Isometric platform, so it can do real work for you there. It is available to suppliers, verifiers and partners with a user account on Certify or Registry. With the server connected, your assistant can:

Read the Isometric Standard and every protocol, at any version, and answer precise questions about their requirements, citing the protocol text.
Read the data you have access to in Certify and Registry: your projects, issues, credits, documents and everything else the platform shows you.
Browse Isometric’s documentation: the Certify and Registry user guides and the full API reference, including the OpenAPI descriptions of the REST APIs.
Follow Isometric’s skills: step-by-step guides for common workflows.
Act on your own work where the platform allows it, such as commenting on an issue or updating a project you manage.
Send feedback about the server directly to the Isometric team.

Everything the assistant does is recorded as you, with exactly the permissions you have on the platform: your organisation’s data, data explicitly shared with you (for example as a verifier) and public registry data. Most tools are read-only. The tools that change data are clearly annotated and limited to fixed, narrowly scoped operations. You can review and revoke authorised AI clients at any time under Settings → AI Integrations. Some prompts to try once connected:

What Isometric-specific capabilities do you have?

How does attribution of emissions work in Certify?

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

List the projects I have access to with their status and protocol.

Connecting

Official integrations

Claude

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.

ChatGPT

Isometric’s official ChatGPT plugin is coming soon. In the meantime, enable developer mode in ChatGPT, then go to Plugins → New plugin and use the configuration for Other clients.

Other clients

Server URLs

The production server, connected to live Certify and Registry data, is at:

https://api.isometric.com/mcp

The sandbox server, connected to the sandbox environment’s data, is at:

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

Both require a user account on the corresponding environment.

Read-only access

If you want an assistant to answer questions without ever changing anything, send either server the following header with each request:

X-Isometric-Read-Only: true

The server then hides every tool that changes data.

This is a convenience for clients that want to limit themselves, not a permission setting. It does not restrict what you or your team can do elsewhere on the platform.

Connection requirements

Any MCP client can connect to the Isometric MCP server if it supports the following features:

Streamable HTTP transport
OAuth 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 Dynamic Client Registration (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.

Pre-approved clients

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.

Usage tips

Learning to work with AI

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.

Controlling actions that change data

Every operation that changes data is exposed as a separate MCP tool. This gives you granular control over actions that could be dangerous. Many AI assistants will ask users for confirmation before running an unfamiliar tool, but can also let them skip that with a per tool configuration such as “always allow”. For example, on Claude Team and Enterprise plans, organization owners can decide per tool whether users may choose “always allow” at Organization settings → Connectors. To completely disable all tools with the ability to change data, use the read-only header.

Base prompt or skill

Using a base prompt or skill can help ensure more reliable behavior from an AI assistant. For chats using the Isometric MCP server, consider using the following base prompt or skill, 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.

​Capabilities

​Connecting

​Official integrations

​Claude

​ChatGPT

​Other clients

​Server URLs

​Read-only access

​Connection requirements

​Pre-approved clients

​Usage tips

​Learning to work with AI

​Controlling actions that change data

​Base prompt or skill

Capabilities

Connecting

Official integrations

Claude

ChatGPT

Other clients

Server URLs

Read-only access

Connection requirements

Pre-approved clients

Usage tips

Learning to work with AI

Controlling actions that change data

Base prompt or skill