The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Gingerguide City Catalog listing page.
Gingerguide is a self-guided audio walking tour app for iPhone and Android. It covers 129 European cities and 2,500+ narrated sights in 28 countries. Each sight has a researched 2 to 3 minute story, read by a lifelike AI voice, in English, Spanish, French, German, Turkish and Chinese. Cities work fully offline.
This repository lets AI assistants and agents use the Gingerguide catalog. It contains:
https://gingerguide.app/mcp.SKILL.md format) for audio tour lookup and one-day city walks.The server is read-only. It needs no API key and no sign-in.
| MCP endpoint | https://gingerguide.app/mcp |
| Transport | Streamable HTTP (stateless, JSON responses) |
| Auth | None |
| MCP Registry name | app.gingerguide/catalog |
| Developer docs | https://gingerguide.app/developers/ |
| OpenAPI (REST) | https://gingerguide.app/api/openapi.json |
| llms.txt | https://gingerguide.app/llms.txt |
| Tool | What it does | Arguments |
|---|---|---|
search_cities | Finds cities by name or country. Returns the number of sights and the web guide URL for each city. | query, country, limit (all optional) |
get_city_guide | Returns one city with all its narrated sights: name, one-line description, category, coordinates and visit time in minutes. | city_id (for example rome) |
list_countries | Lists the covered countries and the number of cities in each. | none |
get_catalog_overview | Returns catalog totals, supported languages and app download links. | none |
All tools are marked readOnlyHint: true.
Open Settings → Connectors → Add custom connector. Set the name to Gingerguide and the URL to https://gingerguide.app/mcp.
For older Claude Desktop builds that only read claude_desktop_config.json, use the bridge config in examples/claude_desktop_config.json.
Add this to ~/.cursor/mcp.json (or .cursor/mcp.json in a project). File: examples/cursor-mcp.json.
Add this to .vscode/mcp.json. File: examples/vscode-mcp.json.
In a workspace or plan that allows custom connectors (developer mode), add a new connector with the URL https://gingerguide.app/mcp and no authentication.
Any MCP client that supports remote Streamable HTTP servers can connect to https://gingerguide.app/mcp. See examples/curl.md for raw JSON-RPC calls.
The skills/ folder has two skills in the SKILL.md format. Claude, Claude Code and other agents that read this format can load them.
| Skill | Use it when a person... |
|---|---|
find-audio-walking-tour | asks for an audio tour, walking tour or self-guided guide for a city |
plan-city-day-with-gingerguide | asks for a one-day itinerary or walking route in a covered city |
The same skills are also served from the website at https://gingerguide.app/.well-known/agent-skills/index.json.
| Endpoint | Returns |
|---|---|
GET https://gingerguide.app/api/cities.json | All cities with id, country, sight count and guide URL |
GET https://gingerguide.app/api/cities/{id}.json | One city with all its sights |
GET https://gingerguide.app/api/openapi.json | The OpenAPI description |
The cli/ folder has the source of the official command-line client. It is on npm as gingerguide.
The files in this repository (docs, configs, skills) are under the MIT License. The catalog data that the server and the API return belongs to Gingerguide. See the terms.
Questions or problems: open an issue, or write to ozalpege243@gmail.com.