macrostrat-mcp — Claude Code MCP server: geologic data by coordinates
Exposes the Macrostrat API to AI assistants: geologic units, columns, minerals, timescales, and map tiles. No API key required.
MIT 1,360 installs ★ 8 updated 2026-08-09
claude mcp add --transport http macrostrat-mcp https://macrostrat-mcp--blake365.run.toolsWhat macrostrat-mcp does
The server wraps the public Macrostrat API into MCP tools the assistant calls on its own: find-units, find-columns, defs, mineral-info, timescale, plus two tools for map tiles. Give it latitude and longitude, and it returns what rock formations sit under that point, how old they are, and what they are made of.
It runs over STDIO and starts with a single command: npx -y macrostrat-mcp. Node.js 20 or newer is required; the server is fetched on first run. In Claude Code, wire it up with claude mcp add macrostrat -- npx -y macrostrat-mcp.
The README is honest about map tiles: an LLM can read them, but the utility is questionable. Text queries get structured JSON back, and the assistant turns that into a readable answer.
What it helps with
- find geologic units by coordinates
- get rock age and composition at a point
- look up mineral information
- fetch a geologic map tile for visualization
- resolve a term definition from the Macrostrat database
Example prompts for the agent
- What is the geologic history of 36.1627, -86.7816?
- Call
find-unitsfor latitude 55.75 and longitude 37.61, then explain what lies there. - What mineral is chalcopyrite? Check
mineral-info.
How to install macrostrat-mcp
Platform CLI: remote server
claude mcp add --transport http macrostrat-mcp https://macrostrat-mcp--blake365.run.toolsPlatform CLI: remote server
codex mcp add macrostrat-mcp --url https://macrostrat-mcp--blake365.run.toolsConfig file
{
"mcpServers": {
"macrostrat-mcp": {
"url": "https://macrostrat-mcp--blake365.run.tools"
}
}
}Config file
{
"servers": {
"macrostrat-mcp": {
"type": "http",
"url": "https://macrostrat-mcp--blake365.run.tools"
}
}
}Platform CLI: remote server
gemini mcp add -t http macrostrat-mcp https://macrostrat-mcp--blake365.run.toolsStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about macrostrat-mcp
How do I install macrostrat-mcp in Claude Code?
Run claude mcp add --transport http macrostrat-mcp https://macrostrat-mcp--blake365.run.tools. The server is then available in your session.
What does macrostrat-mcp do?
It connects an AI assistant to the Macrostrat API, an open database of geologic data. The assistant gets tools for units, columns, minerals, definitions, and map tiles by coordinates.
Do I need an API key?
No, the Macrostrat API is free and public. You do need Node.js 20 or newer if you run the server locally via npx.