DexSQL
SQL for Android APK and DEX files: classes, methods, strings, references and smali.
Decode and encode Uniswap Universal Router calldata (V2, V3, V4). Read-only: never signs or sends.
Pick the AI app you use, then copy the settings.
Passed 3/3 checks · Runs on your computer · ✓ Commands checked Nov 14, 2026
First: which AI do you use?
Pick your app and the steps appear below.
Works with Claude, with some setup first
Install Python (uv) on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone
Copy this message into a Claude chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server Uniswap Universal Router Decoder for Claude on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "uniswap-universal-router-decoder": { "command": "uvx", "args": [ "uniswap-universal-router-decoder" ] } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the Uniswap Universal Router Decoder tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
uv --versionMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required
When it’s done, close Terminal, open it again and run the same command. You should see a version number: uv --version
Install once; it works for everything that needs uv
SettingsDeveloperEdit Config
{
"mcpServers": {
"uniswap-universal-router-decoder": {
"command": "uvx",
"args": [
"uniswap-universal-router-decoder"
]
}
}
}Use Uniswap Universal Router Decoder and tell me what you can do for me, then show me one thing✓ If Claude says it is using Uniswap Universal Router Decoder or shows a Uniswap Universal Router Decoder tool in the answer, you are connected
The command above works without these. Add them only if you want to change something, following the maker’s description.
RPC_URL Ethereum RPC endpoint. Optional: only decode_transaction needs it.Descriptions are as written by the maker.
Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version
ChatGPT cannot connect Uniswap Universal Router Decoder yet
Uniswap Universal Router Decoder runs on your computer, but ChatGPT can only connect servers that run on the web
A · Use an app that can connect Uniswap Universal Router Decoder
B · Others in Crypto & blockchain that work with ChatGPT
Picked from the most used in the same category, only ones that connect by address with no key
Works with Claude Code, with some setup first
Install Python (uv) on your computer first (one time)
Copy this message into a Claude Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server Uniswap Universal Router Decoder for Claude Code on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): claude mcp add --scope user uniswap-universal-router-decoder -- uvx uniswap-universal-router-decoder 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the Uniswap Universal Router Decoder tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
uv --versionMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required
When it’s done, close Terminal, open it again and run the same command. You should see a version number: uv --version
Install once; it works for everything that needs uv
Mac: press Command+Space and type Terminal · Windows: open PowerShell
claude mcp add --scope user uniswap-universal-router-decoder -- uvx uniswap-universal-router-decoderYou should see Uniswap Universal Router Decoder listed as connected
Use Uniswap Universal Router Decoder and tell me what you can do for me, then show me one thing✓ If Claude Code says it is using Uniswap Universal Router Decoder or shows a Uniswap Universal Router Decoder tool in the answer, you are connected
The command above works without these. Add them only if you want to change something, following the maker’s description.
RPC_URL Ethereum RPC endpoint. Optional: only decode_transaction needs it.Descriptions are as written by the maker.
Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with Cursor, with some setup first
Install Python (uv) on your computer first (one time)
Copy this message into a Cursor chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server Uniswap Universal Router Decoder for Cursor on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "uniswap-universal-router-decoder": { "command": "uvx", "args": [ "uniswap-universal-router-decoder" ] } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the Uniswap Universal Router Decoder tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
uv --versionMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required
When it’s done, close Terminal, open it again and run the same command. You should see a version number: uv --version
Install once; it works for everything that needs uv
Use Uniswap Universal Router Decoder and tell me what you can do for me, then show me one thing✓ If Cursor says it is using Uniswap Universal Router Decoder or shows a Uniswap Universal Router Decoder tool in the answer, you are connected
The command above works without these. Add them only if you want to change something, following the maker’s description.
RPC_URL Ethereum RPC endpoint. Optional: only decode_transaction needs it.Descriptions are as written by the maker.
Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with VS Code, with some setup first
Install Python (uv) on your computer first (one time)
Copy this message into a VS Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server Uniswap Universal Router Decoder for VS Code on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "servers": { "uniswap-universal-router-decoder": { "type": "stdio", "command": "uvx", "args": [ "uniswap-universal-router-decoder" ] } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the Uniswap Universal Router Decoder tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
uv --versionMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required
When it’s done, close Terminal, open it again and run the same command. You should see a version number: uv --version
Install once; it works for everything that needs uv
Use Uniswap Universal Router Decoder and tell me what you can do for me, then show me one thing✓ If VS Code says it is using Uniswap Universal Router Decoder or shows a Uniswap Universal Router Decoder tool in the answer, you are connected
The command above works without these. Add them only if you want to change something, following the maker’s description.
RPC_URL Ethereum RPC endpoint. Optional: only decode_transaction needs it.Descriptions are as written by the maker.
Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Claude Code
claude mcp add --scope user uniswap-universal-router-decoder -- uvx uniswap-universal-router-decoderClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"uniswap-universal-router-decoder": {
"command": "uvx",
"args": [
"uniswap-universal-router-decoder"
]
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"uniswap-universal-router-decoder": {
"command": "uvx",
"args": [
"uniswap-universal-router-decoder"
]
}
}
}VS Code (mcp.json)
{
"servers": {
"uniswap-universal-router-decoder": {
"type": "stdio",
"command": "uvx",
"args": [
"uniswap-universal-router-decoder"
]
}
}
}RPC_URL envDescriptions are as written by the maker.
These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.
Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.
Run on your computer in
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Runs on your computer; the tool list appears in your AI app after you install it.
We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 15, 2026
The registry name was verified with the GitHub account Elnaril, which owns the repo
Code last changed 6 days ago
Uses MIT
This one runs on your computer; there is no internet endpoint
Runs on your computer and uses local settings instead
Runs on your computer; we can only read tool lists from internet endpoints
No entries on OSV.dev for uniswap-universal-router-decoder@4.0.0
Checks only this package version, not every dependency · checked Nov 15, 2026
Ask, share a tip or report that it does not work. Sorted by what people marked helpful.
No posts yet. Be the first to ask or share.
Posts here are written by users, not the PopNx team.
No reviews yet
Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.
It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.
The registry does not list a required key, though some servers ask you to sign in on first use.
It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).
The GitHub repo last changed 6 days ago, and the latest version (4.0.0) reached the registry 17 days ago.
Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Python (uv) on your computer.
In the same category: DexSQL, PayRam, DexPaprika, Alchemy MCP Server, X402 List MCP
Same category, other makers, commands already checked. Official ones first, then by stars.
Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi
SQL for Android APK and DEX files: classes, methods, strings, references and smali.
Install, configure, operate and integrate self-hosted PayRam crypto payment gateways.
DEX and on-chain data: liquidity pools, token prices, swaps, and trading volume.
Blockchain data across 100+ chains: token prices, NFTs, transfers, simulation, traces, Solana DAS
Find and vet x402 payment APIs before your agent pays one: uptime, price, on-chain volume.
Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.
Many thanks to everyone who has ☕️ offered some coffees! ☕️
or ⭐ starred this project! ⭐
It is greatly appreciated! :)
See the release notes page
revert_on_fail to the encoder methods for the commands whose failure the UR can toleratetrailing_data, and re-append them when rebuilding the calldata, so a decoded call can be rebuilt byte-for-byteencoder & decoder modulespublish.yml GitHub Actions workflow that automatically publishes the package to PyPI and the MCP Registry with OIDC Trusted PublishingEncoder.function_input() / AsyncEncoder.function_input() to rebuild the calldata from a decoded calldecoded_input_to_dict() and transaction_to_dict() to render the decoder output as JSON-friendly dictsur-decode and ur-encode command line tools, including ur-encode v3-path and its encode_v3_path MCP counterpartur-mcp MCP server (optional mcp extra) so AI agents can drive the codec, including encode_calldata to rebuild the calldata from a decoded callur-encode list / describe and the list_commands / describe_command MCP tools) now describe the decoded call format and its ABI parameters, instead of the encoder methodsserver.json) to make the ur-mcp server discoverableAGENTS.md and llms.txt for AI agents, plus a mcp PyPI keywordtests/test_version_consistency.py to keep the packaging version, server.json and the README mcp-name: marker in syncThe object of this library is to decode & encode transactions sent to the Uniswap Universal Router (UR) on Ethereum Mainnet, though it would work on any compatible chain where the UR is deployed. See Version Mapping below. This Python SDK is based on, and intended to be used with web3.py
The target audience is Python developers who are familiar with the Ethereum blockchain concepts and web3.py, and how DEXes work. The same codec is also available without Python, through the ur-decode / ur-encode command line tools and the optional ur-mcp MCP server (see "Command line interface" and "MCP server" below): both print JSON, so shell scripts and AI agents can drive it too.
⚠ Before using this library, ensure you are familiar with general blockchain concepts. The Python API also expects web3.py knowledge in particular.
⚠ Not all UR functions supported by this SDK are available through the CLI or MCP tools: run ur-encode list and look for the "rebuildable" flag.
| Command Id | Universal Router Function | Underlying Action - Function | Supported |
|---|---|---|---|
| 0x00 / 0 | V3_SWAP_EXACT_IN | ✅ | |
| 0x01 / 1 | V3_SWAP_EXACT_OUT | ✅ | |
| 0x02 / 2 | PERMIT2_TRANSFER_FROM | ✅ | |
| 0x03 / 3 | PERMIT2_PERMIT_BATCH | ✅ | |
| 0x04 / 4 | SWEEP | ✅ | |
| 0x05 / 5 | TRANSFER | ✅ | |
| 0x06 / 6 | PAY_PORTION | ✅ | |
| 0x07 / 7 | PAY_PORTION_FULL_PRECISION | ✅ | |
| 0x08 / 8 | V2_SWAP_EXACT_IN | ✅ | |
| 0x09 / 9 | V2_SWAP_EXACT_OUT | ✅ | |
| 0x0a / 10 | PERMIT2_PERMIT | ✅ | |
| 0x0b / 11 | WRAP_ETH | ✅ | |
| 0x0c / 12 | UNWRAP_WETH | ✅ | |
| 0x0d / 13 | PERMIT2_TRANSFER_FROM_BATCH | ✅ | |
| 0x0e / 14 | BALANCE_CHECK_ERC20 | ✅ | |
| 0x0f / 15 | placeholder | N/A | |
| 0x10 / 16 | V4_SWAP | ✅ | |
| 0x06 - SWAP_EXACT_IN_SINGLE | ✅ | ||
| 0x07 - SWAP_EXACT_IN | ✅ | ||
| 0x08 - SWAP_EXACT_OUT_SINGLE | ✅ | ||
| 0x09 - SWAP_EXACT_OUT | ✅ | ||
| 0x0b - SETTLE | ✅ | ||
| 0x0c - SETTLE_ALL | ✅ | ||
| 0x0e - TAKE | ✅ | ||
| 0x0f - TAKE_ALL | ✅ | ||
| 0x10 - TAKE_PORTION | ✅ | ||
| 0x11 / 17 | V3_POSITION_MANAGER_PERMIT | ✅ | |
| 0x12 / 18 | V3_POSITION_MANAGER_CALL | ✅ | |
| 0x13 / 19 | V4_INITIALIZE_POOL | ✅ | |
| 0x14 / 20 | V4_POSITION_MANAGER_CALL | ✅ | |
| 0x02 - MINT_POSITION | ✅ | ||
| 0x0b - SETTLE | ✅ | ||
| 0x0d - SETTLE_PAIR | ✅ | ||
| 0x0e - TAKE | ✅ | ||
| 0x11 - TAKE_PAIR | ✅ | ||
| 0x12 - CLOSE_CURRENCY | ✅ | ||
| 0x13 - CLEAR_OR_TAKE | ✅ | ||
| 0x14 - SWEEP | ✅ | ||
| 0x15 - WRAP | ✅ | ||
| 0x16 - UNWRAP | ✅ | ||
| 0x15 - 0x20 | placeholders | N/A | |
| 0x21 / 33 | EXECUTE_SUB_PLAN | ✅ | |
| 0x22 - 0x3f | placeholders | N/A | |
| 0x40 / 64 | ACROSS_V4_DEPOSIT_V3 | ❌ |
All the ✅ commands can be decoded and encoded. V4_SWAP, V4_POSITION_MANAGER_CALL and EXECUTE_SUB_PLAN can also be decoded, but they cannot be rebuilt from a decoded call (see "How to rebuild the calldata from a decoded call").
Here is the mapping between the Universal Router versions and the SDK ones
| UR Version | UR address on Ethereum | Python SDK version |
|---|---|---|
| v2.1.2 | 0x23617e59A5925b2A4Bf75d73ff6711cD0b29De85 | v3.1.0 & v4.0.0 |
| v2.1.1 | 0x4C82D1fBFe28C977cBB58D8C7FF8FCF9F70a2cCA | v3.0.0 |
| v2 | 0x66a9893cC07D91D95644AEDD05D03f95e1dBA8Af | v2.0.0 & v2.1.0 |
| v1.2 | 0x3fC91A3afd70395Cd496C647d5a6CC9D4B2b7FAD | v0.9.0 to v1.2.1 |
| v1 | 0xEf1c6E67703c7BD7107eed8303Fbe6EC2554BF6B | v0.8.0 |
A good practice is to use Python virtual environments, here is a tutorial.
The library can be pip installed from pypi.org as usual:
# update pip to latest version if needed
pip install -U pip
pip install uniswap-universal-router-decoder
To install it from source:
pip install .
or for contributors:
pip install -e '.[mc