Skip to main content
MCP server CX Codex

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

Install into Claude Code · Platform CLI: remote server All methods and platforms ↓
claude mcp add --transport http macrostrat-mcp https://macrostrat-mcp--blake365.run.tools
Open on GitHub

What 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-units for 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.tools

Step 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.

Similar MCP servers

All MCP servers for Science and research →

Project sponsors

Companies that keep this analytics open