
OneSource MCP
Query live blockchain data and market data from an AI assistant over stdio
- Pricing
- Freemium
- Platforms
- CLI, API
- Runs
- Locally
- Version
- 5.25.0
- Listing updated
- 3 days ago
About OneSource MCP
OneSource MCP is a freemium MCP server for finance and payments. It runs locally on your machine and is started by your AI client.
The npm package bundles blockchain API tools, live chain queries through RPC, chain utilities, Deepstate and Standard Reserve market data, and the OneSource REST API docs in a single server. The README lists live tools such as ERC20 balances and allowances, ERC721 and ERC1155 lookups, event logs, and transaction details, though its tool counts differ between headings.
Payment is flexible: set an API key for bearer auth, or provide an EVM private key so calls are paid automatically in USDC on Base through x402. The site mentions pay per call via x402 or MPP, or a flat-rate API key, and being free to start.
Run it with npx over stdio, or start an HTTP mode yourself with a chosen port.
Install
Run in a terminal
claude mcp add mcp --env X402_PRIVATE_KEY='<X402_PRIVATE_KEY>' --env ONESOURCE_API_KEY='<ONESOURCE_API_KEY>' -- npx -y @one-source/mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@one-source/mcp"
],
"env": {
"X402_PRIVATE_KEY": "<X402_PRIVATE_KEY>",
"ONESOURCE_API_KEY": "<ONESOURCE_API_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@one-source/mcp"
],
"env": {
"X402_PRIVATE_KEY": "<X402_PRIVATE_KEY>",
"ONESOURCE_API_KEY": "<ONESOURCE_API_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@one-source/mcp"
],
"env": {
"X402_PRIVATE_KEY": "<X402_PRIVATE_KEY>",
"ONESOURCE_API_KEY": "<ONESOURCE_API_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@one-source/mcp"
],
"env": {
"X402_PRIVATE_KEY": "<X402_PRIVATE_KEY>",
"ONESOURCE_API_KEY": "<ONESOURCE_API_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@one-source/mcp"
],
"env": {
"X402_PRIVATE_KEY": "<X402_PRIVATE_KEY>",
"ONESOURCE_API_KEY": "<ONESOURCE_API_KEY>"
}
}
}
}Configuration
X402_PRIVATE_KEYEVM private key (64-char hex, 0x prefix optional) for automatic x402 USDC payments on BaseONESOURCE_API_KEYOneSource API key for Bearer token auth
Tools this server provides (5)
Taken from the project documentation; the running server may differ.
- 1s_erc20_balance_live
- ERC20 balance via balanceOf.
- 1s_allowance_live
- ERC20 allowance check.
- 1s_nft_owner_live
- NFT owner via ownerOf.
- 1s_events_live
- Event logs via eth_getLogs.
- 1s_tx_details_live
- Transaction and receipt via RPC.
What it does
- Live chain queries
- Read balances, allowances, logs and transactions over RPC.
- NFT lookups
- Fetch owners, metadata and enumerate tokens.
- Market data tools
- Deepstate and Standard Reserve data.
- API documentation tools
- Browse the OneSource REST docs from the assistant.
- x402 payments
- Optional automatic USDC payments on Base.
Good for
- Check an ERC20 balance for an address
- Look up who owns an NFT
- Pull event logs for a contract
- Let an agent read API docs while writing integration code
Pricing
Freemium
Free to start; pay per call via x402/MPP or flat-rate API key
Prices change. Check mcp.onesource.io before you buy.
OneSource MCP FAQ
How do I authenticate?
Set ONESOURCE_API_KEY, or an EVM private key for automatic x402 payments.
Can it run as an HTTP server?
Yes, with the --http flag and optional --port.
Is it free?
The site says free to start, then pay per call or flat-rate key.
Which clients are shown?
Claude Code, Claude Desktop, Cursor and any stdio client.
Is OneSource MCP free?
OneSource MCP has a free plan, with paid plans for more usage or features.
How do I add OneSource MCP to Claude Code?
Run this command in your terminal: claude mcp add mcp --env X402_PRIVATE_KEY='<X402_PRIVATE_KEY>' --env ONESOURCE_API_KEY='<ONESOURCE_API_KEY>' -- npx -y @one-source/mcp
What are the best alternatives to OneSource MCP?
The closest alternatives to OneSource MCP are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Solana MCP by Vybe, Tapetide - Indian Stock Market MCP and World Monitor.
Alternatives to OneSource MCP

Agent-Native Analytics
MCP serverOpen-source analytics app where an AI agent builds charts and dashboards from your data
- Remote
- Open source
- 7.7K GitHub stars
- Analytics and data

Google Ads + Meta Ads + SEO/GEO MCP
MCP serverHosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat
- 8 tools
- Remote
- Freemium
- 8.1K GitHub stars
- Marketing and SEO

Solana MCP by Vybe
MCP serverRemote MCP server exposing the Vybe Solana API to AI clients and code editors
- 44 tools
- Remote
- 2.8K GitHub stars
- Finance and payments

Tapetide - Indian Stock Market MCP
MCP serverIndian NSE and BSE stock market data for AI assistants through 48 MCP tools
- 17 tools
- Remote
- Freemium
- 150 GitHub stars
- Finance and payments

World Monitor
MCP serverLive geopolitical intelligence dashboard with an API and MCP server for agents
- Remote
- Freemium
- Analytics and data
Budget Tracker
MCP serverLocal MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling
- 14 tools
- Remote
- Freemium
- 2 GitHub stars
- Finance and payments