Uniswap AI skill
Official Uniswap skills and plugins: swap integration, v4 hooks, liquidity planning and trading bots for an agent
- 235 ★ on the repository
- Last commit
- MIT
Broad access
Why this level
- The skills build and broadcast transactions with real funds, and a sent transaction cannot be undone
- The work sits next to wallet keys and accounts, which must not be shown to the agent in plain form
- The bots run on a schedule and repeat purchases until you stop them
Install
- Works in
Manual install
npx skills add Uniswap/uniswap-aiWorks for any agent.
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- The skills build and broadcast transactions with real funds, and a sent transaction cannot be undone
- The work sits next to wallet keys and accounts, which must not be shown to the agent in plain form
- The bots run on a schedule and repeat purchases until you stop them
This is third-party code. Review the repository files before installing.
What it does
Uniswap AI is a set of plugins with skills for developers building on the Uniswap protocol. Seven plugins are grouped by task: `uniswap-hooks` guides v4 hook development, `uniswap-trading` integrates swaps through the Trading API, Universal Router or SDKs plus HTTP 402 payments, `uniswap-cca` configures and launches CCA auctions, `uniswap-driver` plans swaps and liquidity, `uniswap-viem` is a reference for viem and wagmi, and `uniswap-permissioned-pools` works with v4 permissioned pools. A separate plugin, `uniswap-trading-tools`, holds trading strategies. `dca-bot` buys a fixed amount of a token on a schedule, `index-bot` builds and rebalances a basket of assets, and `copy-trade` mirrors a given wallet's trades within limits. The strategies do not execute trades themselves: the quote, confirmation and signature go through the `swap-integration` and `viem-integration` skills. By default the `confirm` mode asks you to approve every transaction, while `autonomous` mode is allowed only with a spend cap, a token allowlist, a dry run and a kill switch.
Who it is for. Developers of decentralized apps and bots on Uniswap who write code with Claude Code, Cursor or Codex.
Good fit when
- A swap is being added to an app and you need a ready flow of approval check, quote and transaction broadcast
- A v4 pool hook is being written and the agent needs vetted security practices and a scaffold generator
- A liquidity position is being planned and you want to compare options before any transaction is sent
- A DCA bot is needed that buys a fixed amount of a token every day and skips a buy on a price condition
- A service pays HTTP 402 requests with tokens through a Uniswap swap
Not a fit when
- You need to trade on a centralized exchange: the catalog has separate official kits for OKX and Binance
- You need read-only analytics of EVM networks: a general EVM MCP server fits better than strategies that sign
- You want ready trading advice: the authors publish development tools, not financial recommendations
Example request
Add a USDC to ETH swap to our backend through the Trading API and show the quote before signingLimitations
The skills work only with Uniswap. The `dca-bot` and `copy-trade` bots require the `uniswap-trading` and `uniswap-viem` plugins and have no scheduler of their own: cron or the agent's mechanism must run them on a schedule. The target network comes from a chain template, and the reference documents a Robinhood Chain example. The authors ship the tools as is, with no warranty and no legal, financial or tax advice, and the user is responsible for laws and sanctions restrictions.
How to disable. Remove a plugin with `/plugin uninstall uniswap-trading` and likewise for the others. If you installed through `npx skills`, delete the skill folders from the agent's directory. A bot's state file, such as a JSON with the block cursor, stays in the project and is removed by hand.
FAQ
Which plugin integrates a swap into an app?
`uniswap-trading`: the `swap-integration` skill covers the Trading API, Universal Router and SDK routes. If the project has no account and signing code yet, add `uniswap-viem`, since `swap-integration` assumes viem basics.
How do the bots know when to act?
They have no scheduler: cron or the agent's wake mechanism calls the skill on a schedule. Each run reads the state file, decides whether it is time to act and records the outcome, so repeated wakes within one period are safe.
What does autonomous mode do?
It executes trades without asking per transaction, but only with a spend cap per run and per period, a token allowlist, a dry run and a kill switch. Without all four conditions use `confirm`, which is the default.
What happens when funds run short?
The skill skips the action and reports it. It never auto-funds, bridges or swaps from another asset: funding is described in the chain template and stays with the operator.
How does copy-trade differ from simply following a wallet?
It watches the leader wallet's trades about every five minutes and mirrors them on your wallet only within the limits you set. ETH and WETH count as one asset when matching the allowlist.
Discussion
No questions or reviews yet.
Related
SkillsSkills for crypto agents: wallets, token swaps, onchain data and protocols such as Uniswap, Base, Alchemy and Zerion, each installed on its own
A skill connects agents to FinLab data and its Python engine for stock research and local historical strategy backtesting.
Coinbase's official skill: sign-in, balance, transfers and token swaps through the awal CLI on Base, Polygon and Solana.
A skill builds a Swapper funding link for a wallet or protocol, leaving payment and transaction confirmation to the user.
Official Binance skills for agents: Spot and Futures through binance-cli, fiat, P2P, an on-chain wallet, signals and token data
The Minara skill gives an agent the crypto market in plain language: wallet, token swaps, Hyperliquid perps, limit orders and market analytics
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Authentication | Repository stars | Main difference |
|---|---|---|---|---|
| Uniswap AI (this card) | yes | 235 | ||
| EVM MCP Server | no | key is optional | 379 | a general MCP server for EVM networks that reads blocks and signs with a key, while Uniswap AI gives ready flows for the Uniswap protocol itself |
| OKX Agent Trade Kit | yes | API key | 509 | a kit for the centralized OKX exchange with orders and bots, while Uniswap AI trades in decentralized pools |
README in short
The README briefly calls the project a set of skills, plugins and agents for integrating with Uniswap, gives install commands through `npx skills` and the Claude Code marketplace, lists seven plugins and six featured skills and links to an overview and a getting-started guide. It ends with the MIT license and a legal usage disclaimer.
README badge
Original SKILL.md
--- name: swap-integration description: Integrate Uniswap swaps into applications. Use when user says "integrate swaps", "uniswap", "trading api", "add swap functionality", "build a swap frontend", "create a swap script", "smart contract swap integration", "use Universal Router", "Trading API", or mentions swapping tokens via Uniswap. allowed-tools: Read, Write, Edit, Glob, Grep, Bash(npm:*), Bash(npx:*), Bash(yarn:*), Bash(curl:*), WebFetch, AskUserQuestion, Task(subagent_type:swap-integration-expert) model: opus license: MIT metadata: author: uniswap version: '1.6.0' --- # Swap Integration Integrate Uniswap swaps into frontends, backends, and smart contracts. ## Prerequisites This skill assumes familiarity with viem basics (client setup, account management, contract interactions, transaction signing). Install the **uniswap-viem** plugin for comprehensive viem/wagmi guidance: `claude plugin add @uniswap/uniswap-viem` ## Quick Decision Guide | Building... | Use This Method | | ------------------------------ | ----------------------------- | | Frontend with React/Next.js | Trading API | | Backend script or bot | Trading API | | Smart contract integration | Universal Router direct calls | | Need full control over routing | Universal Router SDK | ### Routing Types Quick Reference | Type | Description | Chains | | -------- | --------------------------------------- | ---------------------------------- | | CLASSIC | Standard AMM swap through Uniswap pools | All supported chains | | DUTCH_V2 | UniswapX Dutch auction V2 | Ethereum, Arbitrum, Base, Unichain | | PRIORITY | MEV-protected priority order | Base, Unichain | | WRAP | ETH to WETH conversion | All | | UNWRAP | WETH to ETH conversion | All | See [Routing Types](#routing-types) for the complete list including DUTCH_V3, DUTCH_LIMIT, LIMIT_ORDER, BRIDGE, and QUICKROUTE. ## Integration Methods ### 1. Trading API (Recommended) Best for: Frontends, backends, scripts. Handles routing optimization automatically.