Running Cat Geo

npx add-mcp 'https://geo.runningcat.dev/mcp'

Connect

The server is at https://geo.runningcat.dev/mcp and speaks Streamable HTTP. It takes the same key as the API.

Claude Code

claude mcp add --transport http running-cat-geo https://geo.runningcat.dev/mcp \
  --header "Authorization: Bearer YOUR_KEY"

Cursor

In .cursor/mcp.json in your project, or ~/.cursor/mcp.json for every project:

{
  "mcpServers": {
    "running-cat-geo": {
      "url": "https://geo.runningcat.dev/mcp",
      "headers": { "Authorization": "Bearer ${env:RUNNING_CAT_KEY}" }
    }
  }
}

Other clients

Any client that connects to remote MCP servers over HTTP works with the address and an Authorization: Bearer YOUR_KEY or x-api-key header. A client that takes only an address can use https://geo.runningcat.dev/mcp?key=YOUR_KEY; keep that address private, since it carries the key.

Tools

point_report

Everything about a place: name and areas, time zone, height, weather, air quality, nearby air stations and river gauges

area_report

Weather, air quality, heights, air stations and river gauges over a box, on a grid

plan_route

A bike, gravel, hiking or car route through waypoints, with its profile, weather at arrival times, time zones and what it passes

plan_loop

A round trip of a given length from a starting point, with its climb and road surfaces, and optionally the same report

route_report

The same report for a route you already have as GeoJSON, including the road surface along it

stops_along_route

Water, food, shops, toilets, bike shops and fuel along a route, with kilometres and the long stretches without any

overpass_query

An Overpass QL query on OpenStreetMap data (what is supported)

weather_forecast

Hourly forecast for up to 14 days

air_quality

Air quality and pollen forecast, and what stations nearby measure now

river_gauges

River levels near a point or in a box, or one gauge's history

elevation

Heights of up to 1,000 points

where_is

Country, region, town and time zone of a point

outdoor_layers

Marked trails, protected areas, ski pistes, lifts and boundaries in a box

Long answers, such as two weeks of hourly weather, are cut to fit the assistant's context, and the answer says what was cut. For the full data, call the API directly.

Things to ask

• "Plan a gravel ride from Munich to Salzburg for Saturday at 20 km/h. Where does the rain start, and where can I refill water?"
• "Is the Rhine at Cologne higher than yesterday, and by how much?"
• "Is the air in Prague better or worse than the forecast said? Compare the stations with the forecast."
• "Find bakeries inside the boundary of Vienna that open before 7."

How calls count

The server adds no charge of its own. A tool call counts as the API requests it makes: point_report and air_quality one each, an area or route report one per part, a route once per started 100 km (50 km for MTB). Plan limits are on the pricing section; the free plan gives 500 requests a day.