Orbuc
On-chain stablecoin market cap and Bitcoin institutional holdings data.
Open source Repository Open in the app JSON README (API)
About
On-chain stablecoin market cap and Bitcoin institutional holdings data.
Details
- Kind
- MCP servers
- Topic
- Finance & crypto
- Publisher
- xorbuc
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 1.0.0
- Last push
- 2026-04-02T10:48:14Z
- Repository state
- ativo
- License
- MIT
- Added
- 2026-08-29 04:01:42
- Updated
- 2026-08-29 04:01:42
- Origin id
io.github.xOrbuc/orbuc
README
# Orbuc MCP Server
<!-- mcp-name: io.github.xorbuc/orbuc -->
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:
```
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](https://x402.org) 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`
---
## Links
- **Website:** [orbuc.io](https://orbuc.io)
- **MCP Endpoint:** `https://mcp.orbuc.io/mcp/orbuc`
- **Health Check:** `https://mcp.orbuc.io/mcp/health`
- **Contact:** info@orbuc.io
---
## License
Proprietary. Data provided by Orbuc Research. See [data disclaimer](https://orbuc.io) for terms of use.