back to portfolio GitHub
Protocol-Pal
AI Web3 assistant that executes on-chain transactions from natural language.
Problem
DEX UIs are dense — picking pairs, slippage, approvals, gas — every swap is a multi-step ordeal.
Mechanism
An LLM agent (Gemini 2.5 Flash) parses your intent, plans the calls via MCP tools, and executes through Thirdweb / Ethers.
Outcome
Type 'swap 0.01 ETH for USDC' — it routes via Uniswap V2 on Sepolia, handles approvals, and confirms back to you.
How it works
01Natural language
User types an intent in plain English.
02Intent parser
Gemini extracts action, asset, amount, and routes the plan.
03MCP agent
Tools approve tokens, build calldata, simulate the tx.
04On-chain execute
Wallet signs once; the swap lands on Sepolia.
Stack
Next.js 16Gemini 2.5 FlashMCPCloudflare WorkersVercel AI SDKThirdwebEthers.jsUniswap V2
Try it
- 01Open the demo and connect a wallet funded on Sepolia.
- 02Type a command like: "swap 0.01 ETH for USDC".
- 03Approve any required token allowance when the agent prompts.
- 04Sign the swap — the agent confirms execution and shows the tx hash.