Connect

8 clients · secrets stay placeholders

JSON (mcpServers)Claude CodeCodexOpenCodeCursorVS CodeGemini CLIGoose

{
  "mcpServers": {
    "catalog": {
      "type": "http",
      "url": "https://gingerguide.app/mcp",
      "headers": {
        "Authorization": "Bearer ${CATALOG_TOKEN}"
      }
    }
  }
}

claude mcp add --transport http catalog https://gingerguide.app/mcp --header "Authorization: Bearer ${CATALOG_TOKEN}"

[mcp_servers.catalog]
url = "https://gingerguide.app/mcp"
bearer_token_env_var = "CATALOG_TOKEN"

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "catalog": {
      "type": "remote",
      "url": "https://gingerguide.app/mcp",
      "enabled": true,
      "headers": {
        "Authorization": "Bearer {env:CATALOG_TOKEN}"
      }
    }
  }
}

{
  "mcpServers": {
    "catalog": {
      "type": "http",
      "url": "https://gingerguide.app/mcp",
      "headers": {
        "Authorization": "Bearer ${CATALOG_TOKEN}"
      }
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=catalog&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vZ2luZ2VyZ3VpZGUuYXBwL21jcCIsImhlYWRlcnMiOnsiQXV0aG9yaXphdGlvbiI6IkJlYXJlciAke0NBVEFMT0dfVE9LRU59In19"
}

{
  "servers": {
    "catalog": {
      "type": "http",
      "url": "https://gingerguide.app/mcp",
      "headers": {
        "Authorization": "Bearer ${CATALOG_TOKEN}"
      }
    }
  }
}

{
  "mcpServers": {
    "catalog": {
      "httpUrl": "https://gingerguide.app/mcp",
      "headers": {
        "Authorization": "Bearer ${CATALOG_TOKEN}"
      }
    }
  }
}

extensions:
  "catalog":
    enabled: true
    name: "catalog"
    type: streamable_http
    uri: "https://gingerguide.app/mcp"
    headers:
      "Authorization": "Bearer ${CATALOG_TOKEN}"
    timeout: 300

Placeholders to fill from your own secret store: ${CATALOG_TOKEN}. The registry never accepts secret values.

Quality 69 / 100needs work

protocol75 · weight 25

warn
protocol.modernnewest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
n/a
protocol.statelessonly applies to 2026-07-28 servers
pass
protocol.transportstreamable HTTP
n/a
protocol.list_ttlonly applies to 2026-07-28 servers

authorizationn/a · weight 15

n/a
auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
n/a
auth.secret_in_urlno templated URL

tool hygiene86 · weight 30

pass
tools.descriptionsevery tool has a description
pass
tools.description_lengthdescriptions are concise
pass
tools.schemasevery tool has an object input schema
pass
tools.annotations4 of 4 tools declare readOnlyHint or destructiveHint
fail
tools.directory_hintsno tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: search_cities (destructiveHint, idempotentHint); get_city_guide (destructiveHint, idempotentHint); list_countries (destructiveHint, idempotentHint); …
pass
tools.token_costabout 270 tokens to load every tool
pass
tools.api_dumptools are not a one-to-one API dump

stability25 · weight 15

warn
stability.changes28 tool changes in 30 days
fail
stability.rug_pull8 tools kept their name but changed most of their description in 30 days; review before trusting them

dependenciesn/a · weight 15

n/a
deps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI package

4 tools, about 270 tokens to load them all · tool set 346e2ef2e70d · tools last changed 2026-10-13 · checked 2026-10-19 16:53 UTC

Tool changes

2026-10-13plan_trip_itineraryremoved
Multi-day plan for one city: each day covers one or two walkable areas (with a public-transport hop between them), ordered as walking routes, plus sights that did not fit. Example: "three days in Vienna for art and music lovers".
2026-10-13recommend_attractionsremoved
Personalized picks in one city for a traveler's interests, favourite periods, preference for headline sights or hidden gems, indoor or outdoor, and time available. Each pick says why it was chosen. Use plan_walking_tour instead when the traveler wants an ordered route.
2026-10-13get_attractionremoved
Full details for one sight: long description, a notable fact, photo, coordinates, map links, visit minutes, and the nearest other sights with walking minutes. Use the attraction id from search_attractions or get_city_guide.
2026-10-13find_day_tripsremoved
Day trips from a base city to other covered cities and towns nearby, e.g. "day trips from Florence" or "a day trip from Munich for castles". Ranks destinations by distance, fit with the traveler's interests and periods, and fame, and lists what to see there in one day. Distances are straight-line; travel times are not included because trains, mountains and ferries change them a lot. Only covered cities are listed.
2026-10-13plan_walking_tourremoved
Build an ordered self-guided walking route in one city that fits a time budget, e.g. "a two-hour historical walk in Rome". Picks sights by interests, periods and style, orders them to keep walking short, and returns each stop with walking minutes, suggested time on site, clock times and a Google Maps walking link.
2026-10-13find_nearby_attractionsremoved
Sights closest to a latitude/longitude (for example the traveler's hotel or current position), sorted by walking time, optionally filtered by interests or category. If nothing is within the radius, returns the nearest covered city.
2026-10-13get_visit_inforemoved
Practical facts for visiting one city: best months and crowd seasons, climate, annual events that change a visit, how to get from the airport, main station or cruise port to the centre (typical minutes), city passes, which sights are free, which need booking ahead, weekly closing days and dress codes. Every fact has a source and a check date. No prices or opening hours. Researched for some cities only; the answer says when a city is not covered yet.
2026-10-13search_attractionsremoved
Search individual sights across all cities or within one city, by free text, category, interests, historical period, indoor/outdoor, visit length, free entry or distance from a point. Example: five Byzantine sights in Istanbul, Gothic churches in Spain, or free things to do in Rome. Returns name, description, coordinates, visit minutes and page URL for each match.
2026-10-13compare_citiesremoved
Compare two to four covered cities side by side, e.g. "Porto or Lisbon?" or "Seville vs Granada for Moorish history". Gives each city's sight count, days needed, strongest interests and historical periods, share of indoor sights and headline sights, says which city is stronger for each interest or period, and the distance between them. Based on the sight catalog only: not prices, weather, nightlife or beaches.
2026-10-13recommend_destinationsremoved
Suggest covered European cities that fit a traveler's interests or favourite historical periods, e.g. "best cities for Byzantine history" or "a city break for art and food in Spain". Ranks cities by how many of their sights match, and says why.

Showing the latest 10. Full history: list_changes · trend: quality JSON.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 99 / 100

provenance100

liveness98

freshness100

hygiene100

+repository +namespace-matches-repo +dns-namespace +website +reachable +uptime-95% +updated-7d-ago

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Endpoints

remote	auth	reachable	uptime 30d	p50	protocol	last ok
`https://gingerguide.app/mcp` streamable-http	none	yes	95%	356 ms	2025-11-25	2026-10-19

Tools (4)

`get_catalog_overview`read-only	Totals for the whole catalog (cities, sights, countries), the supported languages, and the app download links.
`get_city_guide`read-only	Get one city with all of its narrated sights (name, one-line description, category, coordinates, and visit minutes).
`list_countries`read-only	List covered countries and how many cities each one has.
`search_cities`read-only	Find Gingerguide cities by name or country. Returns matching cities with their sight count and web guide URL. Omit query to list all.

Schemas: list_tools.

Similar MCP servers

Official server.json

{
  "name": "app.gingerguide/catalog",
  "title": "Gingerguide: European city walking tours",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "remotes": [
    {
      "url": "https://gingerguide.app/mcp",
      "type": "streamable-http",
      "headers": [
        {
          "name": "Authorization",
          "isSecret": true,
          "description": "Optional. 'Bearer ggk_...' free key from https://gingerguide.app/developers/#api-key raises the daily limit. The server works without it."
        }
      ]
    }
  ],
  "version": "2.0.0",
  "repository": {
    "url": "https://github.com/gingerguide/gingerguide",
    "source": "github"
  },
  "websiteUrl": "https://gingerguide.app/developers/",
  "description": "Read-only European city sights: search, nearby, walking routes and itineraries in 6 languages."
}