MCP Server for AI Agents (beta)

Build AI agents that can interact with ION

What is MCP?

Model Context Protocol (MCP) provides a standard interface that AI agents can use to interact with ION. Popular tools like Claude and Cursor work out of the box with our MCP server.

Developers can also use our MCP server to build custom agents on top of ION with tools like the AWS Strands SDK.

Claude Setup

Claude Pro plans or above are required to connect to the ION MCP Server

1. Go to Claude -> Your Profile -> Settings -> Connectors -> "Add custom connectors"

2. Give the MCP server a name, and enter the URL for the environment you are interested in testing with:

Ex: NAME: "ION-SANDBOX" URL: "https://mcp.staging.buildwithion.com"

1. Click "Connect" you will be prompted to sign in to ION

2. Done! You should be able to talk to Claude and have it interact with ION. Ask it for a list of things it can do in ION to get a sense of the capabilities.

Cursor Setup

A Cursor plan is required to use Cursor.

1. Open Cursor and go to Cursor settings

2. Click "Tools and MCP" -> "Add an MCP Server"

3. Enter this configuration, swapping the name and URL depending on the environment you want to connect too (you can have more than one):

{
  "mcpServers": {
    "ion": {
      "url": "https://mcp.staging.buildwithion.com/mcp"
    }
  }
}

1. To interact with the ION MCP Server, make sure you toggle on "Agent" mode by default the chat window is on "Ask" mode, which doesn't allow MCP servers.

2. Done! You should be able to use Cursor to interact with ION. Ask it for a list of things it can do in ION to get a sense of the capabilities.

Authentication

Authenticating to the MCP Server uses OAuth 2.1 DCR. This requires you to have an ION account already setup to authenticate too. If you are a developer wanting to build on top of ION, reach out an we can help you!

Environments

If an environment you are interested in is not present, reach out and let us know!

Environment	URL
staging-pub (sandbox)	https://mcp.staging.buildwithion.com/mcp
staging-gov (sandbox)	https://mcp.staging.gov.buildwithion.com/mcp
staging-aus (sandbox)	https://mcp.staging.ap.buildwithion.com/mcp
production-pub	https://mcp.buildwithion.com/mcp
production-gov	https://mcp.gov.buildwithion.com/mcp
production-aus	https://mcp.ap.buildwithion.com/mcp