Skip to content

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. Any US county works for this check, including one outside your plan. Finding a county does not add it to your plan.

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 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. Its SQL tools never return licensed property data, such as owner names and values. See query_project.

Who can connect#

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

Set up your client#

Connect MAIA from Claude's Connectors Directory. This works for Claude on the web, the desktop app, and mobile. MAIA has the Verified label in the directory.

  1. Open MAIA in Claude, or open Customize, then Connectors, and search for MAIA.
  2. Choose Connect to Claude.
  3. Sign in with your MAIA account. MAIA's consent page opens.
  4. Choose Allow. Claude lists MAIA's tools.
  5. In a chat, name MAIA in your message, such as "Use MAIA to find...". If Claude does not use MAIA, select the plus button in the composer, open Connectors, and check that MAIA is turned on.

Note

On a Claude Team or Enterprise plan, an owner adds MAIA for the organization first, from Organization settings, then Connectors. After that, each member connects their own account. On a Team plan, a member who cannot add connectors sees Request in place of the connect button. Request asks the owners to add MAIA.

If you cannot use the directory listing, add MAIA as a custom connector instead.

  1. Open Customize, then Connectors.
  2. Choose Add, then Add custom connector.
  3. Enter https://api.maia-analytics.com/mcp.
  4. Sign in with your MAIA account, and choose Allow.

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.

How sign-in works#

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#

The consent page refuses youLikely causeYour workspace does not have access to the connectorWhat to doContact support
Tools do not appear in Claude CodeLikely causeThe server was not added, or sign-in did not finishWhat to doRun claude mcp list, then /mcp and sign in again
Tool calls are refused after working beforeLikely causeYour access changed, or the grant was revokedWhat to doSign in again from your client. If the consent page refuses you, contact support
find_county finds nothingLikely causeThe name matches no US countyWhat to doAdd the state, or use the five-digit county code. When your plan has 20 or fewer counties, your client lists them. Pick one
MAIA does not add a county outside your planLikely causeYour Free workspace already has its county of choice, or you are not a workspace adminWhat to doUpgrade to Pro, or ask your admin. See Your county of choice

Next#