MCP Server
Search and retrieve Avalanche documentation dynamically via Model Context Protocol
The Model Context Protocol server enables AI systems to search and retrieve documentation dynamically.
Endpoint: https://build.avax.network/api/mcp
Tools
| Tool | Purpose |
|---|---|
avalanche_docs_search | Search docs by query with optional source filter |
avalanche_docs_fetch | Get a specific page by URL path |
avalanche_docs_list_sections | List all sections with page counts |
Claude Code Setup
Add the MCP server to your project:
claude mcp add avalanche-docs --transport http https://build.avax.network/api/mcpOr add to your .claude/settings.json:
{
"mcpServers": {
"avalanche-docs": {
"transport": {
"type": "http",
"url": "https://build.avax.network/api/mcp"
}
}
}
}Claude Desktop Setup
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"avalanche-docs": {
"transport": {
"type": "http",
"url": "https://build.avax.network/api/mcp"
}
}
}
}JSON-RPC Protocol
The MCP server uses JSON-RPC 2.0 for communication:
curl -X POST https://build.avax.network/api/mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"avalanche_docs_search","arguments":{"query":"create L1","limit":5}}}'Response format:
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"content": [
{
"type": "text",
"text": "[{\"title\":\"Create an L1\",\"url\":\"/docs/avalanche-l1s/create\",\"description\":\"...\",\"score\":45}]"
}
]
}
}Search Examples
Search all documentation:
curl -X POST https://build.avax.network/api/mcp \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "avalanche_docs_search",
"arguments": {
"query": "smart contracts",
"limit": 10
}
}
}'Filter by source:
# Search only academy content
curl -X POST https://build.avax.network/api/mcp \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "avalanche_docs_search",
"arguments": {
"query": "blockchain basics",
"source": "academy",
"limit": 5
}
}
}'Fetch specific page:
curl -X POST https://build.avax.network/api/mcp \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 3,
"method": "tools/call",
"params": {
"name": "avalanche_docs_fetch",
"arguments": {
"url": "/docs/primary-network/overview"
}
}
}'Is this guide helpful?