BitSage MCP Server

MCP (Model Context Protocol) server that enables LLMs like Claude to interact with the BitSage Network for distributed compute operations.

Features

• Job Management: Submit, monitor, and cancel compute jobs
• Worker Discovery: List and inspect available compute workers
• Proof Verification: Verify ZK proofs on-chain
• Staking: Stake SAGE tokens and claim rewards
• Faucet: Claim testnet tokens (Sepolia only)
• Network Stats: Monitor network health and utilization

Installation

npm install @bitsage/mcp-server

Or run directly with npx:

npx @bitsage/mcp-server

Configuration

Set environment variables:

# API endpoint (optional, defaults to production)
export BITSAGE_API_URL=https://api.bitsage.network

# Starknet RPC (optional)
export STARKNET_RPC_URL=https://starknet-sepolia.public.blastapi.io

# Network: mainnet or sepolia (optional, defaults to sepolia)
export BITSAGE_NETWORK=sepolia

Usage with Claude Desktop

Add to your Claude Desktop configuration (~/.claude/claude_desktop_config.json):

{
  "mcpServers": {
    "bitsage": {
      "command": "npx",
      "args": ["@bitsage/mcp-server"],
      "env": {
        "BITSAGE_NETWORK": "sepolia"
      }
    }
  }
}

Available Tools

Job Management

| Tool | Description | |------|-------------| | bitsage_submit_job | Submit a compute job (AI inference, ZK proof, etc.) | | bitsage_get_job_status | Get current status of a job | | bitsage_cancel_job | Cancel a pending or running job | | bitsage_list_jobs | List jobs with optional status filter |

Worker Management

| Tool | Description | |------|-------------| | bitsage_list_workers | List available compute workers | | bitsage_get_worker | Get details about a specific worker |

Proof Verification

| Tool | Description | |------|-------------| | bitsage_get_proof | Get proof details by hash | | bitsage_verify_proof | Verify a proof on-chain |

Staking

| Tool | Description | |------|-------------| | bitsage_stake | Stake SAGE tokens | | bitsage_unstake | Unstake SAGE tokens | | bitsage_claim_rewards | Claim staking rewards | | bitsage_get_stake_info | Get staking info for an address |

Faucet (Testnet only)

| Tool | Description | |------|-------------| | bitsage_faucet_claim | Claim testnet SAGE tokens | | bitsage_faucet_status | Check faucet cooldown status |

ZKML Proving & Verification

| Tool | Description | |------|-------------| | bitsage_submit_zkml_proof | Submit a ZKML proving job (model must be loaded on prover) | | bitsage_get_zkml_proof_status | Poll proving job status and progress | | bitsage_get_zkml_proof_result | Get completed proof (calldata, commitments, gas estimate) | | bitsage_verify_zkml_onchain | Check on-chain verification status for a proof or model |

Network

| Tool | Description | |------|-------------| | bitsage_network_stats | Get network statistics |

ZKML Configuration

The ZKML tools connect to a prove-server instance (see libs/stwo-ml/) and the on-chain verifier contract.

# Prover server URL (default: http://localhost:8080)
export BITSAGE_PROVER_URL=http://your-gpu-server:8080

# On-chain verifier contract (default: deployed v3 on Sepolia)
export ZKML_VERIFIER_ADDRESS=0x048070fbd531a0192f3d4a37eb019ae3174600cae15e08c737982fae5d929160

Example Interactions

Submit an AI Inference Job

User: Submit an AI inference job using llama-7b model with my prompt "What is the capital of France?"

Claude: I'll submit that job for you.
[Uses bitsage_submit_job tool]

The job has been submitted successfully:
- Job ID: abc123-def456
- Status: pending
- Estimated cost: 50 SAGE tokens

Check Network Status

User: How many workers are available on the BitSage network?

Claude: Let me check the network stats.
[Uses bitsage_network_stats tool]

The BitSage network currently has:
- Total workers: 150
- Active workers: 89
- Worker utilization: 59.3%
- Jobs in progress: 42
- Total jobs completed: 15,234

Prove and Verify ML Inference

User: Prove the model 0xabc123 and check if it verifies on-chain.

Claude: I'll submit a proving job and track it.
[Uses bitsage_submit_zkml_proof with model_id: "0xabc123", gpu: true]

Proving job submitted:
- Job ID: d4e5f6a7-...
- Status: queued

[Uses bitsage_get_zkml_proof_status with job_id: "d4e5f6a7-..."]

Proof completed in 40.5s:
- 160 matmul sumcheck proofs
- 40 layers proven
- ~350,000 estimated gas
- 2,847 calldata felts

[Uses bitsage_verify_zkml_onchain with model_id: "0xabc123"]

On-chain status:
- Verification count: 3
- Weight commitment: 0x7f2a...

Development

# Install dependencies
npm install

# Build
npm run build

# Run in development
npm run dev

License

MIT