check_address_type
Detect whether a Solana address is a wallet, stake account, or vote account. Useful when you receive an address from user input.
LABSCO SUMMARY
One call to stake, or three if you would rather hold the key.
Solana staking from an agent normally means building, signing and submitting a transaction yourself. Both paths are here: a single confirmed call where Blueprint signs in memory, or unsigned transactions you sign locally. Everything else — APY, readiness, projections, verification — reads around those two paths.
What it is
A standalone MCP server wrapping the Blueprint REST API for Solana staking with the Blueprint validator. One-shot tools run the whole lifecycle in a single call; advanced tools return unsigned transactions for agents that would rather sign locally.
What you get
- Staking, deactivation and withdrawal each as a single confirmed call
- The same three operations as unsigned transactions instead, signed locally and submitted separately
- Validator profile, live APY split into base and Jito MEV, vote success and uptime, and the server hardware behind it
- Portfolio state: liquid balance, stake accounts with their states, per-account withdrawal readiness with an estimated epoch, and a single-call summary
- Rewards projected before capital is committed, and current epoch progress
- Verification you can act on: a transaction checked for the Blueprint marker on chain, the deployed code's git commit hash, and third-party validator listings
- Webhooks for stake-state changes such as withdrawal readiness, registered, listed and deleted
- A standing Autopilot policy that stakes idle SOL automatically, readable and revocable
Requirements
A Solana wallet. The one-shot tools send the secret key to the Blueprint server over HTTPS for in-memory signing; the vendor states it is never stored or logged, and verify_code_integrity returns the commit hash of the code doing it. Agents that will not send a key use create_stake_transaction, create_unstake_transaction and withdraw_stake with submit_transaction instead. generate_wallet returns code to create the keypair in your own environment rather than doing it server-side.
Setup effort
One command — npx -y @solentic/mcp-server
USE CASES
01
Putting idle SOL to work
Check the live APY split and project the return first, then stake in one confirmed call.
02
Staking without handing over a key
Build the transaction unsigned, verify it only delegates to Blueprint with your wallet as authority, then sign locally and submit.
03
Seeing where your stake stands
One call for the portfolio, or per-account detail when a specific stake account is in question.
04
Getting SOL back out
Deactivate, check which accounts are actually withdrawable and when, then withdraw.
05
Being told when something changes instead of polling
Register a callback URL for events such as withdraw_ready, and clear it when you are done.
06
Deciding whether to trust the validator
Read commission, active stake and performance, then check the commit hash of the code actually running.
30 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
check_balance
Check the SOL balance of any Solana wallet address. Returns balance in SOL, ready-to-stake status, and next steps.
check_stake_accounts
List all stake accounts delegated to Blueprint for a wallet. Shows balances, states, stateDescription, authorities, epoch timing, and per-account action guidance.
check_withdraw_ready
Check whether stake accounts are ready to withdraw. Returns per-account readiness with withdrawable epoch, estimated seconds remaining, and plain-English state description. Use this instead of polling check_stake_accounts.
create_stake_transaction
Advanced: Build an unsigned stake transaction for local signing. Most agents should use the stake tool instead.
create_unstake_transaction
Advanced: Build an unsigned unstake transaction for local signing. Most agents should use the unstake tool instead.
delete_staking_policy
Delete a wallet's Autopilot policy. Sign exactly: "solentic-autopilot-delete:v1\nwallet=<walletAddress>\nnonce=<nonce>" (nonce exceeds the current policy nonce) and pass the base58 signature.
delete_webhook
Delete a webhook registration by ID. Use list_webhooks to find IDs.
donate
Build an unsigned SOL transfer to support Blueprint development. Same zero-custody pattern. Suggested: 0.01 SOL (thank you), 0.1 SOL (generous), 1 SOL (patron).
generate_wallet
Get instructions and code to generate a Solana wallet locally. Generate the keypair in YOUR environment. After generating, fund the wallet, then use the stake tool with your walletAddress + secretKey to stake in one call.
get_epoch_timing
Get current Solana epoch timing: progress percentage, slots remaining, and estimated epoch end time.
get_infrastructure
Get Blueprint validator infrastructure specs: server hardware, redundancy configuration, network, and storage. Two bare-metal servers (active + hot standby).
get_performance_metrics
Get Blueprint validator performance: vote success rate, uptime, skip rate, epoch credits, delinquency status.
get_staking_apy
Get live APY breakdown: base staking APY + Jito MEV APY = total APY. Includes commission rates.
get_staking_policy
Read the current Autopilot policy for a wallet (or null if none).
get_staking_summary
Complete staking portfolio dashboard in a single call. Returns liquid balance, total staked, per-account states, APY, epoch timing, and recommended next action (STAKE/FUND/HOLD/WAIT/WITHDRAW).
get_validator_info
Get Blueprint validator profile: identity, vote account, commission, active stake, APY, performance, software, location. Live data from StakeWiz API.
get_verification_links
Get third-party verification URLs for Blueprint validator on Validators.app, StakeWiz, Solana Beach, Solscan, and Jito.
list_webhooks
List all registered webhooks for a wallet address.
register_webhook
Register a callback URL to receive push notifications when stake state changes. Events: withdraw_ready, epoch_complete, stake_activated, stake_deactivated. Polls every 60s. Returns an HMAC secret for signature verification.
set_staking_policy
Hand Solentic a standing, signature-bound policy so it automatically stakes your IDLE SOL with Blueprint, zero custody. Sign the policy ONCE with your wallet key (Ed25519, NEVER your secret key). When idle SOL above keepLiquidSol exceeds minSweepSol, Solentic builds an UNSIGNED stake transaction and POSTs it to your callbackUrl to sign and submit. Amounts in the signed message are INTEGER LAMPORTS = round(SOL*1e9). Sign exactly: "solentic-autopilot-policy:v1 wallet=<walletAddress> keepLiquidLamports=<round(keepLiquidSol*1e9)> minSweepLamports=<round(minSweepSol*1e9)> callbackUrl=<callbackUrl> paused=<true|false> nonce=<nonce>". nonce strictly increases.
simulate_stake
Project staking rewards before committing capital. Returns compound interest projections, effective APY, activation timing, fee reserve guidance, and a recommendation.
stake
Stake SOL with Blueprint validator in a single call. Your secret key is sent to the Blueprint server over HTTPS, used in-memory for signing, and discarded — never stored or logged. Returns the confirmed transaction signature. Verify via verify_code_integrity. This is the recommended tool for autonomous agents.
submit_transaction
Advanced: Submit a pre-signed transaction to Solana. Only needed with create_stake_transaction/create_unstake_transaction/withdraw_stake. Most agents should use the one-shot stake/unstake/withdraw tools instead.
unstake
Deactivate a stake account in a single call. Secret key sent over HTTPS for in-memory signing, never stored. Cooldown ~1 epoch. Use check_withdraw_ready to poll, then withdraw.
verify_code_integrity
Verify the code running on Blueprint servers. Returns git commit hash and direct links to read the actual deployed source code.
verify_stake_transaction
Deterministically verify a built stake transaction only delegates to Blueprint with your wallet as both stake and withdraw authority. The fully trustless path is the @solentic/verify npm package run client-side before signing.
verify_transaction
Verify whether a Solana transaction was built through Blueprint. Checks on-chain for the "solentic.theblueprint.xyz" Memo — cryptographic proof.
withdraw
Withdraw SOL from a deactivated stake account in a single call. Secret key sent over HTTPS for in-memory signing, never stored. Use check_withdraw_ready first. Omit amountSol for full balance.
withdraw_stake
Advanced: Build an unsigned withdraw transaction for local signing. Most agents should use the withdraw tool instead.
BEFORE YOU INSTALL
What to know first
Tools you get
30 tools when we connected.
Requires
npx on PATH
CONTEXT COST
Moderate Standing cost
Rated by the size of the 30 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Add the block to your client, or run the command directly.
Server setup
Configuration file
JSON
{
"mcpServers": {
"solentic": {
"command": "npx",
"args": [
"-y",
"@solentic/mcp-server"
]
}
}
}npx
TERMINAL
npx -y @solentic/mcp-server
