Prover MCP

Integrates with the Succinct Prover Network to monitor, calibrate, and optimize prover operations.

GitHub

Prover MCP

⚠️ Testnet Only: This MCP is for Sepolia testnet only.

A Model Context Protocol (MCP) server that enables AI assistants to control Succinct Prover Network operations following the official Succinct workflow.

Prerequisites

⚠️ Security Notice: Use only fresh test wallets for Sepolia testnet. Never use mainnet private keys!

Required Software

Required Blockchain Assets

  1. Fresh Ethereum Wallet

    • Create a new wallet (MetaMask, etc.)
    • Get Sepolia ETH from faucet
    • Export private key (64 hex characters, no 0x prefix)

  2. PROVE Tokens

    • Get 1000+ PROVE tokens from official faucet
    • Minimum 1000 PROVE required for staking

🚀 Quick Setup

Installation

git clone https://github.com/d3lta02/prover-mcp.git
cd prover-mcp
npm install
npm run build

Setup Options

Option 1: Interactive Setup (Recommended)

npm run init
# Choose: Interactive Setup
# Select: AI client preference  
# Optional: Add credentials during setup

Option 2: Auto Setup (Fastest)

npm run init
# Choose: Auto Setup
# Automatically configures detected AI clients

Check Prover MCP & You're Ready

npm start

# Succinct Prover Network MCP Server running

Both methods create:

  • 📄 .env file with configuration template
  • 🤖 AI client MCP configurations (Claude/Cursor)
  • 📋 Next steps following official Succinct workflow

Configuration Methods

Method 1: MCP Config (Recommended)

Environment variables are set directly in your AI client's MCP configuration:

Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json Cursor IDE: ~/.cursor/mcp.json

{
  "mcpServers": {
    "succinct-prover": {
      "command": "node",
      "args": ["./build/index.js"],
      "cwd": "/path/to/your/prover-mcp",
      "env": {
        "PROVER_ADDRESS": "your_prover_contract_address",
        "PRIVATE_KEY": "your_64_character_private_key_no_0x_prefix"
      }
    }
  }
}

Method 2: Environment File

Edit the .env file created by setup:

# Edit with your real credentials
PROVER_ADDRESS=0x1234567890123456789012345678901234567890
PRIVATE_KEY=1234567890123456789012345678901234567890123456789012345678901234

💡 Pro Tip: MCP config method bypasses tool cache issues and provides better reliability.

Official Succinct Workflow

The setup follows the official 5-step Succinct workflow:

  1. ✅ Requirements (Automated by setup)

    • Fresh Ethereum wallet with Sepolia ETH
    • 1000+ PROVE tokens from faucet
    • Docker Desktop running

  2. 🏗️ Create Prover Contract (Manual)

  3. 💰 Stake PROVE Tokens (Manual)

  4. ⚙️ Calibrate Hardware (AI Assisted)

    • Command: "Calibrate my prover hardware"

  5. 🚀 Run Prover (AI Assisted)

    • Command: "Run Succinct Prover"

Usage After Setup

Basic Commands

  • 💬 "Run Succinct Prover" - Start the prover and earn PROVE tokens
  • 💬 "Calibrate my prover hardware" - Optimize performance settings
  • 💬 "Show Succinct workflow" - Check setup progress
  • 💬 "Get my prover status" - View current earnings and performance

Advanced Commands

  • 💬 "Get proof requests" - View available proof requests
  • 💬 "Get my account balance" - Check PROVE token balance
  • 💬 "Stop my prover" - Gracefully stop the prover

Manual Terminal Monitoring

For advanced users who want to monitor prover logs directly in terminal:

# Find your container ID
docker ps | grep succinct

# Stream live logs
docker logs -f CONTAINER_ID

# Monitor resource usage  
docker stats CONTAINER_ID

💡 Note: Replace CONTAINER_ID with your actual container ID. The MCP provides smart log viewing, but terminal monitoring offers real-time streaming for power users.

How It Works

The MCP server provides secure access to Succinct Prover Network operations:

  1. Environment Loading: Credentials loaded from MCP config (priority) or .env file
  2. Docker Integration: Official Succinct Docker images with hardware optimization
  3. AI Commands: Natural language interface to prover operations
  4. Security: Sepolia testnet only, credentials never logged

The MCP configuration ensures environment variables are available to all tools, bypassing cache issues.

Troubleshooting

Common Issues

❌ "Environment validation failed"

  • Ensure credentials are set in MCP config or .env file
  • Restart your AI client completely after configuration changes

❌ "Docker not found"

  • Install and start Docker Desktop
  • Verify: docker --version

❌ "Tool cache issues"

  • Use MCP config method instead of .env file
  • MCP config bypasses tool cache limitations

❌ "No PROVE tokens"

Debug Commands

npm run validate  # Validate installation
npm run init      # Re-run setup process
npm test         # Run test suite

Security

🔒 CRITICAL SECURITY NOTES

  • Testnet Only: This MCP only works with Sepolia testnet
  • Fresh Wallets: Use dedicated test wallets, never mainnet wallets
  • Private Keys: Never commit credentials to version control
  • Official Sources: Only use official Succinct URLs and contracts

All credential files are automatically git-ignored for security.

Development

Build

npm run build

Testing

npm test
npm run validate

File Structure

src/
├── index.ts           # MCP server entry point
├── main.ts           # CLI argument handling  
├── cli/init.ts       # Interactive setup tool
├── tools/prover/     # Prover network tools
├── tools/network/    # Network status tools
└── tools/monitoring/ # Performance monitoring

Contributing

  1. Fork the repository
  2. Create feature branch: git checkout -b feature-name
  3. Follow the official Succinct documentation
  4. Test with Sepolia testnet only
  5. Submit pull request

Resources

License

MIT License - See LICENSE file for details.

⚡ Ready to start earning PROVE tokens? Run npm run init and follow the setup!

💡 Important: The cwd (current working directory) parameter is automatically set by npm run init to ensure relative paths work correctly across different installations.

Related Servers