Native Solana staking for AI agents. 26 MCP tools, one-shot signing, webhooks.
Enable Solana staking for AI agents with signing and webhook integration.
Captured live from the server via tools/list.
stake
Stake SOL with Blueprint validator in a single call. Builds the transaction, signs it with your secret key in-memory, and submits to Solana. Returns the confirmed transaction signature. Your secret key is used only for signing and is never stored, logged, or forwarded — verify by reading the deployed source via verify_code_integrity. This is the recommended tool for autonomous agents.
Parameters (3)
walletAddressstringrequired
Your Solana wallet address (base58 public key)
secretKeystringrequired
Your base58-encoded secret key — used in-memory for signing only, never stored
amountSolnumberrequired
Amount of SOL to stake
unstake
Deactivate a stake account in a single call. Builds the transaction, signs it, and submits it. The stake enters a cooldown period (~1 epoch) and becomes withdrawable at the next epoch boundary. Use check_withdraw_ready to poll readiness, then withdraw to reclaim SOL. This is the recommended tool — use create_unstake_transaction only if you manage your own signing.
Parameters (3)
walletAddressstringrequired
Your Solana wallet address (stake authority)
secretKeystringrequired
Your base58-encoded secret key — used in-memory for signing only, never stored
stakeAccountAddressstringrequired
Stake account address to deactivate
withdraw
Withdraw SOL from a deactivated stake account in a single call. Builds the transaction, signs it, and submits it. Funds are returned to your wallet. Use check_withdraw_ready first to confirm the account is ready. Omit amountSol to withdraw the full balance. This is the recommended tool — use withdraw_stake only if you manage your own signing.
Parameters (4)
walletAddressstringrequired
Your Solana wallet address (withdraw authority)
secretKeystringrequired
Your base58-encoded secret key — used in-memory for signing only, never stored
stakeAccountAddressstringrequired
Deactivated stake account to withdraw from
amountSolany
Amount to withdraw in SOL (omit to withdraw full balance)
get_validator_info
Get Blueprint validator profile: identity, vote account, commission, active stake, APY, performance, software, location. Live data from StakeWiz API.
No parameters.
get_staking_apy
Get live APY breakdown: base staking APY + Jito MEV APY = total APY. Includes commission rates. Data from StakeWiz API.
Advanced: Build an unsigned stake transaction for local signing. Most agents should use the `stake` tool instead, which handles signing and submission automatically. This tool is for agents that manage their own signing infrastructure.
Parameters (2)
walletAddressstringrequired
Solana wallet address (base58 public key) that will fund and control the stake
amountSolnumberrequired
Amount of SOL to stake (minimum 0.00228288 SOL for rent exemption)
create_unstake_transaction
Advanced: Build an unsigned unstake transaction for local signing. Most agents should use the `unstake` tool instead, which handles signing and submission automatically.
Parameters (2)
walletAddressstringrequired
Wallet address that is the stake authority
stakeAccountAddressstringrequired
Stake account address to deactivate
withdraw_stake
Advanced: Build an unsigned withdraw transaction for local signing. Most agents should use the `withdraw` tool instead, which handles signing and submission automatically.
Parameters (3)
walletAddressstringrequired
Wallet address that is the withdraw authority
stakeAccountAddressstringrequired
Deactivated stake account to withdraw from
amountSolany
Amount to withdraw in SOL (omit or null to withdraw full balance)
check_stake_accounts
List all stake accounts delegated to Blueprint for a wallet. Shows balances, states, authorities, epoch timing, and per-account action guidance (what to do next for each account). Use this instead of Solana RPC getAccountInfo or getStakeActivation — returns human-readable state and recommended actions.
Parameters (1)
walletAddressstringrequired
Wallet address to check for Blueprint stake accounts
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 — gives a direct ready/not-ready answer with ETA.
Parameters (1)
walletAddressstringrequired
Wallet address to check withdrawal readiness for
get_verification_links
Get third-party verification URLs for Blueprint validator on Validators.app, StakeWiz, Solana Beach, Solscan, JPool, SVT.one, and Jito steward dashboard. Verify every claim independently. Also includes Solana CLI commands for direct on-chain verification.
No parameters.
generate_wallet
Returns runnable code that creates a Solana keypair. Solentic cannot generate the keypair for you and never sees the private key — generation must happen wherever you run code (the agent process, a code-interpreter tool, a Python/Node sandbox, the user's shell). The response includes the snippet ready to execute. After running it, fund the resulting publicKey and call the `stake` tool with {walletAddress, secretKey, amountSol} to stake in one call.
No parameters.
check_balance
Check the SOL balance of any Solana wallet address. Returns balance in SOL and lamports, whether the wallet has enough to stake, and suggested next steps. Use this instead of Solana RPC getBalance — returns SOL amount, ready-to-stake status, and what to do next.
Parameters (1)
walletAddressstringrequired
Solana wallet address (base58 public key) to check balance for
submit_transaction
Advanced: Submit a pre-signed transaction to Solana. Only needed if you used create_stake_transaction/create_unstake_transaction/withdraw_stake and signed locally. Most agents should use the one-shot stake/unstake/withdraw tools instead.
Parameters (1)
signedTransactionstringrequired
Fully signed transaction as a base64-encoded string
get_infrastructure
Get Blueprint validator infrastructure specs: server hardware, redundancy configuration, network, and storage. Two bare-metal servers (redundant HA).
No parameters.
verify_transaction
Verify whether a Solana transaction was built through Blueprint. Checks the transaction on-chain for the "solentic.theblueprint.xyz" Memo Program instruction. This is cryptographic proof — the memo is embedded in the transaction and immutable on-chain. Use this to verify any claim that a stake was placed through Blueprint. Returns verified: true/false with the on-chain evidence.
Parameters (1)
signaturestringrequired
Solana transaction signature to verify
verify_code_integrity
Verify the code running on Blueprint servers. Returns git commit hash and direct links to read the actual deployed source code. Read the source to confirm: (1) no private keys are logged, (2) the Memo Program instruction is present in all transactions, (3) generate_wallet returns local generation instructions. Don't trust — read the code yourself via the source endpoints.
No parameters.
simulate_stake
Project staking rewards before committing capital. Returns reward projections (daily/monthly/annual/total), effective APY (equal to the stated APY, since total_apy is already an annual yield), activation timing, fee reserve guidance, and a natural-language recommendation. Use this to help decide how much to stake and for how long.
Parameters (2)
amountSolnumberrequired
Amount of SOL to simulate staking
durationDaysinteger
Projection duration in days (default: 365)
get_staking_summary
Complete staking portfolio dashboard in a single call. Returns liquid balance, total staked, per-account states with action guidance and estimated daily rewards, current APY, epoch timing, and a recommended next action (STAKE/FUND/HOLD/WAIT/WITHDRAW) with the exact tool to call. Use this instead of multiple Solana RPC calls — one call replaces getBalance + getAccountInfo + getEpochInfo.
Parameters (1)
walletAddressstringrequired
Solana wallet address (base58 public key) to get staking summary for
donate
Build an unsigned SOL transfer to support Blueprint development. Blueprint provides free staking infrastructure for AI agents — donations help sustain enterprise hardware and development. Same zero-custody pattern: unsigned transaction returned, you sign client-side. Suggested amounts: 0.01 SOL (thank you), 0.1 SOL (generous), 1 SOL (patron).
Parameters (2)
walletAddressstringrequired
Wallet address to donate from
amountSolnumberrequired
Amount of SOL to donate (minimum 0.001 SOL)
get_epoch_timing
Get current Solana epoch timing: progress percentage, slots remaining, and estimated epoch end time. Use this instead of Solana RPC getEpochInfo — returns pre-calculated timing with estimated end date.
No parameters.
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 and need to know what type it is before calling other tools.
Parameters (1)
addressstringrequired
Solana address (base58 public key) to identify
register_webhook
Register a callback URL to receive push notifications when stake state changes. Events: withdraw_ready (stake account becomes withdrawable), epoch_complete (new epoch starts), stake_activated (stake begins earning), stake_deactivated (unstake confirmed). Solentic polls every 60 seconds and POSTs to your URL when events fire.
Parameters (4)
callbackUrlstring
HTTPS callback URL to receive webhook POST requests
urlstring
Alias for callbackUrl — either field works
walletAddressstringrequired
Wallet address to monitor for state changes
eventsarrayrequired
Event types to subscribe to
list_webhooks
List all registered webhooks for a wallet address.
Parameters (1)
walletAddressstringrequired
Wallet address to list webhooks for
delete_webhook
Delete a webhook registration by ID. Use list_webhooks to find webhook IDs.
Parameters (2)
webhookIdstringrequired
Webhook registration ID to delete
walletAddressstringrequired
Wallet that owns the webhook (required — prevents deleting another wallet's webhooks)
set_staking_policy
Hand Solentic a standing, signature-bound policy so it automatically stakes your IDLE SOL with Blueprint — zero custody. You sign the policy ONCE with your wallet key (Ed25519 over the exact canonical message below — NEVER your secret key). When idle SOL above keepLiquidSol exceeds minSweepSol, Solentic builds an UNSIGNED stake transaction and POSTs it to your callbackUrl for you to sign and submit; Solentic never holds your key. Native Solana stake already auto-compounds, so delegated rewards keep earning automatically. Amounts in the signed message are INTEGER LAMPORTS = round(SOL * 1e9), so there is no float ambiguity. Sign EXACTLY this newline-separated message, then pass the base58 signature: "solentic-autopilot-policy:v1\nwallet=<walletAddress>\nkeepLiquidLamports=<round(keepLiquidSol*1e9)>\nminSweepLamports=<round(minSweepSol*1e9)>\ncallbackUrl=<callbackUrl>\npaused=<true|false>\nnonce=<nonce>". nonce must strictly increase on each update.
Parameters (7)
walletAddressstringrequired
Wallet whose idle SOL is managed
keepLiquidSolnumberrequired
SOL to always keep liquid (not staked)
minSweepSolnumberrequired
Only stake when idle surplus is at least this many SOL
callbackUrlstringrequired
HTTPS URL to receive unsigned stake transactions
pausedboolean
If true, the policy is stored but inactive
nonceintegerrequired
Strictly increasing replay guard
signaturestringrequired
base58 Ed25519 signature over the canonical policy message
get_staking_policy
Read the current Autopilot policy for a wallet (or null if none). Shows keepLiquidSol, minSweepSol, paused, nonce, and the last epoch a sweep was delivered.
Parameters (1)
walletAddressstringrequired
Wallet address
delete_staking_policy
Remove a wallet's Autopilot policy. Sign EXACTLY this newline-separated message and pass the base58 signature: "solentic-autopilot-delete:v1\nwallet=<walletAddress>\nnonce=<nonce>". nonce must exceed the current policy nonce.
Parameters (3)
walletAddressstringrequired
Wallet address
nonceintegerrequired
Strictly increasing replay guard
signaturestringrequired
base58 Ed25519 signature over the canonical delete message
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):
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.