
Photon
Keyless OpenStreetMap geocoder for autocomplete-style place search, via Pipeworx gateway
- Pricing
- Freemium
- Platforms
- API, CLI, self-hosted
- Runs
- Locally or Remotely
- Version
- 0.2.1
- Listing updated
- today
Similar MCP servers
About Photon
Photon is a freemium MCP server for maps and travel. It can run locally on your machine or as a hosted remote server.
The README describes Photon as a komoot-hosted OpenStreetMap geocoder built on Elasticsearch, with the strongest results on partial and typo-tolerant queries. This MCP server wraps it so an AI client can run forward lookups from a place name to coordinates and reverse lookups from coordinates to the nearest named place.
The server is a thin bridge to the Pipeworx gateway. The README says the hosted endpoint lists the two Photon tools plus shared gateway meta-tools such as ask_pipeworx, and that the npm package is a local stdio bridge that forwards calls to the same endpoint. Calls work without a key, and a free Pipeworx account raises the daily call cap.
It suits agents that need to resolve partly typed addresses or venue names into coordinates, and developers who want a quick OSM lookup without running their own geocoder. The README notes that heavy use should move to a self-hosted Photon instance, since the public upstream has fair-use limits.
Install
Run in a terminal
claude mcp add --transport http photon https://gateway.pipeworx.io/photon/mcpAdd to Settings → Connectors → Add custom connector
https://gateway.pipeworx.io/photon/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"photon": {
"url": "https://gateway.pipeworx.io/photon/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"photon": {
"type": "http",
"url": "https://gateway.pipeworx.io/photon/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"photon": {
"serverUrl": "https://gateway.pipeworx.io/photon/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"photon": {
"type": "http",
"url": "https://gateway.pipeworx.io/photon/mcp"
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
PIPEWORX_API_KEYOptional Pipeworx API key. Without it calls are anonymous and capped daily; a free key raises the cap.
Tools this server provides (2)
Taken from the project documentation; the running server may differ.
- search
- Forward geocoding from a query string to coordinates.
- reverse
- Reverse geocoding from latitude and longitude to the nearest place.
What it does
- Forward geocoding
- Turns a place name or partial address into coordinates, with optional bias point, language and bounding box filters.
- Reverse geocoding
- Returns the nearest named place for a given latitude and longitude within a chosen radius.
- Autocomplete-friendly search
- Handles partial and typo-tolerant queries better than structured-address geocoders, according to the README.
- No upstream key needed
- The Photon upstream is public and unauthenticated; an optional Pipeworx key only changes the daily call cap.
- Remote or local install
- Available as a streamable HTTP endpoint or as an npm stdio package run with npx.
Good for
- Converting user-typed place names into coordinates inside an agent workflow
- Finding the nearest named place for a set of GPS points
- Powering address autocomplete in a chatbot or form assistant
- Prototyping location features without signing up for a commercial geocoding API
Pricing
Freemium, from $49 a month
Free anonymous and free registered tiers; paid credit and subscription plans for production use.
Prices change. Check pipeworx.io before you buy.
Photon FAQ
Does Photon require an API key?
No. The README says the upstream Photon service is public with no auth. A Pipeworx API key is optional and only raises the daily call cap on the gateway.
How many calls can I make per day?
The Pipeworx pricing page lists 50 tool calls a day anonymously and 200 a day for a free registered account.
Which tools does the server expose?
The README lists two pack tools, search for forward geocoding and reverse for reverse geocoding, plus shared gateway meta-tools on the hosted endpoint.
When should I run my own instance instead?
The README advises running your own Photon instance for high-volume use because the public service has fair-use limits.
Is Photon free?
Photon has a free plan, with paid plans for more usage or features. Paid plans start at $49 a month.
How do I add Photon to Claude Code?
Run this command in your terminal: claude mcp add --transport http photon https://gateway.pipeworx.io/photon/mcp
What are the best alternatives to Photon?
The closest alternatives to Photon are Opencages, Mapbox, OpenStreetMap, Maptiler and Openrouteservice.
Where this comes from
- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.