io.github.xOrbuc/orbuc

Official12 tools

by xOrbuc

Orbuc

On-chain stablecoin market cap and Bitcoin institutional holdings data.

Tracks on-chain stablecoin market cap and Bitcoin institutional holdings data.

Captured live from the server via tools/list.

orbuc_stablecoin_mcap

Get historical daily total stablecoin market cap across all tracked issuers. Returns daily total_mcap_usd, daily_change_usd, and daily_change_pct. Source: Orbuc.

Parameters (3)

daysany
start_dateany
end_dateany

orbuc_stablecoin_latest

Get the latest full snapshot of all tracked stablecoins with per-issuer breakdown. Returns each stablecoin's total_supply_usd, issuer, and per-chain deployment data.

No parameters.

orbuc_stablecoin_coin

Get historical supply data for a specific stablecoin. Args: symbol: Stablecoin ticker, e.g. USDT, USDC, DAI (required) days: Number of days of history start_date: Start date YYYY-MM-DD end_date: End date YYYY-MM-DD

Parameters (4)

symbolstring
daysany
start_dateany
end_dateany

orbuc_stablecoin_coin_latest

Get the latest supply data for a specific stablecoin with chain breakdown. Args: symbol: Stablecoin ticker, e.g. USDT, USDC (required)

Parameters (1)

symbolstring

orbuc_stablecoin_aggregate

Get daily aggregate stablecoin data at different levels. level='total': daily total market cap. level='symbol': daily breakdown per stablecoin. level='chain': daily breakdown per chain per symbol.

Parameters (3)

levelany
start_dateany
end_dateany

orbuc_stablecoin_chains

Get stablecoin supply distribution across chains (Ethereum, Tron, Solana, etc.). Args: days: Number of days of history (optional)

Parameters (1)

daysany

orbuc_btc_holdings_current

Get the latest total BTC held by institutions, broken down by segment. Segments: public_companies, etf_funds, governments, private_companies, defi_other, exchanges_custodians.

No parameters.

orbuc_btc_holdings_segments

Get current BTC holdings per segment. Each segment includes btc_amount and source.

No parameters.

orbuc_btc_holdings_daily

Get daily BTC holdings time series, optionally filtered by segment. Args: segment: public_companies, etf_funds, governments, private_companies, defi_other, exchanges_custodians. Omit for aggregate totals. start: Start date YYYY-MM-DD end: End date YYYY-MM-DD

Parameters (3)

segmentany
startany
endany

orbuc_btc_holdings_weekly

Get weekly aggregated BTC holdings, optionally filtered by segment. Args: segment: Segment name (optional)

Parameters (1)

segmentany

orbuc_btc_health

Check health of the BTC holdings tracker. Returns status, database date range, segment count, and record totals.

No parameters.

orbuc_stablecoin_health

Check health of the stablecoin market cap tracker. Returns status, latest date, total market cap, and tracked coins/chains.

No parameters.

README.md6 KBView on GitHub

Orbuc MCP Server

Remote MCP server providing AI agents with direct access to independent on-chain stablecoin market cap and Bitcoin institutional holdings data.

Endpoint: https://mcp.orbuc.io/mcp/orbuc

Protocol: MCP Streamable HTTP (JSON-RPC 2.0 over POST) Authentication: None required (open access) Transport: Stateless HTTP — no session persistence

What is Orbuc?

Orbuc is a digital asset research and investment firm. Orbuc produces its own data, tracking two core datasets independently — no third-party aggregators:

Stablecoin Market Cap — direct on-chain totalSupply() RPC calls across 19 blockchain networks covering 13 stablecoins (USDT, USDC, USDS, DAI, USDe, FDUSD, PYUSD, USD1, BUIDL, BUIDL-I, crvUSD, GHO, FRAX). Updated daily at 03:00 UTC.
Bitcoin Institutional Holdings — compiled from SEC EDGAR 8-K filings, on-chain Etherscan data, and verified public disclosures across 6 segments (ETF funds, public companies, governments, private companies, DeFi/wrapped BTC, exchanges & custodians). Updated daily at 02:00 UTC.

Available Tools (12)

Stablecoin Market Cap

Tool	Description	Parameters
`orbuc_stablecoin_mcap`	Historical daily total stablecoin market cap	`days`, `start_date`, `end_date`
`orbuc_stablecoin_latest`	Latest snapshot — all 13 coins with per-chain breakdown	—
`orbuc_stablecoin_coin`	Historical supply for a specific stablecoin	`symbol`, `days`, `start_date`, `end_date`
`orbuc_stablecoin_coin_latest`	Latest supply for one coin with chain breakdown	`symbol`
`orbuc_stablecoin_aggregate`	Daily aggregate by total, symbol, or chain	`level`, `start_date`, `end_date`
`orbuc_stablecoin_chains`	Supply distribution across chains	`days`

Bitcoin Institutional Holdings

Tool	Description	Parameters
`orbuc_btc_holdings_current`	Latest BTC held by institutions per segment	—
`orbuc_btc_holdings_segments`	Segment breakdown with confidence and sources	—
`orbuc_btc_holdings_daily`	Daily time series, optionally by segment	`segment`, `start_date`, `end_date`
`orbuc_btc_holdings_weekly`	Weekly aggregated holdings	`segment`
`orbuc_btc_health`	BTC tracker health status	—
`orbuc_stablecoin_health`	Stablecoin tracker health status	—

Quick Start

Claude.ai / Claude Desktop

Add as a custom MCP connector:

code

https://mcp.orbuc.io/mcp/orbuc

VS Code / Cursor / Windsurf

Add to .vscode/mcp.json:

json

{
  "servers": {
    "orbuc": {
      "type": "http",
      "url": "https://mcp.orbuc.io/mcp/orbuc"
    }
  }
}

Claude Desktop Config

Add to claude_desktop_config.json:

json

{
  "mcpServers": {
    "orbuc": {
      "type": "url",
      "url": "https://mcp.orbuc.io/mcp/orbuc"
    }
  }
}

Python (MCP SDK)

python

from mcp import ClientSession
from mcp.client.streamable_http import streamablehttp_client

async def query_orbuc():
    async with streamablehttp_client("https://mcp.orbuc.io/mcp/orbuc") as (read, write, _):
        async with ClientSession(read, write) as session:
            await session.initialize()
            tools = await session.list_tools()
            print(f"{len(tools.tools)} tools available")

            result = await session.call_tool("orbuc_btc_holdings_current", {})
            print(result.content[0].text)

cURL

bash

# Initialize
curl -X POST https://mcp.orbuc.io/mcp/orbuc \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}'

# List tools
curl -X POST https://mcp.orbuc.io/mcp/orbuc \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}'

# Call a tool
curl -X POST https://mcp.orbuc.io/mcp/orbuc \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"orbuc_stablecoin_mcap","arguments":{"days":7}}}'

Example Queries

Once connected, ask your AI agent:

"What's the total stablecoin market cap today?"
"Show me USDT supply broken down by chain"
"How much BTC do public companies hold vs ETF funds?"
"What's the daily change in ETF segment BTC holdings over the past two weeks?"
"Compare USDC and USDT market share across Ethereum, Tron, and Solana"
"Which BTC segments have high confidence data vs carry-forward estimates?"

Data Coverage

Stablecoins

Coins: USDT, USDC, USDS, DAI, USDe, FDUSD, PYUSD, USD1, BUIDL, BUIDL-I, crvUSD, GHO, FRAX
Chains: Ethereum, Tron, Solana, Arbitrum, Base, BSC, Polygon, Avalanche, Optimism, TON, Near, Stellar, Sui, Celo, Gnosis, Linea, Mantle, zkSync, Algorand
History from: August 2024
Source: Direct on-chain totalSupply() RPC calls

Bitcoin Holdings

Segments: public_companies, etf_funds, governments, private_companies, defi_other, exchanges_custodians
History from: August 2025
Sources: SEC EDGAR, Etherscan, event detection

x402 Payment Protocol

Orbuc also supports x402 micropayments for autonomous agent access via USDC on Base. The MCP server is currently free and open access — x402 pricing may be introduced in future.

Discovery file: https://orbuc.io/.well-known/x402.json

License

Proprietary. Data provided by Orbuc Research. See data disclaimer for terms of use.

Install

claude_desktop_config.json

{
  "mcpServers": {
    "orbuc": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.orbuc.io/mcp/orbuc"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

orbuc_stablecoin_mcap

orbuc_stablecoin_latest

orbuc_stablecoin_coin

orbuc_stablecoin_coin_latest

orbuc_stablecoin_aggregate

orbuc_stablecoin_chains

orbuc_btc_holdings_current

orbuc_btc_holdings_segments

orbuc_btc_holdings_daily

orbuc_btc_holdings_weekly

orbuc_btc_health

orbuc_stablecoin_health

Orbuc MCP Server

What is Orbuc?

Available Tools (12)

Stablecoin Market Cap

Bitcoin Institutional Holdings

Quick Start

Claude.ai / Claude Desktop

VS Code / Cursor / Windsurf

Claude Desktop Config

Python (MCP SDK)

cURL

Example Queries

Data Coverage

Stablecoins

Bitcoin Holdings

x402 Payment Protocol

Links

License

Install