Connect AI Assistants to MapGO

Give Claude, ChatGPT, Cursor or any MCP client direct access to MapGO's geospatial tools. Sign in with your existing MapGO account — no API key to generate or paste.

Getting Started

Add a custom connector

In your MCP client's settings (for example Claude's Settings → Connectors → Add custom connector), paste the endpoint below.

https://mapgo.io/api/mcp

Connect and sign in

Click Connect and sign in with your existing MapGO account. There's no API key involved — the connector authenticates through the same sign-in you already use on mapgo.io.

Ask a question

Once connected, just ask — for example "How far is this point from the sea?" The assistant picks the right MapGO tool automatically.

Using Claude Code?

Add the connector from the command line instead:

claude mcp add --transport http mapgo https://mapgo.io/api/mcp

Requirements

Starter plan or above: The MCP connector requires a Starter, Professional or Business plan. It is not included on Free or on the $9 Scout plan — connecting successfully on Scout still returns an upgrade message on the first question.
A MapGO account: Sign in with your existing MapGO account when prompted. No API key to generate, copy or rotate.
Monthly quota: Every tool except coordinate conversion counts as one lookup against your plan's monthly request quota — the same quota bulk CSV uploads and the spreadsheet add-ons draw from, not the daily Analyze-tool search counter.

Compare plans (Scout $9, Starter $29, Professional $79, Business $199) →

Available Tools

5 tools — ask in plain language, the assistant calls the right one

mapgo_location_hierarchy

1 lookup

Continent, country, region, subregion, district, municipality and ISO code for a coordinate.

Example question

"What administrative region is 48.8566, 2.3522 in?"

mapgo_border_distance

1 lookup

Distance to the nearest international land border, in km and miles, plus the country on the other side.

Example question

"How far is this point from the nearest border, and which country is it?"

mapgo_coastline_distance

1 lookup

Distance to the nearest coastline, in km and miles.

Example question

"How far is this point from the sea?"

mapgo_point_distance

1 lookup

Great-circle distance and initial bearing between two coordinates.

Example question

"What's the distance and bearing from Paris to Rome?"

mapgo_convert_coordinates

Free

DMS and UTM notation for a coordinate.

Example question

"Convert 41.8902, 12.4922 to DMS and UTM."

Tips & Notes

Coordinate conversion (mapgo_convert_coordinates) is free and never counts against your monthly quota.
Location hierarchy, border distance, coastline distance and point-to-point distance each count as one lookup, same as an Analyze tool search.
Distance calculations are approximate great-circle distances based on polygon shapefiles.
If you're on the Scout plan, the connector will connect, but tool calls will return an upgrade message until you move to Starter or above.

Need help?

If you have questions or run into issues connecting, we're here to help.