Uniswap Universal Router Decoder — Claude Code MCP server guide
Uniswap Universal Router Decoder — an MCP server to decode and encode Uniswap Universal Router calldata. Operates purely in read-only mode without signing transactions.
MIT ★ 277 updated 2026-10-29
claude mcp add --env RPC_URL=<RPC_URL> --transport stdio uniswap-universal-router-decoder -- uvx uniswap-universal-router-decoderWhat Uniswap Universal Router Decoder does
The server inspects calldata targeted at Uniswap Universal Router contracts on Ethereum and compatible networks. It translates raw input bytes into readable JSON structures and reconstructs raw payload bytes directly from decoded parameter representations.
Every tool exposed by the server carries read-only annotations, allowing agents to execute lookups without approval prompts. Not every router command supports calldata reconstruction via MCP: tools flag supported entries with a rebuildable property before attempting encoding.
What it helps with
- decode complex Uniswap Universal Router transactions into plain JSON
- reconstruct raw calldata payloads directly from decoded parameters
- encode Uniswap V3 swap paths using encode_v3_path
Example prompts for the agent
- Decode this Universal Router transaction input: 0x...
- List all supported router commands and their schemas using list_commands
- Encode a V3 swap path for the given token addresses and fee tiers
How to install Uniswap Universal Router Decoder
Platform CLI
claude mcp add --env RPC_URL=<RPC_URL> --transport stdio uniswap-universal-router-decoder -- uvx uniswap-universal-router-decoderReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from uniswap-universal-router-decoder <command>
Platform CLI
codex mcp add uniswap-universal-router-decoder --env RPC_URL=<RPC_URL> -- uvx uniswap-universal-router-decoderReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from uniswap-universal-router-decoder <command>
Config file
{
"mcpServers": {
"uniswap-universal-router-decoder": {
"command": "uvx",
"args": [
"uniswap-universal-router-decoder"
],
"env": {
"RPC_URL": "<RPC_URL>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from uniswap-universal-router-decoder <command>
Config file
{
"servers": {
"uniswap-universal-router-decoder": {
"type": "stdio",
"command": "uvx",
"args": [
"uniswap-universal-router-decoder"
],
"env": {
"RPC_URL": "<RPC_URL>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from uniswap-universal-router-decoder <command>
Platform CLI
gemini mcp add -e RPC_URL=<RPC_URL> uniswap-universal-router-decoder uvx uniswap-universal-router-decoderReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from uniswap-universal-router-decoder <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Uniswap Universal Router Decoder
How to install Uniswap Universal Router Decoder in Claude Code?
Run claude mcp add uniswap-universal-router-decoder -- uvx uniswap-universal-router-decoder. If you need custom node access, run claude mcp add --env RPC_URL=<RPC_URL> --transport stdio uniswap-universal-router-decoder -- uvx uniswap-universal-router-decoder instead.
Can this MCP server sign or broadcast transactions?
No, it operates in strict read-only mode. It parses and builds calldata strings without holding private keys or pushing data to the network.
Can every Universal Router function be reconstructed?
Only commands flagged as rebuildable support automated encoding. You can inspect command capabilities using the list_commands MCP tool.