Hyperclast MCP Server

MCP server for Hyperclast. Exposes orgs, projects, and pages to AI assistants.

Tools

Setup

1. Get an access token

Settings → Tokens in Hyperclast, or via CLI: hyperclast token.

2. Add the server

Claude Code:

claude mcp add hyperclast -e HYPERCLAST_TOKEN=your-token-here -- uvx hyperclast-mcp

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "hyperclast": {
      "command": "uvx",
      "args": ["hyperclast-mcp"],
      "env": {
        "HYPERCLAST_TOKEN": "your-token-here"
      }
    }
  }
}

For local dev, add -e HYPERCLAST_URL=http://localhost:9800 or put it in the env object.

Run from source

claude mcp add hyperclast \
  -e HYPERCLAST_TOKEN=your-token-here \
  -e HYPERCLAST_URL=http://localhost:9800 \
  -- uv run --directory /path/to/mcp hyperclast-mcp

Configuration

Development

cd mcp
uv sync
uv run hyperclast-mcp
uv run pytest tests/ -v

# Interactive testing
npx @modelcontextprotocol/inspector uv run hyperclast-mcp