# Photon

> Photon is a freemium MCP server for maps and travel. Keyless OpenStreetMap geocoder for autocomplete-style place search, via Pipeworx gateway. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $49 a month
- **Platforms:** API, CLI, self-hosted
- **Website:** https://pipeworx.io/packs/photon
- **Repository:** https://github.com/pipeworx-io/mcp-photon
- **MCP Registry name:** io.github.pipeworx-io/photon
- **Categories:** [maps and travel](https://ai-powered.com/categories/maps-and-travel)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http photon https://gateway.pipeworx.io/photon/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://gateway.pipeworx.io/photon/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "photon": {
      "url": "https://gateway.pipeworx.io/photon/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "photon": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/photon/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "photon": {
      "serverUrl": "https://gateway.pipeworx.io/photon/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "photon": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/photon/mcp"
    }
  }
}
```

## Tools

- `search`: Forward geocoding from a query string to coordinates.
- `reverse`: Reverse geocoding from latitude and longitude to the nearest place.

## 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.

## Alternatives

- [Opencages](https://ai-powered.com/mcp/opencages): Opencages is a freemium MCP server for maps and travel.
- [Mapbox](https://ai-powered.com/mcp/mapbox): Mapbox is a freemium MCP server for maps and travel.
- [OpenStreetMap](https://ai-powered.com/mcp/openstreetmap): OpenStreetMap is an open-source MCP server for maps and travel.
- [Maptiler](https://ai-powered.com/mcp/maptiler): Maptiler is a freemium MCP server for maps and travel.
- [Openrouteservice](https://ai-powered.com/mcp/openrouteservice): Openrouteservice is a freemium MCP server for maps and travel.
- [What3words](https://ai-powered.com/mcp/what3words): What3words is a freemium MCP server for maps and travel.
- [Coordinates](https://ai-powered.com/mcp/coordinates): Coordinates is a freemium MCP server for maps and travel.
- [Opentopography](https://ai-powered.com/mcp/opentopography): Opentopography is a freemium MCP server for maps and travel.

---
Source: https://ai-powered.com/mcp/photon
