How to Use the Pelias Geocoder MCP in VS Code Copilot

Q: How do we configure Pelias Geocoder for the whole team in VS Code Copilot?

Create a .vscode/mcp.json file in your repository root. Define the pelias-geocoder-mcp server configuration so that every developer on the project automatically loads the tool.

Q: Can VS Code Copilot run reverse geocoding queries using Pelias Geocoder?

Yes, Copilot can trigger reversegeocode to convert coordinates into addresses. You can also specify search radiuses using reversedistancelimit.

Q: How does Pelias Geocoder help with writing location autocompletes in VS Code Copilot?

Copilot uses searchautocomplete to fetch real-time suggestions. This helps you write exact input handlers by showing you the precise JSON response format of the API.

Q: How do I prioritize results close to a specific user location?

Ask Copilot to use searchfocusbias with the user's coordinates. This tells the search engine to prioritize matches that are physically closer to that point.

Share precise geocoding tools across your entire engineering team using this MCP Server directly inside VS Code Copilot.

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 VS Code Copilot

Create your Vinkius account to connect Pelias Geocoder to VS Code Copilot — 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 VS Code Copilot

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Team-wide spatial search inside VS Code Copilot

Commit your geocoding configurations directly to your repository. By placing the server settings in `.vscode/mcp.json`, every developer on your team gets access to `search_geocode` and `structured_geocoding` through VS Code Copilot. This keeps everyone working with the exact same spatial reference systems. No more mismatched API keys or custom local testing scripts. Your team can query address databases and verify spatial formats collectively inside the chat panel.

Filter geographic data by country and layer limits

When writing complex spatial queries, your team needs accurate filtering. Copilot uses `search_country_filter` to restrict searches to specific ISO 3166 boundaries. It can also call `search_layer_filter` to isolate specific GIS layers, ensuring your code targets only the exact categories you need. This MCP Server provides a direct link between your code editor and your spatial database. It makes validating geographic structures much faster during development.

Resolve spatial coordinates with reverse lookup tools

Map coordinate traces back to physical locations without leaving VS Code. Your agent calls `reverse_geocode` to parse raw GPS coordinates into structured street names. It can also use `lookup_place_id` to get detailed property data for specific persistent location IDs. This toolset simplifies coordinate verification during backend debugging. You get instant access to the underlying geographic properties directly in your workspace.

Setup guide

Set up Pelias Geocoder MCP in VS Code Copilot

Prerequisites

VS Code 1.99 or later with GitHub Copilot extension
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and run "MCP: Add Server". Select HTTP (Streamable) as the server type. VS Code will create .vscode/mcp.json in your workspace.
2

Add the Pelias Geocoder MCP

Paste the JSON snippet shown on the right into your .vscode/mcp.json. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Switch to Agent mode

Open Copilot Chat (Cmd+Shift+I / Ctrl+Shift+I) and switch to Agent mode using the dropdown. MCP tools are only available in Agent mode — they do not appear in Edit or Ask modes.
4

Verify the connection

In the Copilot Chat input, type # to list available tools. You should see the Pelias Geocoder tools listed. Try asking: "List my recent Pelias Geocoder transactions" and Copilot will invoke them automatically.

.vscode/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 VS Code Copilot

Create a `.vscode/mcp.json` file in your repository root. Define the `pelias-geocoder-mcp` server configuration so that every developer on the project automatically loads the tool.

Yes, Copilot can trigger `reverse_geocode` to convert coordinates into addresses. You can also specify search radiuses using `reverse_distance_limit`.

Copilot uses `search_autocomplete` to fetch real-time suggestions. This helps you write exact input handlers by showing you the precise JSON response format of the API.

Ask Copilot to use `search_focus_bias` with the user's coordinates. This tells the search engine to prioritize matches that are physically closer to that point.

They go directly to your configured Pelias endpoint over encrypted TLS connections. Vinkius runs this server in a zero-trust sandbox, so no raw address strings or coordinate pairs are logged or saved.

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