Ergo Developer Knowledge Base — MCP Server

An MCP (Model Context Protocol) server providing semantic search and documentation lookup across the Ergo blockchain developer knowledge base. 65 ecosystem projects, concept guides, contract analyses, and cross-cutting development patterns.

Works with any MCP-compatible client — Claude, Gemini, Codex, Cursor, VS Code, and more.

Setup

Claude.ai (Web)

Go to claude.ai/customize/connectors
Click + and set the URL to: https://ergo-knowledge-base.vercel.app/api/mcp
Click through the auth prompt (no-op OAuth — public data, no real credentials needed)

Claude Code

Edit ~/.claude/mcp.json:

{
  "mcpServers": {
    "ergo-code": {
      "url": "https://ergo-knowledge-base.vercel.app/api/mcp"
    }
  }
}

Gemini CLI (free)

Edit ~/.gemini/settings.json:

{
  "mcpServers": {
    "ergo-code": {
      "url": "https://ergo-knowledge-base.vercel.app/api/mcp"
    }
  }
}

Free tier: 1,000 requests/day with a Google account.

OpenAI Codex CLI

Edit ~/.codex/mcp.json:

{
  "mcpServers": {
    "ergo-code": {
      "url": "https://ergo-knowledge-base.vercel.app/api/mcp"
    }
  }
}

VS Code / Copilot

Add to .vscode/mcp.json in your workspace:

{
  "servers": {
    "ergo-code": {
      "url": "https://ergo-knowledge-base.vercel.app/api/mcp"
    }
  }
}

Cursor

Go to Settings > MCP and add the server URL:

https://ergo-knowledge-base.vercel.app/api/mcp

Windsurf

Edit ~/.windsurf/mcp.json:

{
  "mcpServers": {
    "ergo-code": {
      "url": "https://ergo-knowledge-base.vercel.app/api/mcp"
    }
  }
}

Cline (free, open-source VS Code extension)

Open Cline settings and add a remote MCP server with URL: https://ergo-knowledge-base.vercel.app/api/mcp

Local Development

git clone https://github.com/cannonQ/ergo-knowledge-base.git
cd ergo-knowledge-base/mcp-server
cp .env.local.example .env.local
# Edit .env.local with your OpenAI API key
npm install && npm run dev

Available Tools

Tool	Description
search_docs	Semantic vector search across all EKB content
get_concept	Retrieve concept docs (eUTXO, Sigma protocols, storage rent, etc.)
get_contract	Get contract analysis for an ecosystem project
get_pattern	Cross-cutting development pattern guides
get_cookbook	Code recipes with ErgoScript + Fleet SDK (tokens, contracts)
get_eip	Ergo Improvement Proposals by number (EIP-1 through EIP-44)
get_ergoscript_ref	ErgoScript language reference (built-ins, types, context vars)
list_projects	List all 65 ecosystem projects
get_skill	Complete skill docs: Nautilus, Babel fees, Fleet SDK, AVL, WASM, AppKit
audit_contract	Pass 1: Initial ErgoScript security audit with full EKB context
audit_verify	Pass 2: Independent verification of audit findings

Source: cannonQ/ergo-knowledge-base · Licensed under AGPL-3.0