# OneSource MCP

> OneSource MCP is a freemium MCP server for finance and payments. Query live blockchain data and market data from an AI assistant over stdio. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI, API
- **Website:** https://mcp.onesource.io
- **Repository:** https://github.com/blockparty-global/1s-mcp
- **MCP Registry name:** io.onesource/mcp
- **Categories:** finance and payments, analytics and data
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp --env X402_PRIVATE_KEY='<X402_PRIVATE_KEY>' --env ONESOURCE_API_KEY='<ONESOURCE_API_KEY>' -- npx -y @one-source/mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@one-source/mcp"
      ],
      "env": {
        "X402_PRIVATE_KEY": "<X402_PRIVATE_KEY>",
        "ONESOURCE_API_KEY": "<ONESOURCE_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@one-source/mcp"
      ],
      "env": {
        "X402_PRIVATE_KEY": "<X402_PRIVATE_KEY>",
        "ONESOURCE_API_KEY": "<ONESOURCE_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@one-source/mcp"
      ],
      "env": {
        "X402_PRIVATE_KEY": "<X402_PRIVATE_KEY>",
        "ONESOURCE_API_KEY": "<ONESOURCE_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@one-source/mcp"
      ],
      "env": {
        "X402_PRIVATE_KEY": "<X402_PRIVATE_KEY>",
        "ONESOURCE_API_KEY": "<ONESOURCE_API_KEY>"
      }
    }
  }
}
```

## Tools

- `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.

## 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

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/onesource-mcp
