For AI Agents

AI Agent Plugins

Give your AI agent access to aggregated flash loans on Solana. One line of code, 65+ tokens, automatic routing across Kamino, Marginfi & Jupiter Lend.

The agent doesn't need to understand Solana transactions, PDAs, or lending protocols. It calls discovery tools, evaluates profitability, and builds atomic transactions — the plugin handles everything else.

// Solana Agent Kit — 1 line integration
import { SolanaAgentKit } from "solana-agent-kit";
import { VaeaFlashPlugin } from "@vaea/solana-agent-kit-plugin";

const agent = new SolanaAgentKit(wallet, RPC_URL, { OPENAI_API_KEY })
  .use(VaeaFlashPlugin());

// Agent now has 5 flash loan tools.
// Ask: "Borrow 1000 SOL and arb across Orca and Raydium"

ℹ️ Note

This documentation is for AI agent developers. For direct bot code, see the SDK docs. For on-chain protocol integration, see CTX.

Choose Your Plugin

	Agent Kit v2	GOAT SDK	MCP Server
Best for	Autonomous agents	Autonomous agents	Chat assistants
Frameworks	ElizaOS, LangChain, Vercel AI	LangChain, Vercel AI, ElizaOS	Claude, Cursor, Windsurf
Install	`npm i @vaea/solana-agent-kit-plugin`	`npm i @vaea/goat-plugin`	`npx @vaea/mcp-server`
Tools	5 core tools	5 core tools	8 tools + 6 resources + 3 prompts
Wallet	Via Agent Kit wallet	Auto-fill from wallet	User provides pubkey
License	MIT	MIT	MIT

💡 Tip

If your agent runs autonomously (no human in the loop), use Agent Kit or GOAT. If it runs inside a chat interface (Claude Desktop, Cursor), use MCP.

Solana Agent Kit v2 Recommended

The leading AI agent framework on Solana. Used by ElizaOS and the Solana Skills registry (where VAEA will be listed).

Installation & Setup

bash

npm install @vaea/solana-agent-kit-plugin

typescript

import { SolanaAgentKit } from "solana-agent-kit";
import { VaeaFlashPlugin } from "@vaea/solana-agent-kit-plugin";

const agent = new SolanaAgentKit(wallet, RPC_URL, { OPENAI_API_KEY })
  .use(VaeaFlashPlugin());

Plugin Architecture

The plugin implements the official Agent Kit v2 Plugin interface. When registered, it injects 5 Action objects into the agent's tool registry. Each action has:

Property	Purpose
`name`	Tool name the LLM calls (e.g. vaea_check_capacity)
`description`	Natural language explanation for the LLM
`similes`	Alternative phrasings — "check liquidity", "how much can I borrow"
`examples`	Few-shot input/output pairs for accurate LLM tool use
`handler`	Async function that calls the VAEA API and returns structured data

Custom API URL

typescript

// Point to a different API (devnet, self-hosted)
const agent = new SolanaAgentKit(wallet, RPC_URL, { OPENAI_API_KEY })
  .use(VaeaFlashPlugin({ apiUrl: "https://devnet-api.vaea.fi" }));

GOAT SDK

Framework-agnostic plugin ecosystem with 200+ plugins. Your agent can combine VAEA flash loans with any other GOAT plugin (Jupiter swap, Raydium LP, etc.) in the same tool set.

Installation

bash

npm install @vaea/goat-plugin @goat-sdk/core

With LangChain

typescript

import { getOnChainTools } from "@goat-sdk/adapter-langchain";
import { solana } from "@goat-sdk/wallet-solana";
import { vaeaFlash } from "@vaea/goat-plugin";

const tools = await getOnChainTools({
  wallet: solana({ connection, keypair }),
  plugins: [vaeaFlash()],
});

// Use tools with LangChain agent
const agent = createToolCallingAgent({ llm, tools, prompt });

With Vercel AI SDK

typescript

import { getOnChainTools } from "@goat-sdk/adapter-vercel-ai";
import { solana } from "@goat-sdk/wallet-solana";
import { vaeaFlash } from "@vaea/goat-plugin";

const tools = await getOnChainTools({
  wallet: solana({ connection, keypair }),
  plugins: [vaeaFlash()],
});

// Use with Vercel AI generateText
const result = await generateText({ model, tools, prompt });

Plugin Architecture

The GOAT plugin extends PluginBase and declares supportsChain("solana"). Each tool uses Zod schemas for input validation — the LLM sees typed, documented parameters.

Feature	Detail
Base class	`PluginBase`
Chain support	`supportsChain("solana")` — Solana only
Wallet auto-fill	Yes — `user_pubkey` injected from wallet
Input validation	Zod schemas (type-safe, documented parameters)
Composable	Combine with Jupiter swap, Raydium LP, etc.

Agent Flow

Every plugin follows the same 4-step flow. The agent calls tools in sequence:

// Discovery → Planning → Validation → Execution
vaea_check_capacity("SOL")  → 245,000 SOL available
vaea_find_best_route("SOL", 1000)  → Marginfi, 2.1 bps
vaea_check_profitability(...)  → net +0.29 SOL ✅
vaea_build_flash_loan(...)  → unsigned TX ready

Security Model

Guarantee	How
No private keys	Plugins never touch keys. They return unsigned transactions.
Read-only discovery	4 of 5 tools are read-only 👁️ Eyes. No state mutation.
User signs	Agent builds TX, user reviews & signs via wallet adapter.
Atomic execution	If repay fails, entire TX reverts. Zero partial execution.
Anti-CPI guard	On-chain program rejects CPI calls — only direct invocation allowed.

Packages

Package	Framework	Install	Type
@vaea/solana-agent-kit-plugin	Agent Kit v2	`npm i @vaea/solana-agent-kit-plugin`	Autonomous
@vaea/goat-plugin	GOAT SDK	`npm i @vaea/goat-plugin`	Autonomous
@vaea/mcp-server	MCP	`npx @vaea/mcp-server`	Interactive

Next Steps

🔧 Plugin Tools

Detailed reference for all 5 tools with examples

⚡ Build Atomic TX

How agents build and execute flash loan transactions

🖥️ MCP Server

Setup for Claude Desktop, Cursor, Windsurf