beta.rocks MCP Server

An MCP (Model Context Protocol) server that gives AI assistants direct access to the beta.rocks climbing API.

Tools

| Tool | Description | |------|-------------| | search_crags | Search climbing crags by name | | get_crag | Get crag detail by ID (sectors, rock type, location) | | find_nearby_crags | Find crags near coordinates | | get_conditions | Get weather and climbing conditions for a crag | | get_crag_reports | Get community reports for a crag | | submit_report | Submit a community report (requires sync_key) |

Installation

Claude.ai (Remote)

Add as an MCP integration in Claude.ai settings using the server URL:

https://beta.rocks/api/mcp

No installation needed — works directly in the browser.

Claude Code

claude mcp add beta-rocks -- npx beta-rocks-mcp

Claude Desktop

Add to your config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "beta-rocks": {
      "command": "npx",
      "args": ["beta-rocks-mcp"]
    }
  }
}

Cursor

Open Settings > MCP Servers > Add new MCP server:

{
  "mcpServers": {
    "beta-rocks": {
      "command": "npx",
      "args": ["beta-rocks-mcp"]
    }
  }
}

Windsurf

Open Settings > MCP > Add server > Add custom server:

{
  "mcpServers": {
    "beta-rocks": {
      "command": "npx",
      "args": ["beta-rocks-mcp"]
    }
  }
}

Cline (VS Code)

Open Cline settings > MCP Servers > Add:

{
  "mcpServers": {
    "beta-rocks": {
      "command": "npx",
      "args": ["beta-rocks-mcp"]
    }
  }
}

Any MCP-compatible client

The config is the same for any client that supports MCP:

{
  "mcpServers": {
    "beta-rocks": {
      "command": "npx",
      "args": ["beta-rocks-mcp"]
    }
  }
}

From source

git clone https://github.com/rbatsenko/beta-rocks
cd beta-rocks/mcp
npm install && npm run build

Then use the local path:

{
  "mcpServers": {
    "beta-rocks": {
      "command": "node",
      "args": ["/path/to/beta-rocks/mcp/dist/index.js"]
    }
  }
}

Configuration

| Env Variable | Default | Description | |---|---|---| | BETA_ROCKS_SYNC_KEY | — | Your beta.rocks sync key (required to submit reports) | | BETA_ROCKS_API_URL | https://beta.rocks | API base URL |

To set your sync key, add env to the MCP config:

{
  "mcpServers": {
    "beta-rocks": {
      "command": "npx",
      "args": ["beta-rocks-mcp"],
      "env": {
        "BETA_ROCKS_SYNC_KEY": "your-sync-key-here"
      }
    }
  }
}

You can find your sync key in the beta.rocks app under Settings.

Usage

Once connected, you can ask your AI assistant things like:

• "Search for climbing crags near Munich"
• "What's the rock type at Frankenjura?"
• "Find crags within 10km of 49.7, 11.3"
• "Show me recent condition reports for Frankenjura"
• "Are there any safety reports for this crag?"

API

This MCP server wraps the beta.rocks public API v1. Full API reference available at beta.rocks/llms-full.txt.