# macrostrat-mcp

Exposes the Macrostrat API to AI assistants: geologic units, columns, minerals, timescales, and map tiles. No API key required.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 1360 installs · ★ 8 repo stars
- Author: blake365
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/blake365/macrostrat-mcp
- Updated: 2026-08-09
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/macrostrat-mcp

## What it 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.

## Requirements
- Remote server: `https://macrostrat-mcp--blake365.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http macrostrat-mcp https://macrostrat-mcp--blake365.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add macrostrat-mcp --url https://macrostrat-mcp--blake365.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "macrostrat-mcp": {
            "url": "https://macrostrat-mcp--blake365.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "macrostrat-mcp": {
            "type": "http",
            "url": "https://macrostrat-mcp--blake365.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http macrostrat-mcp https://macrostrat-mcp--blake365.run.tools
```

## When to use it
- 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
- 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`.

## Similar
- [datagokr — 공공데이터포털 검색을 더 쉽게 (find data.go.kr datasets easily)](https://affpapa.org/en/nevibecode/mcp/datagokr-find-datagokr-datasets-easily.md) — MCP server · ★ 1 repo stars
- [claim-verify](https://affpapa.org/en/nevibecode/skills/claim-verify.md) — skill · ★ 185 repo stars
- [research-brainstorm](https://affpapa.org/en/nevibecode/skills/research-brainstorm.md) — skill · ★ 240 repo stars
- [housing-assist](https://affpapa.org/en/nevibecode/mcp/housing-assist.md) — MCP server · 1712 installs
- [Kelnix Datamind Curator](https://affpapa.org/en/nevibecode/mcp/kelnix-datamind-curator.md) — MCP server · 1045 installs
- [parallel-findall](https://affpapa.org/en/nevibecode/skills/parallel-findall.md) — skill · 13000 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
