Solentic MCP Server

Standalone Model Context Protocol server for Blueprint Agentic Staking — native Solana staking infrastructure for AI agents.

26 MCP tools wrapping the Blueprint REST API. One-shot tools (stake, unstake, withdraw) handle the full lifecycle in a single call — the secret key is sent to the Blueprint server over HTTPS for in-memory signing and is never stored or logged. Verify via verify_code_integrity. Advanced tools (create_stake_transaction, etc.) return unsigned transactions for agents that prefer local signing.

Tools

Agent-first (one-shot — build + sign + submit in one call):

| Tool | Description | Type | |------|-------------|------| | stake | Stake SOL — one call, confirmed signature returned | Write | | unstake | Deactivate stake — one call, confirmed | Write | | withdraw | Withdraw SOL — one call, confirmed | Write |

Info & monitoring:

| Tool | Description | Type | |------|-------------|------| | get_validator_info | Validator profile, commission, active stake, APY | Read | | get_staking_apy | Live APY breakdown (base + Jito MEV) | Read | | get_performance_metrics | Vote success, uptime, skip rate, epoch credits | Read | | get_infrastructure | Server hardware specs (both servers) | Read | | generate_wallet | Local wallet generation code (JS, Python, CLI) | Read | | check_balance | SOL balance for any wallet | Read | | check_stake_accounts | List stake accounts for a wallet | Read | | check_withdraw_ready | Per-account withdrawal readiness with ETA | Read | | simulate_stake | Project staking rewards with compound interest | Read | | get_staking_summary | Complete portfolio dashboard (single call) | Read | | get_epoch_timing | Current Solana epoch progress and timing | Read | | check_address_type | Detect wallet vs stake account vs vote account | Read |

Verification:

| Tool | Description | Type | |------|-------------|------| | verify_transaction | Verify a transaction was built through Blueprint | Read | | verify_code_integrity | Verify deployed source code integrity | Read | | get_verification_links | Third-party verification URLs | Read |

Advanced (unsigned transaction builders — for local signing):

| Tool | Description | Type | |------|-------------|------| | create_stake_transaction | Build unsigned stake transaction | Write | | create_unstake_transaction | Build unsigned unstake transaction | Write | | withdraw_stake | Build unsigned withdraw transaction | Write | | submit_transaction | Submit a pre-signed transaction to Solana | Write |

Webhooks:

| Tool | Description | Type | |------|-------------|------| | register_webhook | Register push notification for state changes | Write | | list_webhooks | List registered webhooks for a wallet | Read | | delete_webhook | Delete a webhook registration | Write |

Support:

| Tool | Description | Type | |------|-------------|------| | donate | Build unsigned donation transaction | Write |

Quick Start

Claude Desktop / Claude Code

Add to your MCP config:

{
  "mcpServers": {
    "solentic": {
      "url": "https://solentic.theblueprint.xyz/mcp"
    }
  }
}

Run Locally (stdio)

npx @mbrassey/solentic-mcp

Or clone and run:

npm install && npm run build
node dist/server.js

Architecture

Lightweight MCP proxy (stdio transport) that wraps the Blueprint REST API.

• One-shot tools (stake, unstake, withdraw): accept a secret key, forward it to the Blueprint server over HTTPS for in-memory signing. The key is used only for transaction signing on the server and is never stored or logged — verify the source code.
• Advanced tools (create_stake_transaction, etc.): return unsigned transactions. No secret key required — agents sign locally.
• Read tools: no keys involved, purely informational.

AI Agent → MCP Server (stdio) → Blueprint REST API (HTTPS) → Solana

Links

• Live MCP endpoint: https://solentic.theblueprint.xyz/mcp
• API docs: https://solentic.theblueprint.xyz/docs
• API explorer: https://solentic.theblueprint.xyz/api-docs
• OpenAPI spec: https://solentic.theblueprint.xyz/openapi.json
• llms.txt: https://solentic.theblueprint.xyz/llms.txt

License

MIT