Skip to content
MCP server

OneSource MCP

Query live blockchain data and market data from an AI assistant over stdio

Runs locallyStatus and history
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/mcp

Add 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 Base
  • ONESOURCE_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

  1. Open-source analytics app where an AI agent builds charts and dashboards from your data

    • Remote
    • Open source
    • 7.7K GitHub stars
    • Analytics and data
  2. Hosted 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
  3. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  4. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  5. World Monitor

    MCP server

    Live geopolitical intelligence dashboard with an API and MCP server for agents

    • Remote
    • Freemium
    • Analytics and data
  6. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments