home / mcp / macrostrat mcp server

Macrostrat MCP Server

MCP server for accessing geologic data with the Macrostrat API

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "blake365-macrostrat-mcp": {
      "command": "node",
      "args": [
        "/Full/Route/to/Folder/macrostrat/build/index.js"
      ]
    }
  }
}

You can run the Macrostrat MCP Server to access Macrostrat geologic data from Claude Desktop or other MCP clients. It lets you query geologic units, columns, minerals, timescales, and even fetch map tiles for interpretation, all through natural language requests.

How to use

Use an MCP client to connect to the Macrostrat MCP Server. Once connected, you can ask for geologic data, request specific formations or time periods, generate graphics from Macrostrat data, and retrieve map tiles for visualization. Start by launching the MCP client and selecting the Macrostrat MCP Server from your configured MCP endpoints. You will then be able to query and analyze geologic information through natural language, with responses that reference Macrostrat data.

How to install

Prerequisites: you need Node.js and npm installed on your system.

Install Macrostrat MCP Server via Smithery automatically for Claude Desktop.

npx -y @smithery/cli install @blake365/macrostrat-mcp --client claude

Additional setup and connection details

If you want to modify the server, you can edit the source at the indicated location and rebuild.

Build and run steps shown in the server setup are: - Install dependencies - Build the server - Start or load the server via your runtime command

To connect Claude Desktop to the local server, add a configuration block that points to the local runtime path as shown.

{
  "mcpServers": {
    "macrostrat": {
      "command": "node",
      "args": [
        "/Full/Route/to/Folder/macrostrat/build/index.js"
      ]
    }
  }
}

Troubleshooting

If you encounter errors starting the server, you may need to specify the full path to the node executable on your system.

Example: use the full path to node on macOS systems if needed.

Security and notes

Only run MCP servers from trusted sources and keep dependencies up to date. Avoid sharing access tokens or sensitive environment details in insecure channels.

Available tools

query_macrostrat

Handle natural language queries to Macrostrat, translating to API calls and returning structured results.

access_units

Retrieve information about lithologic units, formations, and stratigraphic relationships from Macrostrat.

get_map_tiles

Obtain geologic map tiles for visualization or interpretation by the client.

analyze_and_visualize

Analyze geologic data and generate graphics or summaries for user-friendly presentation.