onesource

@one-source/mcp

Unified MCP server for OneSource — 30 tools for blockchain data and live chain queries in a single server.

What is MCP? The Model Context Protocol 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

claude mcp add onesource -- npx -y @one-source/mcp@latest

Claude Desktop / Cursor

Add to your MCP config:

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

Any MCP Client (stdio)

npx -y @one-source/mcp@latest

HTTP Server (self-hosted)

npx -y @one-source/mcp@latest --http
npx -y @one-source/mcp@latest --http --port=8080

Then connect your MCP client to http://localhost:8080/.

Health check: GET http://localhost:8080/health

Tools (30)

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 (13 tools)

RPC only.

Tool	Description
1s_block_by_number	Block details by number via RPC
1s_block_number	Latest block number
1s_chain_id	EIP-155 chain ID
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

Payments (2 tools)

Tool	Description
1s_payment_mode	View or switch the x402 payment scheme — exact (per-call) vs batch (payment channel: one deposit funds many off-chain calls, settled with a single claim)
1s_refund	Refund unused batch channel balance back to your wallet on demand

Setup & Ops (3 tools)

No authentication required.

Tool	Purpose	When to use
1s_setup_check	Server health, version, auth status, batch-settlement status, and setup instructions	First thing to call — checks if everything is configured
1s_batch_config	View or change x402 batch-settlement preferences (autonomy, threshold, deposit multiplier, default mode) and persist them across restarts — no config editing required	Configure batch behaviour from the session
1s_report_bug	Report bugs to Slack (or GitHub Issues fallback)	When a tool errors or user wants to report an issue

Networks

All blockchain API tools accept an optional network parameter:

Network	Description
ethereum	Ethereum mainnet (default)
sepolia	Ethereum Sepolia testnet

Authentication