Workflows as MCP Tools

MCP Tools in CARTO are built from Workflows. Each tool you create defines how to solve a specific spatial problem, what inputs it needs, and what results it returns.

This guide shows you how to configure a Workflow as an MCP Tool.

Step 1: Create a Workflow

Build a Workflow that solves the specific problem you want agents to handle. For example, if you want agents to find nearby stores, create a workflow that performs that spatial query.

Step 2: Add an MCP Tool Output

Add the MCP Tool Output component to your workflow. This defines what the tool returns.

Choose the output mode:

• Sync: Returns results immediately (use for fast queries)

• Async: Returns results after processing completes (use for long-running operations)

Step 3: Configure the tool

Click the three-dot menu in the top-right corner and select the MCP Tool settings.

When the dialog opens up, write a clear description explaining what the tool does. Make sure to also. Define all input parameters with descriptive names and descriptions and enable the tool to make it available through the MCP Server.

Example description: "Finds the 5 nearest retail stores to a given location and returns their addresses and distances."

Step 4: Sync changes

When you update a workflow, click Sync to propagate changes to the MCP Tool. This ensures agents always use the latest version.

Step 5: Use your own tools

Once your workflow is configured as an MCP Tool, you can:

• Connect external agents (like Gemini CLI) to your CARTO MCP Server. See Using MCP Tools with CARTO.

• Give CARTO AI Agents access to the tool. See Adding MCP Tools to AI Agents.