{
  "markdown": "# BittensorMCP\n\n> Live, self-custodial Bittensor chain access for AI agents via MCP.\n\n[![Endpoint](https://img.shields.io/badge/endpoint-bittensormcp.com-blue)](https://bittensormcp.com)\n[![SDK](https://img.shields.io/npm/v/@bittensormcp/sign)](https://www.npmjs.com/package/@bittensormcp/sign)\n\n## What is BittensorMCP?\n\n**BittensorMCP** is a hosted [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server that gives AI agents live access to the Bittensor blockchain. Connect any MCP client — Claude, Cursor, ChatGPT, VS Code, Windsurf, Zed, Codex — and query balances, subnets, metagraphs, validators, and Alpha prices in real time.\n\n- **Free reads**: 17 tools, no signup, no API key\n- **Premium writes**: 17 on-chain actions (stake, transfer, register, weights) via self-custodial signing\n- **One endpoint**: `https://bittensormcp.com/api/mcp` with Streamable HTTP transport\n\n## Why self-custodial?\n\nYour **private key never leaves your device**.\n\nBittensorMCP uses an A2 two-step signing protocol: the server returns an `UNSIGNED_PAYLOAD` plus `intent_id`, you sign it locally with your sr25519 key, and only the signature goes back. The server broadcasts the signed extrinsic — it never sees, stores, or handles your private key.\n\n```\n┌─────────────┐      unsigned payload       ┌─────────────┐\n│   Your Key  │  <───────────────────────   │  Bittensor  │\n│  (local)    │      sign locally           │    MCP      │\n│             │  ───────────────────────>   │   Server    │\n└─────────────┘      signature only         └──────┬──────┘\n                                                   │\n                                            broadcast to\n                                                   ▼\n                                            ┌─────────────┐\n                                            │  Bittensor  │\n                                            │   Finney    │\n                                            └─────────────┘\n```\n\n## Quick start\n\n### 1. Install the SDK\n\n```bash\nnpm install @bittensormcp/sign\n```\n\n### 2. Authenticate (self-custody)\n\n```javascript\nimport { generateWallet, authenticate } from '@bittensormcp/sign';\n\nconst wallet = await generateWallet();\nconst { token } = await authenticate({\n  endpoint: 'https://bittensormcp.com',\n  ss58: wallet.ss58,\n  signer: wallet.sign\n});\n```\n\n### 3. Connect your MCP client\n\n**Claude Code:**\n```bash\nclaude mcp add --transport http bittensormcp \\\n  https://bittensormcp.com/api/mcp \\\n  --header \"Authorization: Bearer YOUR_JWT\"\n```\n\n**Claude Desktop / Cursor / VS Code:**\n```json\n{\n  \"mcpServers\": {\n    \"bittensormcp\": {\n      \"url\": \"https://bittensormcp.com/api/mcp\",\n      \"headers\": { \"Authorization\": \"Bearer YOUR_JWT\" }\n    }\n  }\n}\n```\n\n**Clients without native Streamable HTTP:**\n```json\n{\n  \"mcpServers\": {\n    \"bittensormcp\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"mcp-remote\",\n        \"https://bittensormcp.com/api/mcp\",\n        \"--header\", \"Authorization:${AUTH_HEADER}\"\n      ],\n      \"env\": { \"AUTH_HEADER\": \"Bearer YOUR_JWT\" }\n    }\n  }\n}\n```\n\nFor step-by-step connection instructions for every client, see the [Connect Guide](CONNECT.md).\n\n## Tools at a glance\n\n| Category | Count | Examples |\n|----------|-------|----------|\n| **Free reads** | 17 | `bittensor_balance`, `bittensor_account`, `bittensor_subnet_list`, `bittensor_subnet_metagraph`, `bittensor_validators`, `bittensor_dynamic`, `bittensor_swap_sim`, `bittensor_block` |\n| **Premium writes** | 17 | `bittensor_stake_add`, `bittensor_stake_remove`, `bittensor_transfer`, `bittensor_register`, `bittensor_weights_set`, `bittensor_subnet_register`, `bittensor_root_register` |\n\nAll write tools use the A2 self-custody signing flow. Premium activation requires sending TAO to the treasury address (check `bittensor_premium_status` for the current rate).\n\n## License\n\nMIT\n",
  "bytes": 3850,
  "sha": "717753466419cd771380add8bbe046bba771d1446173549f37f963c8882d231d",
  "repo_slug": "btmcp/pub",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_btmcp_bittensormcp_5efaaa8b/readme"
}