CARTO Connector for AI agents.
10 live capabilities
Perform spatial SQL and geocoding on your CARTO platform without using the GIS interface.
Waiting for input…
Why people use CARTO
CARTO for Spatial SQL and Geocoding
With the CARTO MCP, you just tell your agent what you need to see. It handles the SQL execution, the geocoding of your lists, and the creation of isolines in one go. You get a direct path from a business question to a spatial result without the manual middleman.
What Vinkius changes
You get a conversational interface for your entire CARTO spatial analytics stack.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 5,900+ Connectors
- Real-world use case 01
Delivery Zone Planning
A logistics manager asks the agent to find all areas reachable within 20 minutes from a warehouse.
- Real-world use case 02
Customer Data Enrichment
A retail lead provides a list of 500 store addresses.
- Real-world use case 03
Warehouse Data Sync
A data engineer needs to move a 5GB GeoJSON file from a cloud bucket.
Complete set · 10capabilities
The complete CARTO capability set.
These are the exact actions your AI can choose when you ask it to work with CARTO.
01—04
4 capabilities in this set.
Part of 10 available through CARTO.
- 01 Capability
Poll async job status
Check the status of long-running SQL jobs to see if they've finished. It provides updated timestamps and error messages.
- 02 Capability
Calculate isoline
Create travel-time or distance polygons around a specific starting point. This is perfect for service area and reachability analysis.
- 03 Capability
Calculate route
Get the optimal driving path between two points. It returns the distance, duration, and route geometry for your maps.
- 04 Capability
Create async sql job
Run heavy SQL queries that take longer than 60 seconds as background jobs. This handles large table transformations and complex joins.
05—07
3 capabilities in this set.
Part of 10 available through CARTO.
- 05 Capability
Execute sql query
Run quick SQL queries for data exploration and spatial joins in real time. It returns results directly as JSON rows.
- 06 Capability
Geocode address
Turn a single address string into latitude and longitude coordinates. Use this for quick, individual lookups.
- 07 Capability
Geocode batch addresses
Convert a large list of addresses into coordinates in a single batch request. This is the best way to handle customer lists.
08—10
3 capabilities in this set.
Part of 10 available through CARTO.
- 08 Capability
Get import status
Check the progress of a data import job to see if it's finished or failed. It returns the table name and progress percentage.
- 09 Capability
Import external file
Load CSV, GeoJSON, or Shapefiles into your data warehouse from a URL. It creates a new managed table for your analysis.
- 10 Capability
List map datasets
See all the maps and tables currently available in your CARTO organization. Use this to audit your assets and check freshness.
Set up in minutes
One URL. Then ask CARTO to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use CARTO from the conversation.
Choose your client
Live previewAdvanced clients IDE · CLI
Claude · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_6NUh4SJzIYKcgYcjPGz3lmRBTXiut011mCAsyHQM/mcp - Step 01
Open Connectors
In Claude Web or Claude Desktop, open Settings and choose Connectors.
- Step 02
Add the URL
Choose Add custom connector, name it CARTO, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable CARTO for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_6NUh4SJzIYKcgYcjPGz3lmRBTXiut011mCAsyHQM/mcp - Step 01
Open MCP settings
On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
- Step 02
Add the URL
Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the CARTO URL.
- Step 03
Save and start
Save the connection and enable CARTO in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"carto": {
"url": "https://edge.vinkius.com/vk_preview_6NUh4SJzIYKcgYcjPGz3lmRBTXiut011mCAsyHQM/mcp"
}
}
}- Step 01
Open MCP Settings
Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
- Step 02
Add the server config
Paste the JSON configuration above into the mcp.json file that opens
- Step 03
Save the file
Cursor will automatically detect the new Connector
- Step 04
Start using CARTO
Open Agent mode in chat and ask: "Using CARTO, help me...". 10 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"carto": {
"url": "https://edge.vinkius.com/vk_preview_6NUh4SJzIYKcgYcjPGz3lmRBTXiut011mCAsyHQM/mcp"
}
}
}- Step 01
Create MCP config
Create a .vscode/mcp.json file in your project root
- Step 02
Add the server config
Paste the JSON configuration above
- Step 03
Enable Agent mode
Open GitHub Copilot Chat and switch to Agent mode using the dropdown
- Step 04
Start using CARTO
Ask Copilot: "Using CARTO, help me...". 10 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"carto": {
"url": "https://edge.vinkius.com/vk_preview_6NUh4SJzIYKcgYcjPGz3lmRBTXiut011mCAsyHQM/mcp"
}
}
}- Step 01
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
- Step 02
Add the server
Paste the JSON configuration above into mcp_config.json
- Step 03
Save and reload
Windsurf will detect the new server automatically
- Step 04
Start using CARTO
Open Cascade and ask: "Using CARTO, help me...". 10 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"carto": {
"url": "https://edge.vinkius.com/vk_preview_6NUh4SJzIYKcgYcjPGz3lmRBTXiut011mCAsyHQM/mcp"
}
}
}- Step 01
Open Cline MCP Settings
Click the Connectors icon in the Cline sidebar panel
- Step 02
Add remote server
Click "Add Connector" and paste the configuration above
- Step 03
Enable the server
Toggle the server switch to ON
- Step 04
Start using CARTO
Ask Cline: "Using CARTO, help me...". 10 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add carto --transport http "https://edge.vinkius.com/vk_preview_6NUh4SJzIYKcgYcjPGz3lmRBTXiut011mCAsyHQM/mcp"- Step 01
Install Claude Code
Run npm install -g @anthropic-ai/claude-code if not already installed
- Step 02
Add the Connector
Run the command above in your terminal
- Step 03
Verify the connection
Run claude mcp to list connected servers, or type /mcp inside a session
- Step 04
Start using CARTO
Ask Claude: "Using CARTO, show me...". 10 tools are ready
Where the request belongs
Work CARTO can move forward.
GIS analysts who are tired of manual SQL debugging, retail strategists planning delivery zones, and data engineers who need to move large spatial files without a GUI.
GIS Analyst
Runs spatial joins and tests queries on customer datasets to see where demand is highest on a Tuesday afternoon.
Retail Strategist
Calculates 15-minute delivery zones to decide where to open new locations based on population layers.
Data Engineer
Triggers massive data imports and syncs from external sources using simple commands instead of manual uploads.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsArcGIS
Automate mapping and spatial analysis via ArcGIS. perform geocoding, route solving, vehicle routing, and calculate origin-destination matrices from any AI agent.
Stadia Maps
Equip your AI with advanced geospatial routing and mapping logic. Calculate distances, geocode coordinates, and plot optimized trips securely.
Mapbox (Maps & Geospatial)
Build with location data via Mapbox. geocode addresses, calculate routes, and solve trip optimization.
Felt (Collaborative Maps)
Create and manage collaborative maps. upload geographic data, style layers, and manipulate map elements directly from any AI agent.
Jawg Maps (Location & Routing)
Build with location data via Jawg Maps. search places, calculate routes, compute distance matrices, and get elevation data.
Geoapify
Access powerful location intelligence. geocoding, routing, place search, and IP tracking directly from your AI agent.
Bring your own AI
Change the model, client or framework. Keep CARTO connected.
-
Claude -
ChatGPT -
Gemini -
Cursor -
VS Code -
Windsurf -
ZCode -
Cline -
Zed -
Continue -
Kiro -
Roo Code -
Zencoder -
Goose -
Void -
Augment Code -
Amp -
Qodo -
Tabnine -
Pieces -
Sourcegraph Cody -
JetBrains -
Warp -
Amazon Q -
Antigravity -
BoltAI -
Raycast -
Jan -
LM Studio -
AnythingLLM -
Open WebUI -
Msty -
Cherry Studio -
LibreChat -
TypingMind -
Chorus -
5ire -
n8n -
LangChain -
LlamaIndex -
CrewAI -
Vercel AI SDK
Before you connect
Questions about CARTO.
The practical details behind the request, access and result.
What can I do with the CARTO MCP?
You can use your AI agent to run spatial SQL, geocode addresses, and generate travel routes directly on your CARTO platform. It turns your natural language into GIS actions.
Can I use this to calculate delivery zones?
Yes. You can ask your agent to generate travel-time isolines. It will calculate the reachable area based on time or distance and give you the geometry for your maps.
Does the CARTO MCP support bulk geocoding?
Yes, it supports batch geocoding. You can give your agent a list of addresses, and it will convert them all into coordinates in one step.
How do I run SQL queries on my warehouse with CARTO?
Simply tell your agent what data you want to see. It will execute the SQL query against your connected warehouse and show you the results in the chat.
Can I import data files into CARTO using my AI agent?
Yes. If you provide a public URL for a CSV or GeoJSON file, your agent can trigger a data import to bring that file into your CARTO workspace.
Does this Connector work with BigQuery or Snowflake?
Yes, it works with major cloud warehouses including BigQuery, Snowflake, and Redshift, allowing you to run spatial queries on your existing data.
How does the CARTO MCP handle long-running spatial jobs?
It handles heavy queries as asynchronous jobs. Your agent can start a long-running task and then check back later to see when it's finished.
Can my AI agent orchestrate heavy spatial analytics on large datasets directly?
Yes. While small checks use the immediate SQL endpoint, your agent knows how to use the async Job API to submit massive postGIS or BigQuery geospatial operations on millions of rows. It automatically polls the remote status and notifies you once your heavy data transformation is structurally completed.
Am I able to geocode raw customer addresses in bulk through the agent?
Definitely. Give your agent a list of unstructured addresses and it will fire the bulk geocode_batch_addresses capability. CARTO’s native LDS engine (powered by TomTom/HERE) returns the validated geo-coordinates for each row, avoiding manual CSV matching.
Can the agent create travel-time polygons (Isolines)?
Absolutely. The agent uses the calculate_isoline capability passing the desired travel duration and coordinate center. It immediately receives a precise GeoJSON polygon defining the catchment zone or service area, without requiring you to use the map UI.
One connection away
Give your agent a direct line to CARTO.
Connect CARTO once. Keep it beside 5,900+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available