How to Use the Geocode.xyz MCP in Claude

Turn raw addresses into coordinates or extract locations from text files directly inside Claude Desktop.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Geocode.xyz MCP to Claude Desktop

Create your Vinkius account to connect Geocode.xyz to Claude Desktop 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 Geocode.xyz with Claude Desktop

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Parse text files to extract coordinates in Claude Desktop

The `geoparse` tool extracts real-world location names from raw text files stored on your local machine. Claude Desktop accesses these files via stdio, feeds unstructured notes to the parser, and maps every coordinate instantly. You don't have to copy-paste messy logs or shipping manifests into a browser anymore. Your local agent reads the document, runs the extraction, and gives you clean geographic data right in the chat window.

Convert text addresses to physical coordinates

The `forward_geocode` tool translates human-readable addresses into precise latitude and longitude values inside your Claude Desktop chat. It takes the guesswork out of mapping by giving your agent direct access to Geocode.xyz's global database. When you ask Claude to plot a list of customer locations, the app runs the coordinates behind the scenes. You get clean JSON outputs ready for your mapping tools without writing a single line of Python.

Correct sloppy addresses using this MCP Server

The `autocomplete` tool suggests correct street names and postal codes as you interact with your desktop agent. It prevents typos from breaking your database records by validating partial inputs in real-time. If you're building a delivery list, this MCP Server helps Claude Desktop suggest the correct city or zip code before you save the data. It saves time and stops bad data from entering your local databases.

Setup guide

Set up Geocode.xyz MCP in Claude Web or Desktop

1

Open Claude Settings

Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.
2

Add Custom Connector

Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL: https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. For OAuth-protected servers, expand Advanced settings to add credentials.
3

Start a conversation

Open a new chat. The Geocode.xyz MCP tools are available immediately — no restart needed.

Endpoint URL

https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

No configuration file needed — paste the URL directly in the Claude web interface.

Available on Free (1 connector), Pro, Max, Team, and Enterprise plans.

Prerequisites

Claude Desktop installed (macOS or Windows)
Active Vinkius subscription with a valid endpoint token

1

Open Claude Desktop Settings

Click the menu icon at the top-left corner, go to Settings → Developer → Edit Config. This opens claude_desktop_config.json in your default text editor.
2

Paste the Geocode.xyz MCP configuration

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

Restart Claude Desktop

Close and reopen the application. Claude needs a full restart to load new MCPs — refreshing a conversation is not enough.
4

Verify the connection

Open a new conversation. Click the 🔌 icon at the bottom of the message input. You should see tools listed under geocodexyz-mcp.

json

{
  "mcpServers": {
    "geocodexyz-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 Geocode.xyz. 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 Geocode.xyz 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 Geocode.xyz MCP in Claude Desktop

Open your desktop config file and add the Geocode.xyz server under your MCP configuration. Once you save and restart the desktop app, you will see the hammer icon showing the new MCP tools are active.

Yes, the geoparse tool is built specifically for this. When you paste unstructured emails or logs into Claude Desktop, the server identifies and extracts the exact coordinates of any mentioned locations.

Absolutely, the IP geolocation tool lets your desktop agent resolve IP addresses to physical locations. You can paste a list of server logs and get instant geographic profiles in your chat.

Check your config file for syntax errors or missing environment variables. If Claude Desktop cannot spawn the subprocess, check the logs to ensure the node path or executable is correct.

This MCP server processes raw addresses and IP lookups by passing them directly to the Geocode.xyz endpoint. Vinkius runs the server in an isolated sandbox, meaning your location queries are never cached or stored locally after the request completes.

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