@one-source/docs-mcp

Give your AI assistant full access to the OneSource Web3 API documentation — search docs, explore the GraphQL schema, and find working query examples for Ethereum, Base, Optimism, Avalanche, Sepolia, and Shape.

What is MCP? The Model Context Protocol lets AI assistants call tools and access data sources. This server exposes OneSource documentation as 9 read-only tools — no API key or authentication needed.

Quick Start

Remote (zero setup)

Point any MCP client at the hosted endpoint — no install required:

https://docs.onesource.io/api/mcp

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "onesource-docs": {
      "command": "npx",
      "args": ["-y", "@one-source/docs-mcp"]
    }
  }
}

Claude Code

claude mcp add onesource-docs -- npx @one-source/docs-mcp

Any MCP Client (stdio)

npx @one-source/docs-mcp

HTTP Server (self-hosted)

npx @one-source/docs-mcp --http
npx @one-source/docs-mcp --http --port=8080

Then connect your MCP client to http://localhost:3001/mcp.

Tools

| Tool | Purpose | When to use | |------|---------|-------------| | search_docs | Keyword search across all documentation | Finding guides, concepts, or API patterns | | get_query_reference | Full reference for a root GraphQL query | Building a specific query with correct args/filters | | get_type_definition | Schema definition for any type/enum/input | Understanding field shapes and return types | | list_examples | Browse or search working GraphQL examples | Finding ready-to-use query patterns | | list_supported_chains | All supported blockchain networks + endpoints | First question: "What chains are supported?" | | get_filter_reference | Filter fields and operators for a list query | Building filtered queries with correct syntax | | get_pagination_guide | Cursor-based pagination pattern with examples | Implementing pagination for list queries | | get_schema_overview | High-level summary of the entire schema | Exploring the API surface before diving in | | get_authentication_guide | API key format, headers, and endpoints | Setting up authentication for the first time |

search_docs

Search all OneSource documentation by keyword. Returns the top 5 matching sections with relevance scores.

{ "query": "NFT metadata" }

get_query_reference

Get the full reference for a root GraphQL query — arguments, filters, and return type.

Available queries: address, addresses, block, blocks, contract, contracts, nft, nfts, token, tokens, transaction, transactions.

{ "query_name": "transactions" }

get_type_definition

Get the schema definition for any GraphQL type, enum, scalar, input, or interface.

{ "type_name": "Transaction" }

list_examples

List all available examples, or search by topic. Without a topic, returns a summary. With a topic, returns full content matching that keyword.

{ "topic": "token transfers" }

list_supported_chains

List all blockchain networks supported by OneSource with endpoint URLs and chain slugs.

{}

get_filter_reference

Get all filter fields and range operators for a specific list query.

{ "query_name": "transactions" }

get_pagination_guide

Get the cursor-based pagination pattern with step-by-step flow and common mistakes.

{ "query_name": "tokens" }

get_schema_overview

Get a high-level summary of the entire GraphQL schema — all queries, types, enums, interfaces, and scalars at a glance.

{}

get_authentication_guide

Get the full authentication guide — API key format, endpoint pattern, required headers, and common mistakes.

{}

Troubleshooting

Tools return "Data files may be missing" Try reinstalling: npm install @one-source/docs-mcp

npx hangs with no output That's normal — stdio mode waits for JSON-RPC input on stdin. Use --http if you want an HTTP server you can curl.

Port already in use Specify a different port: npx @one-source/docs-mcp --http --port=8080

"Type not found" even though it exists Type names are case-insensitive but must match the GraphQL name (e.g. Transaction, not transaction_type). The tool will suggest close matches.

Security

All tools are read-only — no authentication, no writes, no API keys required.

License

MIT