Breeze Agent Kit

The Breeze Agent Kit is a comprehensive toolkit that gives AI agents the ability to interact with Solana yield strategies. Deposit, withdraw, check balances, and earn yield — all through a simple interface your agent already understands.

Breeze Agent Kit

Explore the Breeze Agent Kit homepage — overview, supported tokens, and integration paths.

GitHub Repository

Source code, examples, and documentation for the Breeze Agent Kit monorepo.

MCP Server

Connect any MCP-compatible AI client (Claude Desktop, Cursor, etc.) to Breeze in minutes.

x402 Protocol

Pay-per-call API access with automatic USDC micropayments — no API key needed.

Skill

Drop a SKILL.md into your agent framework for instant Breeze capabilities — no server needed.

Examples

Ready-to-run example agents to get you started fast.

Supported Tokens

The Breeze Agent Kit supports yield strategies for the following Solana tokens:

Token	Symbol	Decimals
USD Coin	USDC	6
Tether USD	USDT	6
USDS	USDS	6
Solana	SOL	9
Jito Staked SOL	JitoSOL	9
Marinade Staked SOL	mSOL	9
Jupiter SOL	JupSOL	9
Jupiter Liquidity Provider	JLP	6

Available Tools

Every integration path exposes the same core set of tools to your agent:

get_strategy_info

Retrieves strategy metadata and APY breakdown per asset. Use this to show your users current yield rates before depositing.

check_balances

Views wallet positions, total deposits, and earned yield across all supported tokens.

get_deposit_tx

Generates an unsigned base64-encoded deposit transaction ready for signing.

get_withdraw_tx

Generates an unsigned base64-encoded withdrawal transaction ready for signing.

sign_and_send_tx

Signs a base64 transaction with the configured wallet and broadcasts it to the Solana network.

MCP Integration

The fastest way to connect an AI agent to Breeze. Works with Claude Desktop, Cursor, Windsurf, and any MCP-compatible client.

Prerequisites

Get your API key

Export your wallet key

Export your Solana private key as a base58 string for WALLET_PRIVATE_KEY.

Configuration

Add the following to your MCP client configuration file:

// ~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "breeze": {
      "command": "npx",
      "args": ["-y", "@breezebaby/mcp-server"],
      "env": {
        "BREEZE_API_KEY": "your-api-key",
        "WALLET_PRIVATE_KEY": "your-base58-private-key",
        "SOLANA_RPC_URL": "https://api.mainnet-beta.solana.com"
      }
    }
  }
}

Restart your MCP client after saving the configuration. Your agent will now have access to all Breeze tools.

x402 Integration

The x402 protocol lets your agent access Breeze through a pay-per-call API. Each request is automatically paid for with a ~$0.01 USDC micropayment — no API key required.

x402 uses the Faremeter payment protocol. Your agent sends a request, receives a 402 Payment Required response, automatically pays, and retries — all handled transparently.

All you need is a Solana wallet with a small USDC balance. The agent handles payments automatically through the @faremeter/fetch package.

import { payingFetch } from "@faremeter/fetch";
import { Keypair } from "@solana/web3.js";

const keypair = Keypair.fromSecretKey(/* your key */);

// Every call auto-pays with USDC — no API key needed
const response = await payingFetch(
  "https://x402.breeze.baby/deposit/tx",
  keypair,
  {
    method: "POST",
    body: JSON.stringify({
      strategy_id: "your-strategy-id",
      base_asset: "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      amount: 100,
      user_key: keypair.publicKey.toString(),
    }),
  }
);

Skill Integration

A Skill is a standalone SKILL.md file that teaches any compatible agent framework how to interact with Breeze — no server, no daemon, just a markdown file your agent reads and follows. The Breeze x402 Payment API skill gives your agent the ability to check balances, deposit, withdraw, and sign/send Solana transactions, all paid automatically via x402 USDC micropayments.

Skills work with agent frameworks that support SKILL.md discovery (e.g., Claude Code, custom agent runtimes). The agent reads the skill file, understands the available actions, and executes them autonomously.

How It Works

Add the skill to your project

Copy the SKILL.md file into your project’s skills directory:

mkdir -p skills/breeze-x402-payment-api
cp path/to/SKILL.md skills/breeze-x402-payment-api/SKILL.md

You can find the skill file in the Breeze Agent Kit repo.

Set environment variables

The skill requires a funded Solana wallet and a Breeze strategy ID:

export WALLET_PRIVATE_KEY="your-base58-private-key"
export STRATEGY_ID="your-strategy-id"
# Optional:
export X402_API_URL="https://x402.breeze.baby"
export SOLANA_RPC_URL="https://api.mainnet-beta.solana.com"

Ask your agent

The agent auto-discovers the skill and handles the rest:

“Check my Breeze balances”
“Deposit 10 USDC into Breeze”
“Withdraw 5 USDC from Breeze”

What the Skill Covers

The SKILL.md contains everything the agent needs:

API endpoint contracts — balance, deposit, and withdraw with full request/response specs
Payment setup — x402 payment-wrapped fetch configuration using @faremeter/fetch
Transaction signing — versioned and legacy Solana transaction handling
Workflow checklists — step-by-step instructions for balance, deposit, and withdraw flows
Error handling — HTTP status codes, transaction failures, and security rules
Supported tokens — full mint address and decimal reference table

The skill uses x402 micropayments (~$0.01 USDC per call) so no Breeze API key is needed — just a funded Solana wallet.

Examples

The Breeze Agent Kit repo includes four ready-to-run example agents. Each example is a standalone project with its own package.json and README.

Agent via MCP Server

A Claude-powered agent that talks to Breeze through the MCP server over stdio. Supports interactive and single-shot modes.

Agent via Direct SDK

A Claude-powered agent that uses the Breeze SDK directly — no MCP server needed. Simpler architecture with all blockchain logic embedded.

x402 Script

A standalone script demonstrating deposit, withdraw, and balance checks through the x402 payment-gated API with automatic USDC micropayments.

Agent via x402 API

A Claude tool-calling agent that interacts with Breeze over the x402 API. Each call auto-pays with USDC — no API key required.

Running an Example

# Clone the repo
git clone https://github.com/anagrambuild/breeze-agent-kit.git
cd breeze-agent-kit

# Install dependencies
bun install

# Navigate to an example
cd apps/examples/agent-using-breeze-mcp-server

# Copy the env file and fill in your keys
cp .env.example .env

# Run the agent
bun run start

Breeze Agent Kit

Breeze Agent Kit

Breeze Agent Kit

Breeze Agent Kit

GitHub Repository

MCP Server

x402 Protocol

Skill

Examples

Supported Tokens

Available Tools

MCP Integration

Prerequisites

Configuration

x402 Integration

Skill Integration

How It Works

What the Skill Covers

Examples

Agent via MCP Server

Agent via Direct SDK

x402 Script

Agent via x402 API

Running an Example

Resources

GitHub Repository

Try Breeze

Get API Key

Breeze Agent Kit

​Breeze Agent Kit

Breeze Agent Kit

GitHub Repository

MCP Server

x402 Protocol

Skill

Examples

​Supported Tokens

​Available Tools

​MCP Integration

​Prerequisites

​Configuration

​x402 Integration

​Skill Integration

​How It Works

​What the Skill Covers

​Examples

Agent via MCP Server

Agent via Direct SDK

x402 Script

Agent via x402 API

​Running an Example

​Resources

GitHub Repository

Try Breeze

Get API Key

Breeze Agent Kit

Supported Tokens

Available Tools

MCP Integration

Prerequisites

Configuration

x402 Integration

Skill Integration

How It Works

What the Skill Covers

Examples

Running an Example

Resources