OneSource MCP
# @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
Executive verdict
trustsnap_8118401451b37466- No segmented attention signals observed in the current window.
Current trust snapshot
trustsnap_8118401451b37466Canonical machine links
Own this MCP?
Claim ownership, prove control with a GitHub, DNS, HTTP, MCP metadata, or email-domain challenge, revalidate now, publish a badge, configure monitoring, and unlock a verified server profile.
POST /v1/servers/one-source/mcp-1s/revalidateBadge embed
[](https://verify.sentinelsignal.io/servers/one-source/mcp-1s)
MCP TrustOps
TrustOps turns this report into operational controls: freshness SLAs, authenticated validation, semantic benchmarks, policy exports, alert subscriptions, badges, cost/compliance metadata, and runtime routing. Fresh trusted index decisions stay separate from long-tail inventory so stale scores do not masquerade as current evidence.
/v1/decideAlert subscription types
MCP Runtime hosting
No hosted runtime profile is available yet.
Production readiness class
Evidence confidence
Recommended for
No recommendation profile is available yet.
Client compatibility verdicts
No client compatibility verdicts are available yet.
Why compatibility is limited by client
No per-client remediation checklist is available yet.
Verdict traces
No verdict trace data is available yet.
Publishability policy profiles
No publishability policy profiles are available yet.
Compatibility fixtures
No compatibility fixtures are available yet.
Authenticated validation sessions
No authenticated validation detail is available yet.
Public validation is free. Authenticated validation is paid and proves scoped behavior, write-action safeguards, and authenticated tool execution.
Public server reputation
No public server reputation signals are available yet.
Incident & change feed
No incidents or changes recorded yet.
Capabilities
- OAuth:
- DCR/CIMD:
- Prompts:
- Homepage: https://onesource.io
- Docs: none
- Support: none
- Icon: https://api.smithery.ai/servers/one-source/mcp-1s/icon
- Remote endpoint: none
- Server card: none
Security posture
No security posture summary available yet.
Agent Commerce & Payment Readiness - Beta
No agent-commerce assessment available yet.
Tool capability & risk inventory
No tool inventory available from the latest validation run.
Write-action governance
No write-action governance summary is available yet.
Action-controls diff
Need at least two validation runs before diffing action controls.
Why this score?
No score decomposition available yet.
Algorithmic score breakdown
Compatibility profiles
No compatibility profiles available.
Actionable remediation
No remediation items. Current evidence does not show urgent client-facing fixes.
Point loss breakdown
No current score penalties are recorded.
Validation diff
Need at least two validation runs before diffing changes.
Tool snapshot diff & changelog
Need at least two validation runs before building a tool changelog.
Connector replay
No connector replay evidence is available yet.
Transport compliance drilldown
No transport compliance drilldown is available yet.
Request association
No request-association evidence is available yet.
Utility coverage
No utility-coverage summary is available yet.
Benchmark tasks
No benchmark tasks are available yet.
Registry & provenance divergence
No provenance-divergence summary is available yet.
Active alerts
No active alerts for the current server state.
Aliases & registry graph
No aliases discovered for this server.
Alias consolidation
No alias consolidation details are available yet.
Install snippets
No install snippets available.
Agent access & tool surface
tools/list, prompts/list, and resources/list checks.one-source/mcp-1s.Claims & monitoring
No verified maintainer claim recorded.
Alert routing
No alert routing is configured yet.
Maintainer analytics
No maintainer analytics available.
Maintainer response quality
No maintainer response quality signals are available yet.
Maintainer annotations
No maintainer annotations have been recorded yet.
Maintainer rebuttals & expected behavior
No maintainer rebuttals or expected-behavior overrides are recorded yet.
Latest validation evidence
No validation run available yet.
Raw evidence view
No raw evidence recorded.
Known versions
- No versions recorded.
Validation history
No historical trend summary is available yet.
Validation timeline
No validation timeline is available yet.
Recent validation runs
| Started | Status | Summary | Latency | Checks |
|---|---|---|---|---|
| No validation runs yet. | ||||