osm-mcp-puca

Name: osm-mcp-puca
Author: jonnymccullagh

@jonnymccullagh

Repository

About osm-mcp-puca

An MCP server for use with LLM chatbots providing tools related to OpenStreetMap

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "puca": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://192.168.1.40:3300/sse"
      ]
    }
  }
}

Tools

get_address_by_coordinates

get_distance_between_addresses

get_parking

get_post_offices

get_fast_food_places

get_vacant_buildings

Overview

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.

Comments

More Other MCP servers

Unity MCP ✨

justinpbarnett

Unity MCP acts as a bridge between AI assistants and your Unity Editor. Give your LLM tools to manage assets, control scenes, edit scripts, and automate tasks within Unity.

12.2K