How to Use the Geocodio MCP in Claude Code

Q: How do I see the available Geocodio data fields from the terminal with Claude Code?

Just run claude code "list the schema fields for geocodio". This executes the listschemafields tool on the MCP server and prints a clean list of all the data you can request, from school districts to state legislative districts.

Pipe addresses into the Geocodio MCP Server from your terminal. Let Claude Code handle batch geocoding in any script or CI/CD pipeline.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Geocodio MCP to Claude Code

Create your Vinkius account to connect Geocodio to Claude Code 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 Geocodio with Claude Code

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Geocoding for the Command Line

This server brings Geocodio's API right into your terminal. You can pipe a list of addresses directly to Claude Code and have it use the `batch_geocode_addresses` tool to get back clean, machine-readable JSON with coordinates for each entry. No need to write a full script for simple conversions. For example: `cat addresses.txt | claude code "geocode these addresses with geocodio"`. That's it. The output is structured JSON, so you can immediately pipe it to `jq` for filtering or save it to a file. It fits right into your existing shell workflows.

Automate Data Enrichment in CI/CD

This is more than a command-line toy. You can use it in your deployment or data processing pipelines. A common use is a cron job that pulls new user signups, uses `batch_enriched_geocode` to append census data, and then loads the enriched data into a warehouse. Because Claude Code is headless, it runs anywhere. Put it in a Docker container as part of a nightly data job or in a GitHub Action that validates addresses in a CSV file on every commit. This MCP server provides the tools; Claude Code provides the automation engine.

Reverse Geocoding from any Source

If you're processing server logs or IoT data that contains coordinates, you can turn that data into human-readable addresses. Pipe a stream of lat/lon pairs to Claude Code and instruct it to use the `batch_reverse_pins` tool. You can also pull back specific data points. For instance, get the timezone for a set of server IPs by first getting their coordinates, then using `reverse_enriched_fields` to look up the timezone data. It's a powerful way to add geographic context to any data stream, right from your shell.

Setup guide

Set up Geocodio MCP in Claude Code

Prerequisites

Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)
Active Vinkius subscription with a valid endpoint token

1

Run the add command

Open your terminal and run the command shown on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com. Use --scope user to make it available across all projects.
2

Verify the connection

Start a Claude Code session and type /mcp to list connected servers. You should see geocodio-mcp with a green status indicator.
3

Start using tools

Ask Claude Code something like "Check my latest Geocodio transactions." It will automatically discover and invoke the available Geocodio tools.

Terminal

claude mcp add --transport http geocodio-mcp https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Get your connection token →

Prerequisites

Claude Code CLI installed
Active Vinkius subscription with a valid endpoint token

1

Open the config file

Create or edit .mcp.json in your project root for project-level scope, or ~/.claude.json for user-level scope.
2

Add the Geocodio MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Code

Start a new Claude Code session. Type /mcp to confirm the server is connected. The tools will be automatically available in your conversation.

.mcp.json

{
  "mcpServers": {
    "geocodio-mcp": {
      "type": "url",
      "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 Geocodio. 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 Geocodio 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 Geocodio MCP in Claude Code

You can pipe the file directly. For a text file with one address per line, use `cat addresses.txt | claude code "run batch geocoding with geocodio"`. Claude Code will use the `batch_geocode_addresses` tool and stream the JSON results to standard output.

Yes, that's a primary use case. Set up a script that pipes your data to Claude Code with a prompt like "Add census block data to these addresses using Geocodio's enriched geocoding." It will use `batch_enriched_geocode` to get the job done.

Just run `claude code "list the schema fields for geocodio"`. This executes the `list_schema_fields` tool on the MCP server and prints a clean list of all the data you can request, from school districts to state legislative districts.

Echo the coordinates and pipe them to Claude Code. For example: `echo "40.75, -73.98" | claude code "what's the address for these coordinates?"`. It will use the `reverse_geocode` tool and return the address as structured JSON.

The addresses and coordinates you send are processed by the Geocodio server to fulfill the request. Vinkius handles the transport security, and each MCP server request is ephemeral. No query data is retained beyond what's necessary to serve the immediate API response.

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