Blueprint Agentic Staking (Solentic)

io.github.blueprint-infrastructurePublished by GitHub account blueprint-infrastructurev1.2.0Updated Oct 24, 2026

Native Solana staking for AI agents. 26 MCP tools, one-shot signing, webhooks.

The publisher's own server: agentic.no

VerifiedStreamable HTTPWeb executableFinanceSecurity & Monitoring

Overview

AI-generated overview

Solana staking server for AI agents: stake, unstake and withdraw SOL with the Blueprint validator, plus read-only staking data and verification tools.

What you can do
Stake, unstake and withdraw SOL in one call, with signing and submission handled by the server, or build unsigned transactions for local signing and submit them yourself. Check wallet balances, stake accounts, withdrawal readiness, address types and epoch timing. Read validator profile, APY breakdown, performance metrics and infrastructure specs. Simulate staking rewards and get a portfolio summary with a recommended next action. Verify transactions and deployed code, and get third-party verification links. Register, list and delete webhooks for stake state changes, and set, read or delete a standing staking policy.
When to use it
Use it when an assistant should manage Solana staking with the Blueprint validator end to end, or when you want staking data, reward projections and on-chain verification without leaving the chat. The advanced unsigned-transaction tools suit setups that keep signing keys local.
Requirements
Runs as a remote endpoint or as a local npm package over stdio, so Node.js is needed for local use. A Solana wallet address is needed for read tools; the one-shot stake, unstake and withdraw tools require a wallet secret key, and the policy tools require a wallet signature. Network access to the Blueprint API and Solana is required.
Before you install
The one-shot stake, unstake and withdraw tools send your wallet secret key to the Blueprint server over HTTPS for in-memory signing; the README says it is not stored or logged, but this is a custody risk you should weigh, and the unsigned-transaction tools avoid it. Staking, unstaking and withdrawing move real funds and incur network fees, and unstaked SOL is locked for about one epoch. Webhook registration sends a callback URL to the server, and the donate tool builds a real SOL transfer.

Installation

In SourceWeft

  1. Open Blueprint Agentic Staking (Solentic) in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.blueprint-infrastructure%2Fsolentic/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "blueprint-agentic-staking-solentic": {
      "type": "http",
      "url": "https://solentic.theblueprint.xyz/mcp"
    }
  }
}

README

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):

ToolDescriptionType
stakeStake SOL — one call, confirmed signature returnedWrite
unstakeDeactivate stake — one call, confirmedWrite
withdrawWithdraw SOL — one call, confirmedWrite

Info & monitoring:

ToolDescriptionType
get_validator_infoValidator profile, commission, active stake, APYRead
get_staking_apyLive APY breakdown (base + Jito MEV)Read
get_performance_metricsVote success, uptime, skip rate, epoch creditsRead
get_infrastructureServer hardware specs (both servers)Read
generate_walletLocal wallet generation code (JS, Python, CLI)Read
check_balanceSOL balance for any walletRead
check_stake_accountsList stake accounts for a walletRead
check_withdraw_readyPer-account withdrawal readiness with ETARead
simulate_stakeProject staking rewards with compound interestRead
get_staking_summaryComplete portfolio dashboard (single call)Read
get_epoch_timingCurrent Solana epoch progress and timingRead
check_address_typeDetect wallet vs stake account vs vote accountRead

Verification:

ToolDescriptionType
verify_transactionVerify a transaction was built through BlueprintRead
verify_code_integrityVerify deployed source code integrityRead
get_verification_linksThird-party verification URLsRead

Advanced (unsigned transaction builders — for local signing):

ToolDescriptionType
create_stake_transactionBuild unsigned stake transactionWrite
create_unstake_transactionBuild unsigned unstake transactionWrite
withdraw_stakeBuild unsigned withdraw transactionWrite
submit_transactionSubmit a pre-signed transaction to SolanaWrite

Webhooks:

ToolDescriptionType
register_webhookRegister push notification for state changesWrite
list_webhooksList registered webhooks for a walletRead
delete_webhookDelete a webhook registrationWrite

Support:

ToolDescriptionType
donateBuild unsigned donation transactionWrite

Quick Start

Claude Desktop / Claude Code

Add to your MCP config:

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

Run Locally (stdio)

bash
npx @mbrassey/solentic-mcp

Or clone and run:

bash
npm install && npm run buildnode 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

Source: README.md at commit f546926

Tools

29

stake

Stake SOL (one-shot)

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.

ParametersamountSolrequiredsecretKeyrequiredwalletAddressrequired

unstake

Unstake SOL (one-shot)

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.

ParameterssecretKeyrequiredwalletAddressrequiredstakeAccountAddressrequired

withdraw

Withdraw SOL (one-shot)

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.

ParametersamountSolsecretKeyrequiredwalletAddressrequiredstakeAccountAddressrequired

get_validator_info

Get Validator Info

Get Blueprint validator profile: identity, vote account, commission, active stake, APY, performance, software, location. Live data from StakeWiz API.

Takes no parameters.

get_staking_apy

Get Staking APY

Get live APY breakdown: base staking APY + Jito MEV APY = total APY. Includes commission rates. Data from StakeWiz API.

Takes no parameters.

get_performance_metrics

Get Performance Metrics

Get Blueprint validator performance: vote success rate, uptime, skip rate, epoch credits, delinquency status.

Takes no parameters.

create_stake_transaction

Create Stake Transaction

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.

ParametersamountSolrequiredwalletAddressrequired

create_unstake_transaction

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.

ParameterswalletAddressrequiredstakeAccountAddressrequired

withdraw_stake

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.

ParametersamountSolwalletAddressrequiredstakeAccountAddressrequired

check_stake_accounts

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.

ParameterswalletAddressrequired

check_withdraw_ready

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.

ParameterswalletAddressrequired

generate_wallet

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.

Takes no parameters.

check_balance

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.

ParameterswalletAddressrequired

submit_transaction

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.

ParameterssignedTransactionrequired

get_infrastructure

Get Infrastructure

Get Blueprint validator infrastructure specs: server hardware, redundancy configuration, network, and storage. Two bare-metal servers (redundant HA).

Takes no parameters.

verify_transaction

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.

Parameterssignaturerequired

verify_code_integrity

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.

Takes no parameters.

simulate_stake

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.

ParametersamountSolrequireddurationDays

get_staking_summary

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.

ParameterswalletAddressrequired

donate

Donate to Blueprint

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).

ParametersamountSolrequiredwalletAddressrequired

get_epoch_timing

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.

Takes no parameters.

check_address_type

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.

Parametersaddressrequired

register_webhook

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.

ParametersurleventsrequiredcallbackUrlwalletAddressrequired

list_webhooks

List Webhooks

List all registered webhooks for a wallet address.

ParameterswalletAddressrequired

delete_webhook

Delete Webhook

Delete a webhook registration by ID. Use list_webhooks to find webhook IDs.

ParameterswebhookIdrequiredwalletAddressrequired

set_staking_policy

Set Autopilot 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.

ParametersnoncerequiredpausedsignaturerequiredcallbackUrlrequiredminSweepSolrequiredkeepLiquidSolrequiredwalletAddressrequired

get_staking_policy

Get Autopilot 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.

ParameterswalletAddressrequired

delete_staking_policy

Delete Autopilot 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.

ParametersnoncerequiredsignaturerequiredwalletAddressrequired

Version history

1
  1. v1.2.0LatestSep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Agentic integrations