Blueprint Agentic Staking (Solentic)

io.github.blueprint-infrastructure由 GitHub 帳號 blueprint-infrastructure 發布v1.2.0更新於 Oct 24, 2026

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

發布方自己的服務:agentic.no

已驗證Streamable HTTP可網頁執行金融安全與監控

概覽

AI 產生的概覽

給 AI 助理的 Solana 質押伺服器:透過 Blueprint 驗證節點質押、解除質押與提取 SOL,並提供唯讀質押資料與驗證工具。

可以做什麼
一次呼叫完成 SOL 質押、解除質押與提取,由伺服器負責簽章與送出;也可產生未簽章交易,自行在本機簽章後送出。查詢錢包餘額、質押帳戶、可提取狀態、地址類型與 epoch 時間。讀取驗證節點資料、APY 組成、效能指標與基礎設施規格。模擬質押收益,並取得含建議下一步操作的投資組合摘要。驗證交易與已部署程式碼,並取得第三方驗證連結。註冊、列出與刪除質押狀態變化的 webhook,以及設定、讀取或刪除常駐質押策略。
適用情境
適合讓助理端對端管理 Blueprint 驗證節點的 Solana 質押,或希望在對話中直接取得質押資料、收益預測與鏈上驗證資訊。進階的未簽章交易工具適合把簽章金鑰保留在本機的情境。
執行需求
可作為遠端端點執行,也可作為本機 npm 套件透過 stdio 執行,本機使用需要 Node.js。唯讀工具需要 Solana 錢包地址;一次性質押、解除質押與提取工具需要錢包私鑰,策略工具需要錢包簽章。需要存取 Blueprint API 與 Solana 的網路。
安裝前請注意
一次性質押、解除質押與提取工具會把錢包私鑰透過 HTTPS 傳送到 Blueprint 伺服器進行記憶體簽章;README 稱不會儲存或記錄,但這仍是需要衡量的託管風險,未簽章交易工具可避免此問題。質押、解除質押與提取會動用真實資金並產生網路手續費,解除質押的 SOL 約需一個 epoch 才能提取。註冊 webhook 會把回呼網址傳送給伺服器,donate 工具會建立真實的 SOL 轉帳。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Blueprint Agentic Staking (Solentic),將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.blueprint-infrastructure%2Fsolentic/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "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

來源:README.md,提交 f546926

工具

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.

輸入參數amountSol必填secretKey必填walletAddress必填

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.

輸入參數secretKey必填walletAddress必填stakeAccountAddress必填

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.

輸入參數amountSolsecretKey必填walletAddress必填stakeAccountAddress必填

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.

無需輸入參數。

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.

無需輸入參數。

get_performance_metrics

Get Performance Metrics

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

無需輸入參數。

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.

輸入參數amountSol必填walletAddress必填

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.

輸入參數walletAddress必填stakeAccountAddress必填

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.

輸入參數amountSolwalletAddress必填stakeAccountAddress必填

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.

輸入參數walletAddress必填

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.

輸入參數walletAddress必填

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.

無需輸入參數。

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.

輸入參數walletAddress必填

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.

輸入參數signedTransaction必填

get_infrastructure

Get Infrastructure

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

無需輸入參數。

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.

輸入參數signature必填

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.

無需輸入參數。

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.

輸入參數amountSol必填durationDays

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.

輸入參數walletAddress必填

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

輸入參數amountSol必填walletAddress必填

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.

無需輸入參數。

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.

輸入參數address必填

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.

輸入參數urlevents必填callbackUrlwalletAddress必填

list_webhooks

List Webhooks

List all registered webhooks for a wallet address.

輸入參數walletAddress必填

delete_webhook

Delete Webhook

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

輸入參數webhookId必填walletAddress必填

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.

輸入參數nonce必填pausedsignature必填callbackUrl必填minSweepSol必填keepLiquidSol必填walletAddress必填

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.

輸入參數walletAddress必填

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.

輸入參數nonce必填signature必填walletAddress必填

版本歷史

1
  1. v1.2.0最新Sep 16, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

其他 Agentic 整合