SERVER

OneSource MCP

Rank #102,170

smithery/one-source/mcp-1s

# @one-source/mcp Unified MCP server for [OneSource](https://docs.onesource.io) — 31 tools for blockchain data, live chain queries, and API documentation in a single server. Combines [`@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. > **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. ## Quick Start ### Claude Code ```bash claude mcp add onesource -- npx @one-source/mcp ``` ### Claude Desktop / Cursor Add to your MCP config: ```json { "mcpServers": { "onesource": { "command": "npx", "args": ["-y", "@one-source/mcp"] } } } ``` ### Any MCP Client (stdio) ```bash npx @one-source/mcp ``` ### HTTP Server (self-hosted) ```bash npx @one-source/mcp --http npx @one-source/mcp --http --port=8080 ``` Then connect your MCP client to `http://localhost:3000/`. ## Tools (31) ### Blockchain API — Live Chain (12 tools) | Tool | Description | |------|-------------| | `1s_allowance_live` | ERC20 allowance check | | `1s_contract_info_live` | Contract type detection via ERC165 | | `1s_erc1155_balance_live` | ERC1155 balance via RPC | | `1s_erc20_balance_live` | ERC20 balance via balanceOf | | `1s_erc20_transfers_live` | ERC20 Transfer logs via eth_getLogs | | `1s_erc721_tokens_live` | ERC721 token enumeration | | `1s_events_live` | Event logs via eth_getLogs | | `1s_multi_balance_live` | ETH + multiple ERC20 balances | | `1s_nft_metadata_live` | NFT metadata via tokenURI | | `1s_nft_owner_live` | NFT owner via ownerOf | | `1s_total_supply_live` | Token total supply | | `1s_tx_details_live` | Transaction + receipt via RPC | ### Blockchain API — Chain Utilities (10 tools) | Tool | Description | |------|-------------| | `1s_contract_code` | Contract bytecode | | `1s_ens_resolve` | ENS name/address resolution | | `1s_estimate_gas` | Gas estimation | | `1s_network_info` | Chain ID, block number, gas price | | `1s_nonce` | Transaction count | | `1s_pending_block` | Pending block from mempool | | `1s_proxy_detect` | Proxy contract detection | | `1s_simulate_call` | Simulate eth_call | | `1s_storage_read` | Read storage slot | | `1s_tx_receipt` | Transaction receipt | ### Documentation (9 tools) Read-only, no API key required. | 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 | ## Networks All blockchain API tools accept an optional `network` parameter: | Network | Description | |---------|-------------| | `ethereum` | Ethereum mainnet (default) | | `sepolia` | Ethereum Sepolia testnet | | `avax` | Avalanche C-Chain | ## Payment (x402) Blockchain 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. Documentation tools are always free — no API key or authentication needed. ## License Apache 2.0

Not versioned

Claim this server

First listed

Mar 31, 2026

Last publish date

—

OVERVIEW

OneSource MCP is a Model Context Protocol (MCP) server. It ranks #102,170 of 137,138 servers tracked on MCP Toplist. OneSource MCP is listed on Smithery, and ships as a single rolling release with no explicit version metadata. It was first listed on Mar 31, 2026.

STANDING

#102,170of 137,138 tracked servers

Ranks ahead of 34,968 of 137,138 servers on MCP Toplist.

CONNECT

Use OneSource MCP

Remote authHosted remote, sign-in required

Hosted remote endpoint gated by authentication — connect via its URL and authenticate with the provider (OAuth flow or an API key/header, per its docs).

Remote · HTTP

claude mcp add --transport http mcp-1s https://server.smithery.ai/one-source/mcp-1s/mcp

This endpoint requires authentication — see the server’s docs for credentials.

Remote · HTTP

[mcp_servers.mcp-1s]
url = "https://server.smithery.ai/one-source/mcp-1s/mcp"

Add to ~/.codex/config.toml. This endpoint requires authentication — see the server’s docs for credentials.

Remote · HTTP

https://server.smithery.ai/one-source/mcp-1s/mcp

Settings → Connectors → “Add custom connector”, then paste this URL. This endpoint requires authentication — see the server’s docs for credentials.

Remote · HTTP

{
  "mcpServers": {
    "mcp-1s": {
      "url": "https://server.smithery.ai/one-source/mcp-1s/mcp"
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (per project). This endpoint requires authentication — see the server’s docs for credentials.

Remote · HTTP

{
  "servers": {
    "mcp-1s": {
      "type": "http",
      "url": "https://server.smithery.ai/one-source/mcp-1s/mcp"
    }
  }
}

Save as .vscode/mcp.json in your workspace. This endpoint requires authentication — see the server’s docs for credentials.

Remote · HTTP

{
  "mcpServers": {
    "mcp-1s": {
      "serverUrl": "https://server.smithery.ai/one-source/mcp-1s/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json. This endpoint requires authentication — see the server’s docs for credentials.

Remote · HTTP

{
  "mcpServers": {
    "mcp-1s": {
      "url": "https://server.smithery.ai/one-source/mcp-1s/mcp"
    }
  }
}

This endpoint requires authentication — see the server’s docs for credentials.

BADGE

Show your rank

Maintain this server? Add the live rank badge to your README — it updates automatically as the leaderboard changes.

Markdown

[![MCP Toplist](https://mcptoplist.com/badge/smithery%2Fone-source%2Fmcp-1s.svg)](https://mcptoplist.com/server/smithery%2Fone-source%2Fmcp-1s)

HTML

<a href="https://mcptoplist.com/server/smithery%2Fone-source%2Fmcp-1s"><img src="https://mcptoplist.com/badge/smithery%2Fone-source%2Fmcp-1s.svg" alt="MCP Toplist: #102,170 of 137,138" /></a>

Variants: append ?metric=score or ?metric=stars to the image URL.

REGISTRIES

Listed on 1 registry

Smithery

VERSIONS

Not versioned

This server is published through a registry that does not expose explicit version metadata, and no GitHub release tags were found on the linked repository. The listing tracks a single rolling release.

FAQ

Frequently asked questions

Is OneSource MCP listed on the Official MCP Registry?: OneSource MCP is not on the Official MCP Registry. It is listed on Smithery.
How many versions does OneSource MCP have?: OneSource MCP ships as a single rolling release with no explicit version metadata.

Used in projects

Do you run this server?

Add to a project

Community projects list the MCP servers behind real agents and apps. Publish yours and this page will link to it.

EXPLORE

All MCP Servers Best MCP Servers Most Active MCP Servers New MCP Servers Best New MCP Servers