osm-mcp-puca

What is osm-mcp-puca?

osm-mcp-puca is an MCP server designed for use with LLM chatbots, providing tools related to OpenStreetMap. It is for developers and users who want to query OpenStreetMap data via natural language interfaces.

How to use osm-mcp-puca?

Integrate the server with any MCP‑compatible client. For Docker, add an OpenAI API Key to .env and run docker compose up -d, then visit http://your.ip.address:3301. For Claude, edit claude_desktop_config.json to include the server’s SSE endpoint. For Python, see the example client.py using Pydantic AI.

Key features of osm-mcp-puca

• Tools to query OpenStreetMap data via MCP
• Get coordinates from addresses and vice versa
• Find amenities: defibrillators, parking, toilets, post offices, cafes, fast food
• Calculate distances between addresses or coordinates
• Fetch Irish street names and vacant buildings
• Custom Overpass API query results

Use cases of osm-mcp-puca

• Ask a chatbot for the nearest defibrillator or cafe using natural language
• Get driving or walking distance between two addresses
• Look up the postal address for a set of GPS coordinates
• Find vacant buildings in a specific area
• Explore Irish street names through conversational queries

FAQ from osm-mcp-puca

What data sources does osm-mcp-puca use?

It uses the freely available APIs from OSRM (routing), Overpass (querying), and Nominatim (geocoding), all backed by OpenStreetMap volunteer-contributed data.

Does osm-mcp-puca require an API key?

Yes, when running via Docker you must add your own OpenAI API Key in the .env file. No key is mentioned for the other integrations.

What tools are included?

The server exposes 13 tools: get_coordinates_for_address, get_address_by_coordinates, get_defibrillators, get_distance_between_addresses, get_distance_between_coords, get_parking, get_toilets, get_post_offices, get_cafes, get_fast_food_places, get_irish_street_names, get_vacant_buildings, and get_overpass_results.

Can I use osm-mcp-puca with Claude Desktop?

Yes, by adding the server to Claude’s MCP configuration with the command npx mcp-remote http://<your-ip>:3300/sse.

Is there a web interface?

Yes, the included Púca UI runs on port 3301 via Docker Compose, allowing direct query entry.