{"id":"92dbd684-7f44-4429-aa8f-4b99ed34fa60","slug":"smithery-one-source-mcp-1s","name":"OneSource MCP","description":"# @one-source/mcp\n\nUnified MCP server for [OneSource](https://docs.onesource.io) — 31 tools for blockchain data, live chain queries, and API documentation in a single server.\n\nCombines [`@one-source/api-mcp`](https://www.npmjs.com/package/@one-source/api-mcp) (22 tools) and [`@one-source/docs-mcp`](https://www.npmjs.com/package/@one-source/docs-mcp) (9 tools) so your AI assistant gets full access to OneSource with one MCP connection.\n\n> **What is MCP?** The [Model Context Protocol](https://modelcontextprotocol.io) lets AI assistants call tools and access data sources. This server exposes both the OneSource blockchain API and its documentation as tools.\n\n## Quick Start\n\n### Claude Code\n\n```bash\nclaude mcp add onesource -- npx @one-source/mcp\n```\n\n### Claude Desktop / Cursor\n\nAdd to your MCP config:\n\n```json\n{\n  \"mcpServers\": {\n    \"onesource\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@one-source/mcp\"]\n    }\n  }\n}\n```\n\n### Any MCP Client (stdio)\n\n```bash\nnpx @one-source/mcp\n```\n\n### HTTP Server (self-hosted)\n\n```bash\nnpx @one-source/mcp --http\nnpx @one-source/mcp --http --port=8080\n```\n\nThen connect your MCP client to `http://localhost:3000/`.\n\n## Tools (31)\n\n### Blockchain API — Live Chain (12 tools)\n\n| Tool | Description |\n|------|-------------|\n| `1s_allowance_live` | ERC20 allowance check |\n| `1s_contract_info_live` | Contract type detection via ERC165 |\n| `1s_erc1155_balance_live` | ERC1155 balance via RPC |\n| `1s_erc20_balance_live` | ERC20 balance via balanceOf |\n| `1s_erc20_transfers_live` | ERC20 Transfer logs via eth_getLogs |\n| `1s_erc721_tokens_live` | ERC721 token enumeration |\n| `1s_events_live` | Event logs via eth_getLogs |\n| `1s_multi_balance_live` | ETH + multiple ERC20 balances |\n| `1s_nft_metadata_live` | NFT metadata via tokenURI |\n| `1s_nft_owner_live` | NFT owner via ownerOf |\n| `1s_total_supply_live` | Token total supply |\n| `1s_tx_details_live` | Transaction + receipt via RPC |\n\n### Blockchain API — Chain Utilities (10 tools)\n\n| Tool | Description |\n|------|-------------|\n| `1s_contract_code` | Contract bytecode |\n| `1s_ens_resolve` | ENS name/address resolution |\n| `1s_estimate_gas` | Gas estimation |\n| `1s_network_info` | Chain ID, block number, gas price |\n| `1s_nonce` | Transaction count |\n| `1s_pending_block` | Pending block from mempool |\n| `1s_proxy_detect` | Proxy contract detection |\n| `1s_simulate_call` | Simulate eth_call |\n| `1s_storage_read` | Read storage slot |\n| `1s_tx_receipt` | Transaction receipt |\n\n### Documentation (9 tools)\n\nRead-only, no API key required.\n\n| Tool | Purpose | When to use |\n|------|---------|-------------|\n| `search_docs` | Keyword search across all documentation | Finding guides, concepts, or API patterns |\n| `get_query_reference` | Full reference for a root GraphQL query | Building a specific query with correct args/filters |\n| `get_type_definition` | Schema definition for any type/enum/input | Understanding field shapes and return types |\n| `list_examples` | Browse or search working GraphQL examples | Finding ready-to-use query patterns |\n| `list_supported_chains` | All supported blockchain networks + endpoints | First question: \"What chains are supported?\" |\n| `get_filter_reference` | Filter fields and operators for a list query | Building filtered queries with correct syntax |\n| `get_pagination_guide` | Cursor-based pagination pattern with examples | Implementing pagination for list queries |\n| `get_schema_overview` | High-level summary of the entire schema | Exploring the API surface before diving in |\n| `get_authentication_guide` | API key format, headers, and endpoints | Setting up authentication for the first time |\n\n## Networks\n\nAll blockchain API tools accept an optional `network` parameter:\n\n| Network | Description |\n|---------|-------------|\n| `ethereum` | Ethereum mainnet (default) |\n| `sepolia` | Ethereum Sepolia testnet |\n| `avax` | Avalanche C-Chain |\n\n## Payment (x402)\n\nBlockchain API endpoints are priced in USDC on Base via [x402](https://github.com/coinbase/x402). When the backend has payments enabled, tool calls return a 402 with payment details. Agents using [`@x402/fetch`](https://www.npmjs.com/package/@x402/fetch) handle this automatically.\n\nDocumentation tools are always free — no API key or authentication needed.\n\n## License\nApache 2.0","canonicalUrl":"https://www.xpersona.co/mcp/smithery-one-source-mcp-1s","sourceUrl":"https://onesource.io","homepage":"https://onesource.io","source":"SMITHERY","vendor":{"slug":"onesource","label":"Onesource","url":"https://onesource.io"},"protocols":["MCP"],"capabilities":[],"trustScore":null,"trustConfidence":"unknown","artifactCount":0,"benchmarkCount":0,"lastRelease":null,"freshnessAt":"2026-04-15T00:45:41.982Z","freshnessLabel":"Apr 15, 2026","securityReviewed":true,"openapiReady":false,"stats":[{"label":"Trust score","value":"Unknown"},{"label":"Compatibility","value":"MCP"},{"label":"Freshness","value":"Apr 15, 2026"},{"label":"Vendor","value":"Onesource"},{"label":"Artifacts","value":"0"},{"label":"Benchmarks","value":"0"},{"label":"Last release","value":"Unpublished"}],"factsPreview":[{"factKey":"vendor","label":"Vendor","value":"Onesource","category":"vendor","href":"https://onesource.io","sourceUrl":"https://onesource.io","sourceType":"profile","confidence":"medium","observedAt":"2026-04-15T00:45:41.982Z","isPublic":true,"metadata":{}},{"factKey":"protocols","label":"Protocol compatibility","value":"MCP","category":"compatibility","href":"https://www.xpersona.co/api/v1/agents/smithery-one-source-mcp-1s/contract","sourceUrl":"https://www.xpersona.co/api/v1/agents/smithery-one-source-mcp-1s/contract","sourceType":"contract","confidence":"medium","observedAt":"2026-04-15T00:45:41.982Z","isPublic":true,"metadata":{}},{"factKey":"handshake_status","label":"Handshake status","value":"UNKNOWN","category":"security","href":"https://www.xpersona.co/api/v1/agents/smithery-one-source-mcp-1s/trust","sourceUrl":"https://www.xpersona.co/api/v1/agents/smithery-one-source-mcp-1s/trust","sourceType":"trust","confidence":"medium","observedAt":null,"isPublic":true,"metadata":{}}],"highlights":["Trust evidence available"],"agentCard":{"name":"OneSource MCP","description":"# @one-source/mcp\n\nUnified MCP server for [OneSource](https://docs.onesource.io) — 31 tools for blockchain data, live chain queries, and API documentation in a single server.\n\nCombines [`@one-source/api-mcp`](https://www.npmjs.com/package/@one-source/api-mcp) (22 tools) and [`@one-source/docs-mcp`](https://www.npmjs.com/package/@one-source/docs-mcp) (9 tools) so your AI assistant gets full access to OneSource with one MCP connection.\n\n> **What is MCP?** The [Model Context Protocol](https://modelcontextprotocol.io) lets AI assistants call tools and access data sources. This server exposes both the OneSource blockchain API and its documentation as tools.\n\n## Quick Start\n\n### Claude Code\n\n```bash\nclaude mcp add onesource -- npx @one-source/mcp\n```\n\n### Claude Desktop / Cursor\n\nAdd to your MCP config:\n\n```json\n{\n  \"mcpServers\": {\n    \"onesource\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@one-source/mcp\"]\n    }\n  }\n}\n```\n\n### Any MCP Client (stdio)\n\n```bash\nnpx @one-source/mcp\n```\n\n### HTTP Server (self-hosted)\n\n```bash\nnpx @one-source/mcp --http\nnpx @one-source/mcp --http --port=8080\n```\n\nThen connect your MCP client to `http://localhost:3000/`.\n\n## Tools (31)\n\n### Blockchain API — Live Chain (12 tools)\n\n| Tool | Description |\n|------|-------------|\n| `1s_allowance_live` | ERC20 allowance check |\n| `1s_contract_info_live` | Contract type detection via ERC165 |\n| `1s_erc1155_balance_live` | ERC1155 balance via RPC |\n| `1s_erc20_balance_live` | ERC20 balance via balanceOf |\n| `1s_erc20_transfers_live` | ERC20 Transfer logs via eth_getLogs |\n| `1s_erc721_tokens_live` | ERC721 token enumeration |\n| `1s_events_live` | Event logs via eth_getLogs |\n| `1s_multi_balance_live` | ETH + multiple ERC20 balances |\n| `1s_nft_metadata_live` | NFT metadata via tokenURI |\n| `1s_nft_owner_live` | NFT owner via ownerOf |\n| `1s_total_supply_live` | Token total supply |\n| `1s_tx_details_live` | Transaction + receipt via RPC |\n\n### Blockchain API — Chain Utilities (10 tools)\n\n| Tool | Description |\n|------|-------------|\n| `1s_contract_code` | Contract bytecode |\n| `1s_ens_resolve` | ENS name/address resolution |\n| `1s_estimate_gas` | Gas estimation |\n| `1s_network_info` | Chain ID, block number, gas price |\n| `1s_nonce` | Transaction count |\n| `1s_pending_block` | Pending block from mempool |\n| `1s_proxy_detect` | Proxy contract detection |\n| `1s_simulate_call` | Simulate eth_call |\n| `1s_storage_read` | Read storage slot |\n| `1s_tx_receipt` | Transaction receipt |\n\n### Documentation (9 tools)\n\nRead-only, no API key required.\n\n| Tool | Purpose | When to use |\n|------|---------|-------------|\n| `search_docs` | Keyword search across all documentation | Finding guides, concepts, or API patterns |\n| `get_query_reference` | Full reference for a root GraphQL query | Building a specific query with correct args/filters |\n| `get_type_definition` | Schema definition for any type/enum/input | Understanding field shapes and return types |\n| `list_examples` | Browse or search working GraphQL examples | Finding ready-to-use query patterns |\n| `list_supported_chains` | All supported blockchain networks + endpoints | First question: \"What chains are supported?\" |\n| `get_filter_reference` | Filter fields and operators for a list query | Building filtered queries with correct syntax |\n| `get_pagination_guide` | Cursor-based pagination pattern with examples | Implementing pagination for list queries |\n| `get_schema_overview` | High-level summary of the entire schema | Exploring the API surface before diving in |\n| `get_authentication_guide` | API key format, headers, and endpoints | Setting up authentication for the first time |\n\n## Networks\n\nAll blockchain API tools accept an optional `network` parameter:\n\n| Network | Description |\n|---------|-------------|\n| `ethereum` | Ethereum mainnet (default) |\n| `sepolia` | Ethereum Sepolia testnet |\n| `avax` | Avalanche C-Chain |\n\n## Payment (x402)\n\nBlockchain API endpoints are priced in USDC on Base via [x402](https://github.com/coinbase/x402). When the backend has payments enabled, tool calls return a 402 with payment details. Agents using [`@x402/fetch`](https://www.npmjs.com/package/@x402/fetch) handle this automatically.\n\nDocumentation tools are always free — no API key or authentication needed.\n\n## License\nApache 2.0","source":"SMITHERY","sourceId":"smithery:one-source/mcp-1s","homepage":"https://onesource.io","repository":"https://onesource.io","documentation":"https://www.xpersona.co/mcp/smithery-one-source-mcp-1s/agent/smithery-one-source-mcp-1s","protocols":["MCP"],"examples":[{"kind":"example","language":"bash","snippet":"claude mcp add onesource -- npx @one-source/mcp"},{"kind":"example","language":"json","snippet":"{\n  \"mcpServers\": {\n    \"onesource\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@one-source/mcp\"]\n    }\n  }\n}"}]}}