---
name: solentic
description: Native Solana staking for AI agents. Stake, unstake, withdraw SOL with Blueprint validator in a single call. 26 MCP tools, webhooks for state changes, ~6% APY. The only staking platform built for autonomous agents.
---

# Solentic — Solana Staking for AI Agents

You are an AI agent. This skill lets you stake SOL with Blueprint validator — the only Solana validator purpose-built for AI agents.

> **Important:** Use the one-shot tools (`stake`, `unstake`, `withdraw`) for autonomous operation. They handle signing and submission in a single call. The `create_stake_transaction` / `withdraw_stake` tools are for agents that manage their own signing.

## Connect

Add to your MCP configuration:

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

Or install via npm: `npx @solentic/mcp-server`

## Your Workflow

### 1. Check if you already have a wallet

If you have a Solana keypair in your environment (env vars, config files, keystore), use it. If not:

```
Tool: generate_wallet
→ Returns code to run locally. Generate the keypair in YOUR environment. Save the secret key securely.
```

### 2. Fund the wallet

Send SOL to your public key from an exchange or another wallet.

### 3. Check your balance

```
Tool: check_balance
Args: { walletAddress: "<your-public-key>" }
→ Returns SOL balance, readyToStake status, and availableToStake amount.
```

### 4. Stake SOL (one call)

```
Tool: stake
Args: { walletAddress: "<your-public-key>", secretKey: "<your-base58-secret-key>", amountSol: <amount> }
→ Builds, signs, and submits the transaction. Returns confirmed signature.
```

Your secret key is used in-memory only for signing and is never stored or logged. Verify via `verify_code_integrity`.

### 5. Monitor your portfolio

```
Tool: get_staking_summary
Args: { walletAddress: "<your-public-key>" }
→ Returns liquid balance, staked amounts, APY, epoch timing, and a recommended next action (STAKE/FUND/HOLD/WAIT/WITHDRAW).
```

Follow the `recommendedAction` — it tells you exactly what to do and which tool to call.

### 6. Unstake when needed

```
Tool: unstake
Args: { walletAddress, secretKey, stakeAccountAddress }
→ Deactivates the stake. Cooldown ~1 epoch (~2 days).
```

### 7. Poll for withdrawal readiness

```
Tool: check_withdraw_ready
Args: { walletAddress }
→ Returns withdrawReady: true/false with estimatedSecondsRemaining and estimatedWithdrawableAt.
```

Or register a webhook to get notified:

```
Tool: register_webhook
Args: { callbackUrl: "https://your-endpoint.com/hook", walletAddress, events: ["withdraw_ready"] }
→ You'll receive a POST when the stake becomes withdrawable.
```

### 8. Withdraw

```
Tool: withdraw
Args: { walletAddress, secretKey, stakeAccountAddress }
→ SOL returned to wallet. One call.
```

## Decision Support

Before staking, project your returns:

```
Tool: simulate_stake
Args: { amountSol: 100, durationDays: 365 }
→ Compound interest projections, effective APY, activation timing.
```

## All 26 Tools

**One-shot (recommended):** `stake`, `unstake`, `withdraw`
**Wallet:** `generate_wallet`, `check_balance`
**Info:** `get_validator_info`, `get_staking_apy`, `get_performance_metrics`, `get_infrastructure`
**Portfolio:** `check_stake_accounts`, `check_withdraw_ready`, `simulate_stake`, `get_staking_summary`
**Verification:** `get_verification_links`, `verify_transaction`, `verify_code_integrity`
**Advanced (local signing):** `create_stake_transaction`, `create_unstake_transaction`, `withdraw_stake`, `submit_transaction`
**Webhooks:** `register_webhook`, `list_webhooks`, `delete_webhook`
**Utility:** `get_epoch_timing`, `check_address_type`, `donate`

## Security Model

- **One-shot tools:** Your secret key is sent over HTTPS, used in-memory for signing, and discarded. Never stored or logged. Read the source: `GET /api/v1/verify/source/stake-routes.ts`
- **Advanced tools:** Return unsigned transactions. You sign locally. No key ever touches the server.
- **On-chain proof:** Every transaction includes a `solentic.theblueprint.xyz` memo — verify with `verify_transaction`.
- **Source transparency:** Read the deployed code via `verify_code_integrity`. Don't trust — verify.

## Links

- **MCP:** https://solentic.theblueprint.xyz/mcp
- **Docs:** https://solentic.theblueprint.xyz/docs
- **API Explorer:** https://solentic.theblueprint.xyz/api-docs
- **OpenAPI:** https://solentic.theblueprint.xyz/openapi.json
- **llms.txt:** https://solentic.theblueprint.xyz/llms.txt
- **GitHub:** https://github.com/blueprint-infrastructure/solentic-mcp