stadiamaps/stadiamaps-mcp-server-ts

This is a Model Context Protocol (MCP) server
that provides AI assistants with access to Stadia Maps APIs for location services, geocoding, routing, and mapping capabilities.
Capabilities
- Time information anywhere on earth
- Current time
- Time zone info (ID, UTC offset, and whether a special offset like daylight saving/summer time is in effect)
- Geocoding
- Address lookup
- Place search (POIs like restaurants, cafes, etc.)
- Static map image generation (including markers and route overlays)
- Routing & travel time
- Isochrones (reachable range; both time and distance contours)
Use cases
Here are just a few of the ways you can prompt an LLM
to make use of the tools:
- "What time is it in Tokyo?"
- "Make me a map showing the walking route from Depoo Turg to the Põhjala Tap Room."
- "Is the Põhjala Tap Room open right now? Use Stadia Maps to get this information."
- "Geocode the addresses in the attached spreadsheet."
Quickstart
Building
We'll use bun for all of our instructions,
but you can use npm too.
1. Run bun install to fetch the dependencies.
2. Then, execute the build script: bun run build.
The built code should be in the build directory now.
Configuration
This MCP server requires a Stadia Maps API key.
Follow the directions here to get your free key.
Then, set the API_KEY environment variable when running the server.
Integration Examples
API key in hand, here are a few ways you can use the MCP server.
Claude Desktop
See Claude Desktop Setup for detailed instructions
on configuring this MCP server with Claude Desktop.
Claude Desktop is a great tool for testing out workflows.
Warp
See Warp Setup for detailed instructions
on setting up Warp with this MCP server.
Warp is a powerful agentic environment that uses LLMs to do things on your behalf.
Whereas you would need to upload a file to Claude,
Warp can directly access files,
write code, and execute programs on your computer.
Paired with the Stadia Maps MCP, it's a powerful tool for tasks like bulk geocoding,
spatially filtering datasets, and more.
Programmatic Integration with Anthropic SDK
For developers who want to integrate the MCP server programmatically into their TypeScript applications,
we have an Anthropic SDK Integration Example.
This example demonstrates how to:
- Connect to the MCP server from your code
- Integrate with Claude's API for natural language queries
- Enhance Claude with spatial intelligence using the Stadia Maps APIs via an MCP server
Tips and Tricks
LLMs are far from perfect,
and sometimes you need to put some thought into crafting prompts
to get good results.
When possible, be specific about which tool(s) to use
Sometimes the model needs a nudge to use the right tool.
For example, if you ask for opening hours,
many models will try to search the web.
This information isn't always easily available for the model to find online.
For example, watch what a model does here:
You can nudge the model to use the tools in this MCP like so:
Get creative
LLMs are capable of a lot, but they can't always do everything.