# macrostrat-mcp

Explore global geologic data to answer questions about bedrock, formations, ages, and stratigraphy. Retrieve units, columns, minerals, timescales, and definitions for any location to build accurate g…

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add blake365/macrostrat-mcp

# Browse available tools
npx -y @smithery/cli@latest tool list blake365/macrostrat-mcp

# Get full schema for a tool
npx -y @smithery/cli@latest tool get blake365/macrostrat-mcp find-columns

# Call a tool
npx -y @smithery/cli@latest tool call blake365/macrostrat-mcp find-columns '{}'
```

## Direct MCP Connection

Endpoint: `https://macrostrat-mcp--blake365.run.tools`

## Tools (8)

- `find-columns` — Find geological stratigraphic columns, rock layers, and geological history for any location worldwide. Use for geology,…
- `find-units` — Find geological rock units, formations, bedrock geology, and mineral information for any location worldwide. Use for ge…
- `defs` — Routes giving access to standard fields and dictionaries used in Macrostrat
- `defs-autocomplete` — Quickly retrieve all definitions matching a query. Limited to 100 results
- `mineral-info` — Get information about a mineral, use one property
- `timescale` — Get information about a time period
- `lat-lng-to-tile` — Convert latitude/longitude coordinates to map tile coordinates (x, y) for a given zoom level. Uses the same web mercato…
- `map-tiles` — Get map tile URLs from the Macrostrat tiles server. Use lat-lng-to-tile tool first to get proper x,y coordinates. Defau…

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get blake365/macrostrat-mcp <tool-name>
```

## Resources

- `api_response` — JSON schema for the standard Macrostrat API response wrapper containing success metadata and data array
- `units` — JSON schema for the response from the units endpoint
- `columns` — JSON schema for the response from the columns endpoint
- `minerals` — JSON schema for the response from the defs/minerals endpoint
- `lithologies` — JSON schema for the response from the defs/lithologies endpoint
- `environments` — JSON schema for the response from the defs/environments endpoint
- `timescales` — JSON schema for the response from the defs/timescales endpoint
- `intervals` — JSON schema for the response from the defs/intervals endpoint
- `econs` — JSON schema for the response from the defs/econs endpoint
- `strat_names` — JSON schema for the response from the defs/strat_names endpoint
- `structures` — JSON schema for the response from the defs/structures endpoint
- `measurements` — JSON schema for the response from the defs/measurements endpoint

## Prompts (3)

- `geologic-history` (location) — Get the geologic history of a location
- `bedrock` (location) — Get information about bedrock geology
- `geologic-map` (location, zoom_level, scale) — Generate map tiles for visualizing geology of an area

---

Source: https://github.com/blake365/macrostrat-mcp