pancakeswap-ai

PancakeSwap-specific AI tools (skills, plugins, agents) for developers and AI agents integrating the PancakeSwap ecosystem.

Quick Start

# Claude Code plugin marketplace
/plugin marketplace add pancakeswap/pancakeswap-ai

# Install individual plugins
/plugin install pancakeswap-driver    # Swap & liquidity planning + deep links
/plugin install pancakeswap-farming   # Farming planner

Once installed, just ask your agent:

Swap 0.1 BNB for USDT on PancakeSwap

The agent will read the skill, pick the right integration method, generate working TypeScript, and—if configured—execute the swap autonomously.

Plugins

Plugin	Skill	What it does
pancakeswap-driver	swap-planner	Discover tokens, verify contracts, fetch prices, generate swap deep links
pancakeswap-driver	liquidity-planner	Plan LP positions (V2, V3, StableSwap), assess pools, generate liquidity deep links
pancakeswap-farming	farming-planner	Plan yield farming, CAKE staking, and reward harvesting with deep links

Agent execution model

User: "Swap 0.1 BNB for USDT"
        │
        ▼
[PLAN]  swap-planner skill      → generates deep link for UI confirmation
        │
        ▼
[PLAN]  liquidity-planner skill → plans LP ranges and deep links

Supported Chains

Chain	V2	V3	Infinity	Infinity Stable	StableSwap
BNB Smart Chain (56)	✅	✅	✅	✅	✅
Ethereum (1)	✅	✅	—	—	✅
Arbitrum One (42161)	✅	✅	—	—	✅
Base (8453)	✅	✅	✅	—	—
zkSync Era (324)	✅	✅	—	—	—
Linea (59144)	✅	✅	—	—	—
opBNB (204)	✅	✅	—	—	—
Monad (143)	✅	✅	—	—	—

Documentation

Document	Description
CLAUDE.md / AGENTS.md	Full project guidelines, plugin structure, development setup
swap-planner SKILL.md	Token discovery, price fetching, deep link generation
liquidity-planner SKILL.md	LP position planning (V2, V3, StableSwap) with pool assessment and deep links
farming-planner SKILL.md	Yield farming, CAKE staking, farm discovery with live APR

Testing

# Unit tests (31 tests — helpers, slippage math, address validation)
npm test

# LLM evals (requires ANTHROPIC_API_KEY)
export ANTHROPIC_API_KEY=your-key
npm run test:evals:swap-planner
npm run test:evals:liquidity-planner     # LP position planning evals
npm run test:evals:farming-planner       # farming planning evals
npx promptfoo view                    # browse results in browser

Testnet tip: Get free BSC testnet BNB at https://testnet.bnbchain.org/faucet-smart

Development

Requirements

• Node.js >= 22.x
• npm >= 11.7.0

Setup

git clone https://github.com/pancakeswap/pancakeswap-ai.git
cd pancakeswap-ai
npm install

Adding a plugin

1. Create packages/plugins/your-plugin-name/
2. Add .claude-plugin/plugin.json with skill declarations
3. Add skills/your-skill/SKILL.md with YAML frontmatter
4. Register in .claude-plugin/marketplace.json
5. Run node scripts/validate-plugin.cjs
6. Add an eval suite under evals/suites/your-skill/

See CLAUDE.md for the full contribution guide.

Eval quality bar

PRs should maintain ≥ 85% pass rate on all eval suites.

Resources

• Developer docs: https://developer.pancakeswap.finance/
• PancakeSwap app: https://pancakeswap.finance/
• Smart Router SDK: @pancakeswap/smart-router
• Universal Router SDK: @pancakeswap/universal-router-sdk
• BSCScan: https://bscscan.com/

Contributing

See CLAUDE.md for development setup, skill authoring guidelines, and contribution steps.

License

MIT License — see LICENSE for details.