How to Use the Geoapify MCP in Claude Code
Claude Code runs headless Geoapify operations in your terminal for automated routing and geocoding pipelines.
Works with every AI agent you already use
…and any MCP-compatible client
Connect Geoapify MCP to Claude Code
Create your Vinkius account to connect Geoapify 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.
Headless geocoding pipelines
Pipe your raw address files directly into `geocode_search` using Claude Code. It processes your input in the terminal, returning structured coordinates that you can immediately feed into downstream shell scripts or CI/CD jobs. It removes the need for manual data entry. You define the input format, and the agent handles the API interaction, outputting the clean JSON you need for production deployment.
Automated route matrix generation
Use Claude Code to calculate distances across thousands of points with `calculate_route_matrix`. The agent runs the job, tracks the progress, and formats the distance data for your reporting tools. It thrives in non-interactive environments. Run it as part of a nightly cron job to update your logistics dashboard without needing any GUI intervention.
Batch processing with Geoapify
Manage massive geocoding tasks by having Claude Code trigger `create_batch_job`. It initiates the request, waits for completion, and uses `get_batch_job` to pull the final results into your local storage. You gain full control over your data throughput. The agent handles the asynchronous state management, allowing you to focus on the data analysis instead of the API polling logic.
Set up Geoapify 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 userto make it available across all projects. - 2
Verify the connection
Start a Claude Code session and type
/mcpto list connected servers. You should seegeoapify-mcpwith a green status indicator. - 3
Start using tools
Ask Claude Code something like "Check my latest Geoapify transactions." It will automatically discover and invoke the available Geoapify tools.
claude mcp add --transport http geoapify-mcp https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp Why Choose Vinkius
Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.
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 Geoapify MCP in Claude Code
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
Start using the Geoapify MCP today
We host it, we monitor it, we maintain it. You just paste one token.