{
  "markdown": "# Orbuc MCP Server\n\n<!-- mcp-name: io.github.xorbuc/orbuc -->\n\nRemote MCP server providing AI agents with direct access to independent on-chain stablecoin market cap and Bitcoin institutional holdings data.\n\n**Endpoint:** `https://mcp.orbuc.io/mcp/orbuc`\n\n**Protocol:** MCP Streamable HTTP (JSON-RPC 2.0 over POST)\n**Authentication:** None required (open access)\n**Transport:** Stateless HTTP — no session persistence\n\n---\n\n## What is Orbuc?\n\nOrbuc is a digital asset research and investment firm. Orbuc produces its own data, tracking two core datasets independently — no third-party aggregators:\n\n- **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.\n\n- **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.\n\n---\n\n## Available Tools (12)\n\n### Stablecoin Market Cap\n\n| Tool | Description | Parameters |\n|------|-------------|------------|\n| `orbuc_stablecoin_mcap` | Historical daily total stablecoin market cap | `days`, `start_date`, `end_date` |\n| `orbuc_stablecoin_latest` | Latest snapshot — all 13 coins with per-chain breakdown | — |\n| `orbuc_stablecoin_coin` | Historical supply for a specific stablecoin | `symbol`, `days`, `start_date`, `end_date` |\n| `orbuc_stablecoin_coin_latest` | Latest supply for one coin with chain breakdown | `symbol` |\n| `orbuc_stablecoin_aggregate` | Daily aggregate by total, symbol, or chain | `level`, `start_date`, `end_date` |\n| `orbuc_stablecoin_chains` | Supply distribution across chains | `days` |\n\n### Bitcoin Institutional Holdings\n\n| Tool | Description | Parameters |\n|------|-------------|------------|\n| `orbuc_btc_holdings_current` | Latest BTC held by institutions per segment | — |\n| `orbuc_btc_holdings_segments` | Segment breakdown with confidence and sources | — |\n| `orbuc_btc_holdings_daily` | Daily time series, optionally by segment | `segment`, `start_date`, `end_date` |\n| `orbuc_btc_holdings_weekly` | Weekly aggregated holdings | `segment` |\n| `orbuc_btc_health` | BTC tracker health status | — |\n| `orbuc_stablecoin_health` | Stablecoin tracker health status | — |\n\n---\n\n## Quick Start\n\n### Claude.ai / Claude Desktop\n\nAdd as a custom MCP connector:\n```\nhttps://mcp.orbuc.io/mcp/orbuc\n```\n\n### VS Code / Cursor / Windsurf\n\nAdd to `.vscode/mcp.json`:\n```json\n{\n  \"servers\": {\n    \"orbuc\": {\n      \"type\": \"http\",\n      \"url\": \"https://mcp.orbuc.io/mcp/orbuc\"\n    }\n  }\n}\n```\n\n### Claude Desktop Config\n\nAdd to `claude_desktop_config.json`:\n```json\n{\n  \"mcpServers\": {\n    \"orbuc\": {\n      \"type\": \"url\",\n      \"url\": \"https://mcp.orbuc.io/mcp/orbuc\"\n    }\n  }\n}\n```\n\n### Python (MCP SDK)\n\n```python\nfrom mcp import ClientSession\nfrom mcp.client.streamable_http import streamablehttp_client\n\nasync def query_orbuc():\n    async with streamablehttp_client(\"https://mcp.orbuc.io/mcp/orbuc\") as (read, write, _):\n        async with ClientSession(read, write) as session:\n            await session.initialize()\n            tools = await session.list_tools()\n            print(f\"{len(tools.tools)} tools available\")\n\n            result = await session.call_tool(\"orbuc_btc_holdings_current\", {})\n            print(result.content[0].text)\n```\n\n### cURL\n\n```bash\n# Initialize\ncurl -X POST https://mcp.orbuc.io/mcp/orbuc \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"initialize\",\"params\":{\"protocolVersion\":\"2024-11-05\",\"capabilities\":{},\"clientInfo\":{\"name\":\"test\",\"version\":\"1.0\"}}}'\n\n# List tools\ncurl -X POST https://mcp.orbuc.io/mcp/orbuc \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"jsonrpc\":\"2.0\",\"id\":2,\"method\":\"tools/list\",\"params\":{}}'\n\n# Call a tool\ncurl -X POST https://mcp.orbuc.io/mcp/orbuc \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"jsonrpc\":\"2.0\",\"id\":3,\"method\":\"tools/call\",\"params\":{\"name\":\"orbuc_stablecoin_mcap\",\"arguments\":{\"days\":7}}}'\n```\n\n---\n\n## Example Queries\n\nOnce connected, ask your AI agent:\n\n- *\"What's the total stablecoin market cap today?\"*\n- *\"Show me USDT supply broken down by chain\"*\n- *\"How much BTC do public companies hold vs ETF funds?\"*\n- *\"What's the daily change in ETF segment BTC holdings over the past two weeks?\"*\n- *\"Compare USDC and USDT market share across Ethereum, Tron, and Solana\"*\n- *\"Which BTC segments have high confidence data vs carry-forward estimates?\"*\n\n---\n\n## Data Coverage\n\n### Stablecoins\n- **Coins:** USDT, USDC, USDS, DAI, USDe, FDUSD, PYUSD, USD1, BUIDL, BUIDL-I, crvUSD, GHO, FRAX\n- **Chains:** Ethereum, Tron, Solana, Arbitrum, Base, BSC, Polygon, Avalanche, Optimism, TON, Near, Stellar, Sui, Celo, Gnosis, Linea, Mantle, zkSync, Algorand\n- **History from:** August 2024\n- **Source:** Direct on-chain `totalSupply()` RPC calls\n\n### Bitcoin Holdings\n- **Segments:** public_companies, etf_funds, governments, private_companies, defi_other, exchanges_custodians\n- **History from:** August 2025\n- **Sources:** SEC EDGAR, Etherscan, event detection\n\n---\n\n## x402 Payment Protocol\n\nOrbuc 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.\n\nDiscovery file: `https://orbuc.io/.well-known/x402.json`\n\n---\n\n## Links\n\n- **Website:** [orbuc.io](https://orbuc.io)\n- **MCP Endpoint:** `https://mcp.orbuc.io/mcp/orbuc`\n- **Health Check:** `https://mcp.orbuc.io/mcp/health`\n- **Contact:** info@orbuc.io\n\n---\n\n## License\n\nProprietary. Data provided by Orbuc Research. See [data disclaimer](https://orbuc.io) for terms of use.\n",
  "bytes": 5850,
  "sha": "f0b0578c17656c946a348373ac76126e012faa32c2a600dae19cb64ea082fecf",
  "repo_slug": "xorbuc/orbuc-mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_xorbuc_orbuc_4c792a99/readme"
}