How to Use the Pelias Geocoder MCP in Claude

Q: How do I configure Pelias Geocoder inside the Claude Desktop app?

Open your claudedesktopconfig.json and add pelias-geocoder-mcp under the mcpServers key. Specify the executable path and your Pelias API credentials in the args array, then restart the app.

Q: Can Pelias Geocoder handle real-time keystroke suggestions in Claude Desktop?

Yes, the searchautocomplete tool is built specifically for that. When you type partial addresses in Claude Desktop, your agent uses this tool to suggest matching places instantly.

Q: How do I restrict searches to a specific city?

Tell your agent to apply searchfocusbias with a central coordinate point. It forces the search engine to prioritize local results near that spot.

Get real-world coordinates and clean addresses using this MCP Server directly in your Claude Desktop chat.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect Pelias Geocoder MCP to Claude Desktop

Create your Vinkius account to connect Pelias Geocoder to Claude Desktop — we handle the hosting, security, and runtime updates so you don't have to. No server setup required.

GDPR Included with Plan

Setup Pelias Geocoder with Claude Desktop

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Real-time address lookups inside Claude Desktop

Stop copying addresses out of your Claude Desktop chat to search them on a separate map. When you feed your agent raw location text, it fires up `search_geocode` to return precise latitude and longitude coordinates. If you have clean, segmented data fields like region or postal code, the `structured_geocoding` tool ensures you bypass parsing guesswork entirely. Your local desktop app runs these queries as background subprocesses, pulling exact GIS coordinates into your prompt context. You can immediately use the resulting coordinates to map out branch locations or clean up customer shipping tables on the fly.

Map visual boundaries directly from your chat window

You can limit what Claude Desktop sees by setting geographic limits. Tell your agent to search for points of interest only within a specific map view, and it uses `search_bounding_box` to restrict the API requests to those exact coordinate bounds. If you need political boundaries, the `search_country_filter` tool limits matching to ISO 3166 country rules. Running this MCP Server locally via your config file means your coordinate limits stay fast and direct. Your agent filters out global noise and focuses only on the neighborhoods or countries you actually care about.

Reverse geocode coordinates using local tools

Drop a set of raw coordinates or a GPS trace into Claude Desktop to find out what is actually there. Your agent calls `reverse_geocode` to convert those numbers back into real OpenStreetMap address pins. You can tighten the search radius by letting the agent trigger `reverse_distance_limit` so it does not return matches miles away. This local MCP setup handles the heavy spatial matching directly on your machine. You get the exact street names, postal codes, and neighborhood names without manual API testing.

Setup guide

Set up Pelias Geocoder 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 Pelias Geocoder 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 Pelias Geocoder 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 pelias-geocoder-mcp.

json

{
  "mcpServers": {
    "pelias-geocoder-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 Pelias Geocoder. 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 Pelias Geocoder 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 Pelias Geocoder MCP in Claude Desktop

Open your `claude_desktop_config.json` and add `pelias-geocoder-mcp` under the `mcpServers` key. Specify the executable path and your Pelias API credentials in the args array, then restart the app.

Yes, the `search_autocomplete` tool is built specifically for that. When you type partial addresses in Claude Desktop, your agent uses this tool to suggest matching places instantly.

It connects via a local stdio transport layer. This means Claude Desktop spawns the server as a direct subprocess, eliminating web latency when fetching spatial data.

Tell your agent to apply `search_focus_bias` with a central coordinate point. It forces the search engine to prioritize local results near that spot.

Your raw coordinates and address strings only go to your designated Pelias API endpoint. Because Vinkius runs the server in an isolated sandbox, no location logs are leaked or stored externally.

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