MCP

Connect MAIA to Claude or ChatGPT

MAIA's MCP connector is a remote MCP server that lets Claude, ChatGPT, and other MCP clients hand research to MAIA's agent. You connect once, sign in with your MAIA account, and dispatch work from the client you already use.

What you end with#

Your client lists MAIA's tools, and a request like this one comes back with a county code.

You ask

Use MAIA to find Boulder County, Colorado.

The client calls find_county and shows the county's name and its five-digit county_fips. If it does, you are connected. On the Free plan, name one of your six counties instead. A county outside your plan is not found, even when the connection works.

What the connector is#

MCP is an open protocol that lets an AI client call tools on a server. MAIA's connector is such a server, at https://api.maia-analytics.com/mcp over HTTP. Through it, your client can start a project, send a request, follow the run, answer MAIA's questions, and read the result.

The connector reaches the same agent, the same data, and the same projects as the web app. A project you start from your client opens in MAIA. One you start in MAIA is there for your client. Work over MCP spends credits as it does in the app.

Who can connect#

You need a MAIA account. If the consent page refuses your sign-in, contact support.

Set up your client#

For Claude on the web and the desktop app.

Note

On a Claude Team or Enterprise plan, an owner adds the connector for the organization first. Until then, members do not see Add custom connector. After that, each member connects their own account.

Open Settings, then Connectors.
Choose Add custom connector.
Enter https://api.maia-analytics.com/mcp.
Sign in with your MAIA account. MAIA's consent page opens.
Choose Allow. Claude lists MAIA's tools.

Install MAIA from ChatGPT's plugin directory.

Open MAIA in ChatGPT, or search for MAIA in ChatGPT Plugins.
Choose Install plugin.
Sign in with your MAIA account.
Choose Allow. ChatGPT adds MAIA.
In a chat, name MAIA in your message, such as "Use MAIA to find...". You can also choose MAIA from the plus menu in the composer.

Note

On a ChatGPT Business or Enterprise plan, an admin may need to allow MAIA for the workspace first.

If your workspace does not allow directory apps, connect MAIA in Developer mode instead. Developer mode is on Plus, Pro, Business, Enterprise, and Education plans, on the web.

Open Settings, then Security and login, and turn on Developer mode.
Go to ChatGPT Plugins and select the plus button to create an app. The plus button creates an app only after Developer mode is on.
Name it MAIA, enter https://api.maia-analytics.com/mcp as the MCP server URL, and set Authentication to OAuth.
Choose Create, then sign in with your MAIA account and choose Allow.
In a chat, choose Developer mode from the plus menu in the composer, and select MAIA.

Add the server:

claude mcp add --transport http maia https://api.maia-analytics.com/mcp

By default it is added to the current project only. Add --scope user to use it from every project. Then sign in:

Run /mcp in Claude Code and pick maia.
Your browser opens MAIA's consent page. Sign in with your MAIA account.
Choose Allow. MAIA's tools appear in Claude Code once sign-in finishes, and not before.

Any client that supports remote MCP servers over HTTP with OAuth can connect, including developer tools such as Codex, Cursor, VS Code, and Gemini CLI. Give it the address https://api.maia-analytics.com/mcp. The client opens MAIA's consent page when it first needs access.

Many of these tools read an mcpServers block like this one. Check your tool's docs for the exact key.

{
  "mcpServers": {
    "maia": {
      "url": "https://api.maia-analytics.com/mcp"
    }
  }
}

Let MAIA's tools run without asking#

Your client may ask you before each MAIA tool call. A run calls get_run many times, so set MAIA's tools to always allow. Keep approve_step on ask. It approves the steps that spend credits or delete a layer, and the prompt shows you what the step does. See Runs and approvals.

The connector uses OAuth. You sign in to MAIA in your browser, and MAIA hands your client a token. Your client never sees your password.

The connector acts as you. It can see the projects you can see, and nothing more.
Consent is per client. Each client you connect asks for it.
You must have accepted MAIA's current terms. If you have not, the consent page shows them first. Accept them, then choose Allow.

Troubleshooting#

What you see	Likely cause	What to do
The consent page refuses you	Likely causeYour workspace does not have access to the connector	What to doContact support
Tools do not appear in Claude Code	Likely causeThe server was not added, or sign-in did not finish	What to doRun `claude mcp list`, then `/mcp` and sign in again
Tool calls are refused after working before	Likely causeYour access changed, or the grant was revoked	What to doSign in again from your client. If the consent page refuses you, contact support
`find_county` finds nothing	Likely causeThe county is not in your plan	What to doYour client lists the counties you can use when your plan has 20 or fewer. Pick one, or see Plans

Next#

Runs and approvals follows a run from start to finish.
Upload a file brings a file you attach in the chat into a project.
Tools lists every tool and its parameters.
Prompts lists the ready-made requests.