Alkahest Docs MCP Server

An MCP (Model Context Protocol) server that provides intelligent documentation access for the Alkahest protocol. Goes beyond static docs by extracting structured knowledge from contracts, SDK, and deployments.

Features

• Smart Search: Full-text search across contracts, SDK modules, and guides
• Contract Documentation: Detailed info including functions, events, errors, schemas, and deployed addresses
• SDK Documentation: Client method listings with hierarchical module structure
• Deployment Info: Contract addresses per chain (Base Sepolia, Filecoin Calibration, Monad)
• Guide Access: Documentation guides with code examples

Installation

cd docs/mcp-server
bun install
bun run build

Usage

Quick Setup (Copy-Paste)

Claude Code:

claude mcp add alkahest-docs node /path/to/alkahest/docs/mcp-server/dist/index.js

Cursor / Windsurf / Other MCP Clients:

npx @anthropic-ai/mcp-cli add alkahest-docs node /path/to/alkahest/docs/mcp-server/dist/index.js

Manual Config

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

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

Claude Code (~/.claude/settings.json):

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

Replace /path/to/alkahest with your actual repo path.

Development

# Generate documentation data
bun run generate

# Build
bun run build

# Run in dev mode
bun run dev

Available Tools

search_docs

Search across all documentation.

{
  "query": "ERC20 escrow",
  "type": "contract",  // optional: contract, sdk, guide, all
  "limit": 10         // optional
}

get_contract

Get detailed contract documentation.

{
  "name": "ERC20EscrowObligation"
}

list

List contracts or SDK modules by category.

{
  "type": "contract",
  "category": "arbiter"  // optional: arbiter, escrow, payment, utils
}

get_deployment

Get contract addresses for a chain.

{
  "chain": "base-sepolia"
}

get_sdk_method

Get SDK module documentation.

{
  "module": "erc20"
}

get_guide

Get a documentation guide.

{
  "topic": "token trading"
}

Regenerating Data

When contracts, SDK, or docs change:

bun run generate
bun run build

Architecture

docs/mcp-server/
├── scripts/           # Data extraction
│   ├── generate.ts    # Main generation script
│   ├── parse-solidity.ts
│   ├── parse-sdk.ts
│   ├── parse-deployments.ts
│   └── parse-guides.ts
├── src/
│   ├── index.ts       # MCP server
│   ├── data/          # Data loading
│   └── search/        # Search engine
└── generated/         # Build output (gitignored)