🤖MCP NATIVE

PotBot for AI Agents

PotBot exposes its entire vault infrastructure as an MCP server. Any AI agent — Claude, GPT, custom — can list vaults, analyze performance, create governance proposals, and configure automation + delegated voting rules.

View MCP Server Source →Explore Vaults

Release Update

@potbot/mcp@0.2.0 is now live on npm with HTTP+SSE+x402 transport support, including two binaries: potbot-mcp (stdio) and potbot-mcp-http (HTTP).

  • • Tag mcp-v0.2.0 published successfully via CI.
  • • npm latest now points to 0.2.0 (versions: 0.1.0, 0.2.0).
  • • Package size increased from 11.5 kB to 81.2 kB due to the new http.ts module.
npm package ↗release tag ↗CI run ↗

Quick Start

1. Install the MCP server

npm install -g @potbot/mcp

2. Add to claude_desktop_config.json

{
  "mcpServers": {
    "potbot": {
      "command": "npx",
      "args": ["-y", "@potbot/mcp"],
      "env": {
        "POTBOT_API_URL": "https://app.potbot.fun",
        "SOLANA_RPC_URL": "https://api.devnet.solana.com",
        "SOLANA_NETWORK": "devnet"
      }
    }
  }
}

3. Ask Claude to interact with vaults

“List all PotBot vaults and show their 30-day returns”
“Find the best SOL yield opportunities under low risk”
“Set up a DCA rule: buy 500 USDC worth of SOL every 24 hours”
“Create a proposal to swap 10% of the vault to JitoSOL for yield”

Available Tools

9 tools covering the full vault lifecycle

list_vaults

List all PotBot Strategy Vaults with performance metrics

Returns: vaults[] with TVL, PnL, APY, members, win rate

get_vault_analytics

Get NAV, PnL, APY, and positions for a vault

Returns: nav_usd, nav_sol, pnl_pct, apy_pct, win_rate, sharpe, members, trades

get_token_prices

Current prices via Jupiter Price API v2

Returns: price_usd per token (with mint + source)

create_swap_proposal

Draft a token-swap governance proposal in a vault

Returns: draft proposal + dApp signing link

vote_on_proposal

Vote YES or NO on a governance proposal

Returns: vote payload + dApp signing link

join_strategy_vault

Join a strategy vault (returns entry-fee details and dApp link)

Returns: entry fee, strategy, current members, vault URL

get_yield_rates

Current DeFi yield rates: Kamino, Marginfi, Drift, Jito

Returns: protocol, APY range, TVL, asset, risk for each opportunity

get_leaderboard

Top performing vaults ranked by a chosen metric

Returns: ranked vaults[] with rank + all performance fields

get_agent_rules

Inspect AI automation rules for a vault

Returns: rules array with triggers, actions, cooldowns

AI Agent Automation

Configure rules that run every 60 seconds. When a trigger fires, the agent creates and can vote on governance actions based on user preferences. By default, members vote manually, but users can enable delegated AI voting in bot settings for predefined decision policies.

Example: Buy SOL when price drops

{
  "id": "rule-1",
  "name": "Buy SOL dip",
  "enabled": true,
  "trigger": {
    "type": "price_below",
    "threshold": 120,
    "token": "So11111111111111111111111111111111111111112"
  },
  "action": {
    "type": "propose_swap",
    "amount": 500,
    "token": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "toToken": "So11111111111111111111111111111111111111112"
  },
  "cooldownMinutes": 240
}

Price Alert

Trigger when SOL/BTC/token hits a threshold

price_below

DCA Timer

Buy on a fixed schedule (hourly, daily, weekly)

time_interval

Take Profit

Propose sell when vault PnL reaches target

pnl_above

Governance Safety

AI agents can act as delegates for governance voting when the user opts in. Users choose manual or delegated mode in bot settings, and all decisions remain transparent on-chain.

🤖

Agent proposes

AI detects opportunity and creates on-chain proposal

🗳️

Vote mode

Manual member voting or delegated AI voting based on user preference

⚡

Jupiter executes

Passed proposals execute via Jupiter swap CPI

Ready to build AI-powered DeFi strategies?

GitHub RepositoryCreate a Vault