How to Use the CARTO MCP in Cursor

Q: How do I monitor long jobs in Cursor?

Use pollasyncjobstatus to check the progress of your SQL tasks. The agent can keep track of these jobs and notify you when they finish.

Inject live spatial data and routing geometry into your code with CARTO and Cursor.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect CARTO MCP to Cursor

Create your Vinkius account to connect CARTO to Cursor and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup CARTO with Cursor

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate spatial analysis in Cursor

Let your agent write code that interacts with your data warehouse using `execute_sql_query`. You'll see the AI generate actual SQL for your spatial operations. When your queries hit the one-minute limit, the agent can switch to `create_async_sql_job`. This keeps your workflow moving while the heavy lifting happens in the background.

Build routing features with Cursor

Use `calculate_route` to pull real-world driving durations and distances into your application logic. The agent can take these GeoJSON outputs and wire them directly into your map components. It eliminates the need to mock your routing data. You get the actual coordinates and timing metrics required to build functional navigation features.

Automate data ingestion in Cursor

Import external files into your warehouse by calling `import_external_file` from your editor. The agent can monitor the load using `get_import_status` until the table is ready for use. This workflow lets you update your datasets without switching context. You spend less time moving files and more time writing the features that use them.

Setup guide

Set up CARTO MCP in Cursor

Prerequisites

Cursor installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP Settings

Go to Cursor Settings → MCP or open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and search for "MCP: Add Server".
2

Add the CARTO MCP

Cursor will create or open .cursor/mcp.json in your project root. Paste the JSON snippet on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Enable Agent mode

Open Composer (Cmd+I / Ctrl+I) and switch to Agent mode using the dropdown at the top. MCP tools are only available in Agent mode.
4

Verify the connection

Ask Cursor something like "List my recent CARTO transactions." If the MCP tools are loaded correctly, Cursor will call the CARTO tools automatically. You can also check Settings → MCP for a green status indicator.

.cursor/mcp.json

{
  "mcpServers": {
    "carto-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by CARTO. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect CARTO now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about CARTO MCP in Cursor

Create an mcp.json file in your project root and add the server configuration. Enable Agent mode in your chat to start using the tools.

Yes, you can run SQL commands that modify your tables. The agent can execute these safely as long as you provide the correct connection permissions.

It gives your AI agent direct access to your live data warehouse. You get code that works with real spatial functions instead of placeholder logic.

Use `poll_async_job_status` to check the progress of your SQL tasks. The agent can keep track of these jobs and notify you when they finish.

Your data remains within your warehouse infrastructure. The MCP server acts only as a bridge for the API calls you authorize during your coding session.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript