{"id":"f0daf115-9bf7-4980-8e5c-c210254bac87","slug":"casper-network-mcp","kind":"mcp","name":"casper-network-mcp","summary":"Production-ready Model Context Protocol (MCP) server for Casper Network blockchain","owner":"Tairon-ai","repoUrl":"https://github.com/Tairon-ai/casper-network-mcp","license":"MIT","licenseTier":"permissive","trust":"community","stars":3,"match":null,"fewStars":true,"format":"mcp","createdAt":"2025-11-04T10:49:14.000Z","addedAt":"2026-10-21T04:08:01.837Z","logoUrl":"https://avatars.githubusercontent.com/u/229330069?v=4","linkOnly":false,"collection":null,"skillPath":null,"categories":["cloud-infra","data-analytics","memory-knowledge"],"tags":["blockchain","casper","casper-network"],"runtime":"binary","local":true,"cloudCapable":false,"cloudCapability":"unknown","cloudReadyOnPlatform":false,"needsApiKey":false,"reviewed":false,"syncedAt":"2026-10-21T04:08:21.725Z","sample":false,"url":"https://conduits.dev/tools/casper-network-mcp","language":"JavaScript","transports":["stdio"],"install":{},"requirements":{"env":[],"upstreamMayCharge":false},"tools":null,"readme":"<div align=\"center\">\n\n# 🔗 Casper Network MCP Server v0.1.0\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Node Version](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen)](https://nodejs.org)\n[![MCP Protocol](https://img.shields.io/badge/MCP-2024--11--05-blue)](https://modelcontextprotocol.io)\n[![Casper Network](https://img.shields.io/badge/Casper-Mainnet-blue)](https://cspr.live)\n\n**Production-ready Model Context Protocol (MCP) server for Casper Network blockchain**\n\n[Features](#-features) • [Quick Start](#-quick-start) • [Tools](#-available-tools) • [Prompts](#-prompts) • [Security](#-security) • [Contributing](#-contributing)\n\n</div>\n\n---\n\n## 🚀 Features\n\n### 🏗️ **Dual-Server Architecture**\n- HTTP server (Express) for REST API access\n- MCP stdio server for Claude Desktop integration\n- Seamless communication between both servers\n- Process management with graceful shutdown\n- Health monitoring endpoints\n\n### 🛠️ **Professional Structure**\n- Modular tool system with separate tools.js\n- Utility helpers in dedicated utils.js file\n- Clean separation of concerns\n- Easy to extend and maintain\n- Production-tested components\n\n### 🔧 **Developer-Friendly**\n- Simple JSON-RPC interface\n- Comprehensive error handling\n- Environment-based configuration\n- Docker containerization support\n- MCP protocol 2024-11-05 implementation\n- Zero-configuration deployment with sensible defaults\n\n### 🎯 **Casper Network Integration**\n- Wallet creation and management\n- CSPR token transfers\n- Staking and delegation operations\n- Real-time blockchain data from mainnet\n- Curated validator database (50+ top validators)\n- Full integration with Casper JavaScript SDK\n\n---\n\n## 📦 Quick Start\n\n### ✅ Prerequisites\n```bash\n# Required\nNode.js >= 18.0.0\nnpm >= 9.0.0\n\n# Casper Network API Key from cspr.cloud\n# Get your free API key at: https://cspr.cloud\n```\n\n### 🔑 Configuration\n\nCreate a `.env` file with your Casper Network configuration:\n\n- **CASPER_API_KEY:** Your API key from cspr.cloud (required)\n- **CASPER_RPC_URL:** RPC endpoint (default: https://node.cspr.cloud/rpc)\n- **CASPER_NETWORK_NAME:** Network name (default: casper for mainnet)\n- **PORT:** HTTP server port (default: 8080)\n- **CASPER_PRIVATE_KEY:** Optional default wallet private key (PEM format)\n- **CASPER_PUBLIC_KEY:** Optional default wallet public key\n\n### 📥 Installation\n\n```bash\n# Clone the repository\ngit clone https://github.com/Tairon-ai/casper-network-mcp.git\ncd casper-network-mcp\n\n# Install dependencies\nnpm install\n\n# Configure environment\ncp .env.example .env\n# Edit .env and add your CASPER_API_KEY from cspr.cloud\n\n# Start the HTTP server\nnpm start\n\n# MCP stdio server for Claude Desktop\nnpm run mcp\n```\n\n### 🤖 Claude Desktop Integration\n\nAdd to your Claude Desktop configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"casper-network\": {\n      \"command\": \"node\",\n      \"args\": [\"/path/to/casper-network-mcp/mcp/index.js\"],\n      \"env\": {\n        \"CASPER_API_KEY\": \"your_api_key_from_cspr_cloud\",\n        \"CASPER_RPC_URL\": \"https://node.cspr.cloud/rpc\",\n        \"CASPER_NETWORK_NAME\": \"casper\"\n      }\n    }\n  }\n}\n```\n\n> **Note:** Get your API key from https://cspr.cloud for mainnet access\n\n---\n\n## 🛠 Available Tools\n\n### 📋 **Casper Network Blockchain Tools**\n\n| Tool | Description | Parameters | Returns |\n|------|-------------|------------|---------|\n| `create_wallet` | Generate new ED25519 wallet | None | Public key, private key (PEM), account hash |\n| `get_balance` | Check CSPR balance | `publicKey` (optional) | Balance in CSPR and motes |\n| `get_account_info` | Get account details | `publicKey` (optional) | Account hash, keys, thresholds, purse |\n| `transfer_cspr` | Send CSPR tokens | `toPublicKey`, `amount`, `transferId` (opt), `fromPrivateKeyPem` (opt) | Deploy hash, transaction details |\n| `delegate_stake` | Delegate to validator | `validatorPublicKey`, `amount`, `delegatorPrivateKeyPem` (opt) | Deploy hash, staking details |\n| `undelegate_stake` | Undelegate from validator | `validatorPublicKey`, `amount`, `delegatorPrivateKeyPem` (opt) | Deploy hash, unbonding info |\n| `get_staking_rewards` | View staking info | `publicKey` (optional) | Total staked, delegations, validators |\n| `get_validator_info` | Get validator details | `validatorPublicKey` | Name, stake, delegators, commission |\n\n---\n\n## 🤖 Prompts\n\n### 💬 Example Prompts for AI Assistants\n\n**Wallet Management:**\n```\n\"Create a new Casper wallet for me\"\n\"What's my CSPR balance?\"\n\"Check the balance of wallet 01abc123...\"\n\"Show me my Casper account details\"\n```\n\n**Transfers:**\n```\n\"Send 100 CSPR to wallet 01abc123...\"\n\"Transfer 50 CSPR to 01def456... with transfer ID 12345\"\n```\n\n**Staking:**\n```\n\"Delegate 1000 CSPR to validator 012bac...\"\n\"Stake 500 CSPR with Everstake validator\"\n\"Undelegate 500 CSPR from validator 012bac...\"\n\"Show me my staking rewards and delegations\"\n```\n\n**Validator Info:**\n```\n\"Tell me about Everstake validator 012bac...\"\n\"What's the commission rate and total stake of validator 01c377...?\"\n\"Find validators with 0% commission\"\n```\n\n### 🔧 Testing Tools\n\n```bash\n# Test wallet creation\ncurl -X POST http://localhost:8080/mcp \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"jsonrpc\": \"2.0\", \"method\": \"tools/call\", \"params\": {\"name\": \"create_wallet\", \"arguments\": {}}, \"id\": 1}'\n\n# Test balance check\ncurl -X POST http://localhost:8080/mcp \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"jsonrpc\": \"2.0\", \"method\": \"tools/call\", \"params\": {\"name\": \"get_balance\", \"arguments\": {\"publicKey\": \"01abc...\"}}, \"id\": 1}'\n```\n\n---\n\n## 🔒 Security\n\n### 🛡️ Security Best Practices\n\n- **Private Key Protection** - Never commit `.env` files or private keys to version control\n- **Environment Variables** - Store sensitive data (API keys, private keys) in environment variables\n- **API Key Security** - Keep your cspr.cloud API key secure and don't share it\n- **Input Validation** - All public keys and amounts are validated before processing\n- **Mainnet Caution** - This server operates on Casper mainnet with real CSPR tokens\n- **Error Handling** - Errors don't expose sensitive wallet information\n- **Secure Communication** - All RPC calls use HTTPS to cspr.cloud\n\n---\n\n## 🚀 Deployment\n\n### 🏭 Production Deployment\n\n```bash\n# Start production server\nNODE_ENV=production npm start\n\n# With PM2\npm2 start server.js --name casper-mcp\n\n# With Docker\ndocker build -t casper-mcp .\ndocker run -d -p 8080:8080 --env-file .env casper-mcp\n```\n\n### 🔑 Environment Variables\n\n```env\n# Casper Network Configuration\nCASPER_RPC_URL=https://node.cspr.cloud/rpc\nCASPER_API_KEY=your_api_key_from_cspr_cloud\nCASPER_NETWORK_NAME=casper\n\n# Optional: Default Wallet\nCASPER_PRIVATE_KEY=-----BEGIN PRIVATE KEY-----\\n...\\n-----END PRIVATE KEY-----\nCASPER_PUBLIC_KEY=01abc123...\n\n# Server Configuration\nPORT=8080\nNODE_ENV=production\n```\n\n---\n\n## 🤝 Contributing\n\nWe welcome contributions! Please read [CONTRIBUTING.md](CONTRIBUTING.md) for details on our development process.\n\n```bash\n# Fork the repository\ngit clone https://github.com/Tairon-ai/casper-network-mcp.git\n\n# Create feature branch\ngit checkout -b feature/amazing-feature\n\n# Make changes and commit\ngit commit -m 'feat: add amazing feature'\ngit push origin feature/amazing-feature\n\n# Open Pull Request\n```\n\n---\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n---\n\n## 📚 Resources\n\n- [MCP Protocol Specification](https://modelcontextprotocol.io/docs/getting-started/intro)\n- [MCP GitHub Organization](https://github.com/modelcontextprotocol)\n- [Casper Network Documentation](https://docs.casper.network/)\n- [Casper JavaScript SDK](https://docs.casper.network/developers/dapps/sdk/script-sdk/)\n- [cspr.live Explorer](https://cspr.live)\n- [cspr.cloud RPC](https://cspr.cloud)\n- [Express.js Documentation](https://expressjs.com/)\n\n---\n\n<div align=\"center\">\n\n**Built by [Tairon.ai](https://tairon.ai) team with help from Claude**\n\n</div>\n"}