Skip to content

blueprint-infrastructure/solentic-mcp

Repository files navigation

Solentic MCP Server

Solentic MCP server

smithery badge

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

License

MIT

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors