How to Use the Pelias Geocoder MCP in Cursor

Q: How do I add the Pelias Geocoder MCP Server to my Cursor editor?

Add the server configuration to your global /.cursor/mcp.json file. Provide your Pelias endpoint URL and API keys, then toggle the server on in your Cursor settings.

Q: Can I use Pelias Geocoder to debug spatial queries inside Cursor Agent mode?

Yes, the agent can run searchgeocode to check coordinates directly. It helps you debug spatial boundaries without leaving your code editor.

Q: How does Pelias Geocoder handle bounding box coordinates in Cursor?

The agent invokes searchboundingbox to pass specific coordinate rectangles. It allows you to write and test code that limits map searches to precise local bounds.

Q: Can I filter search results by specific GIS layers in Cursor?

Yes, your agent can call searchlayerfilter to target specific datasets. This helps you narrow searches down to venues, addresses, or neighborhoods.

Generate code with live, accurate coordinate and address data using the Pelias Geocoder MCP Server in Cursor Agent mode.

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 Cursor

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Inject live address data into your Cursor codebases

Stop using mock coordinates when building location-aware software in Cursor. When you write tests or build database seeders, the Cursor agent uses `structured_geocoding` to pull real address structures directly into your files. It matches inputs to real GIS datasets, ensuring your code works with live production-grade address formats. You get real street names and valid ZIP codes written directly into your active editor. This means your mock data matches real-world spatial layouts from the start.

Build interactive autocomplete UI with Cursor and MCP

Building a search bar in your app is easier when your editor understands the API. Use the `search_autocomplete` tool in Cursor to test partial address inputs and see exactly what JSON payload Pelias returns on every keypress constraint. This MCP Server integration lets you skip reading documentation tables. Your agent runs live queries to verify the exact structure of Pelias search suggestions as you write the UI code.

Resolve database coordinate points inside your editor

If you are working with raw GPS coordinates in your database, let Cursor translate them. Your agent runs `reverse_geocode` to map those coordinate points to physical OpenStreetMap pins. It can also apply `reverse_distance_limit` to check if a point sits within a specific circle radius. You don't need to write custom Python scripts just to inspect your spatial database. The agent reads the coordinates from your workspace files and outputs clean addresses.

Setup guide

Set up Pelias Geocoder MCP in Cursor

Prerequisites

Cursor installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP Settings

Go to Cursor Settings → MCP or open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and search for "MCP: Add Server".
2

Add the Pelias Geocoder MCP

Cursor will create or open .cursor/mcp.json in your project root. Paste the JSON snippet on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Enable Agent mode

Open Composer (Cmd+I / Ctrl+I) and switch to Agent mode using the dropdown at the top. MCP tools are only available in Agent mode.
4

Verify the connection

Ask Cursor something like "List my recent Pelias Geocoder transactions." If the MCP tools are loaded correctly, Cursor will call the Pelias Geocoder tools automatically. You can also check Settings → MCP for a green status indicator.

.cursor/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 Cursor

Add the server configuration to your global `~/.cursor/mcp.json` file. Provide your Pelias endpoint URL and API keys, then toggle the server on in your Cursor settings.

Yes, the agent can run `search_geocode` to check coordinates directly. It helps you debug spatial boundaries without leaving your code editor.

The agent invokes `search_bounding_box` to pass specific coordinate rectangles. It allows you to write and test code that limits map searches to precise local bounds.

Yes, your agent can call `search_layer_filter` to target specific datasets. This helps you narrow searches down to venues, addresses, or neighborhoods.

Your search inputs and physical addresses are sent securely via HTTPS directly to your Pelias instance. Cursor does not store these location queries, and the Vinkius sandbox guarantees ephemeral execution.

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