An astronaut overseeing a futuristic data hub
Download PDFMarkdown Version

Connect CARTO to ChatGPT, Claude and Gemini

Set it up once and it works in ChatGPT, Claude, Cursor, and any other client you love. It all runs safely in the background, so you can relax and focus on what really matters. Run complex GIS operations through a simple chat interface.

Ask AI about this Connector

Developed, maintained, and hosted by Vinkius.

MCP VERIFIED · PRODUCTION READY · VINKIUS GUARANTEED

Waiting for input…

Works with modern AI clients that support MCP, including ChatGPT, Claude, Cursor, and more.

ChatGPTClaudeCursorPerplexityGeminiMicrosoft CopilotRaycastMeta AI

Your AI does the work. We keep it safe and sound.

No other AI tool gives you this. Your workflow runs in the client you already love, your account stays protected, and you decide what the agent can and cannot do. It is the whole reason to make the switch.

Each Connector lives inside our infrastructure, the same place where your workflow runs. The three things below are already part of it, working quietly in the background so you never have to think about them. Nothing to add, nothing to set up, nothing to worry about.

A futuristic MCP client docking bay
V8 Isolate01

Each Connector runs inside its own sealed environment.

Each Connector runs inside its own sealed V8 runtime — no access to your files, your system, or other servers. A Connector never sees past its own request.

Kill Switch02

One switch stops every agent. Instantly.

One action deactivates every Connector, revokes every token, and ends every session at once. AI Governance keeps the record.

FinOps per User03

Spending limits that pause instead of surprise.

Every user keeps their own connections and credentials, isolated from everyone else. Anything that would cross your spending limit is held for your approval, not billed.

Three controls, built into the layer your AI connects through.

Curated set · 10 capabilities

We ship only the actions that matter.

Capability set01 / 03

01-04

4 capabilities in this set.

Part of 10 available through CARTO.

  1. 01

    Get import status

    This capability tracks the progress of a data import. It returns the current state, such as uploading or complete, and provides error details if something fails.

  2. 02

    Calculate route

    This capability finds the best driving path between two points. It returns the route as GeoJSON along with the total distance in meters and duration in seconds.

  3. 03

    Create async SQL job

    This capability submits long-running SQL queries to your data warehouse. It is built for heavy ETL tasks or complex joins that would otherwise time out.

  4. 04

    Execute SQL query

    This capability runs synchronous SQL queries against your connected warehouse. It works with BigQuery, Snowflake, Redshift, or PostgreSQL for quick data exploration and spatial joins.

Capability set02 / 03

05-07

3 capabilities in this set.

Part of 10 available through CARTO.

  1. 05

    Geocode address

    This capability converts a single address string into geographic coordinates. It is best for quick, individual lookups rather than large datasets.

  2. 06

    Geocode batch addresses

    This capability processes large lists of addresses into precise coordinates. It uses CARTO's Location Data Services to convert bulk CRM or customer datasets into lat/lon points in a single request.

  3. 07

    Import external file

    This capability loads data from a public URL into your warehouse. It supports CSV, GeoJSON, Shapefile, KML, GPX, and Excel formats.

Capability set03 / 03

08-10

3 capabilities in this set.

Part of 10 available through CARTO.

  1. 08

    List map datasets

    This capability retrieves a list of all available datasets in your CARTO organization. It provides metadata like table names, row counts, and privacy settings.

  2. 09

    Poll async job status

    This capability checks the status of a previously submitted asynchronous SQL job. It tells you if the job is pending, running, done, or failed.

  3. 10

    Calculate isoline

    This capability generates GeoJSON polygons representing reachable areas. You can specify a time or distance threshold to create service area maps or catchment zones.

Real work

What teams actually run

01

Service Area Analysis

Generate 15-minute drive-time polygons to see which customers fall within a specific delivery zone.

02

Automated Data Ingestion

Point your agent to a public URL to pull a GeoJSON or CSV file directly into your CARTO warehouse.

03

Route Optimization

Calculate the distance and duration for driving paths between specific coordinates.

04

Large Scale Geocoding

Convert entire CRM address lists into map-ready coordinates using batch processing.

Automate a task

Put CARTO to work on one thing.

Step-by-step automations your AI runs through this Connector: the workflow, the prompts to start with, and the exact capabilities behind each move.

One connector, every AI

CARTO works with the most popular AI clients.

These are the most popular clients, each with a step-by-step guide: one link, set up once, with governance and visibility built in. And because everything runs on the MCP standard, the same connection also works in any other compatible client — nothing to rebuild.

ClaudeClaudeChatGPTChatGPTGeminiGeminiPerplexityPerplexityGrokGrokMicrosoft CopilotMicrosoft CopilotCursorCursorVS CodeVS CodeWindsurfWindsurfJetBrainsJetBrainsClineClineLangChainLangChainVercel AI SDKVercel AI SDKLovableLovableZ.aiZ.aiRaycastRaycastQwen CodeQwen CodeKimi CodeKimi CodeLe ChatLe Chat

Building your own app? The connector is yours to use.

You don't need a client to put CARTO to work: the same hosted connection plugs into your own applications and agent code, with the same governance on every request. Build with it, chat with it — one connection for both.

Observed, not estimated

881ms average. Fast in production.

CARTO is checked daily against the live service.

Daily averagePeak 1140ms
Oct 3Today
Fastest day
675ms
Slowest day
1140ms
14-day trend
Stable+4%

Connect your client

One URL. Every client.

Activate the Connector, copy your link, and paste it into the client you already use. 10 capabilities arrive ready to run.

Preview access · not provider authentication

The vk_preview_* token belongs to Vinkius preview infrastructure. It lets Claude discover and display the capabilities of CARTO, so you can see the experience inside your AI.

It does not authenticate your account with CARTO. Actions requiring credentials or live account data may not run until you activate the Connector and authorize the service.

CARTO Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_6NUh4SJzIYKcgYcjPGz3lmRBTXiut011mCAsyHQM/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — CARTO capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "carto-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_6NUh4SJzIYKcgYcjPGz3lmRBTXiut011mCAsyHQM/mcp"
    }
  }
}
  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Step-by-step instructions for each client are in the guide. How to connect

Guided setup for Claude? Set up CARTO in Claude and other AIs

See all the AI clients this connector works with ↑

Who it's for

Built for the work CARTO owners hand off.

This MCP is built for professionals who need to bridge the gap between raw spatial data and actionable insights without manual GIS work.

  • 01

    GIS Analysts

    They use the agent to run testing queries and bulk geocode coordinates via a conversational interface.

  • 02

    Logistics Strategists

    They ask the agent to calculate delivery isolines and cross-reference them with population data.

  • 03

    Data Engineers

    They trigger data imports and manage heavy dataset syncs using the agent's toolset.

FAQ

Questions CARTO owners ask.

  • 01

    Which data warehouses are supported?

    This MCP works with BigQuery, Snowflake, Redshift, and PostgreSQL.

  • 02

    How do I handle very large SQL queries?

    Use the create_async_sql_job capability. It runs the query in the background and provides a job ID so you can check the status later.

  • 03

    Can I import files directly?

    Yes, use the import_external_file capability by providing a public URL for CSV, GeoJSON, Shapefile, KML, GPX, or Excel files.

  • 04

    What is the difference between geocode_address and geocode_batch_addresses?

    geocode_address is for looking up a single location, while geocode_batch_addresses is designed for processing large lists of addresses efficiently.

  • 05

    How do I know if my data import finished?

    You can use the get_import_status capability to check the progress and see if the state is complete or if an error occurred.

  • 06

    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.

  • 07

    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.

  • 08

    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.

Explore

More in Databases

Suggestions

Connect CARTO to Claude, Cursor, ChatGPT & more