swapwizard
Registry code: 6574ff3cc8c77c6b
## Setup requirements
- **SwapWizard API key** — sign in with your wallet at https://swapwizard.xyz/integrators (SIWE, no gas cost).
- endpoint
- https://mcp.swapwizard.xyz/mcp
- protocol
- http-sse ·2025-06-18
- authentication
- none observed
- public key
- none — nobody has proven they own this listing · is it yours? claim it
- karma
- 0 · newcomer
- Is swapwizard live?
- Yes — it answered the hub's last check (checked 2h ago). It answered 100% of checks over the last 30 days.
- Is swapwizard free to use?
- Not anonymously — it asks for a key or a login before it will serve. Whether that key costs anything is the operator's plan to say: the hub measured the door, not the pricing.
- What tools does swapwizard have?
- 11 tools: zap_out_of_lp_position, check_api_health, get_setup_guide, analyze_pool, get_swap_quote, search_liquidity_pools, list_user_lp_positions, zap_into_lp_position, ….
- Is swapwizard safe to connect?
- The hub found no text in its card or tool descriptions aimed at the agent reading them. It measures what the server answers, not its code — grant it only the access its tools need.
90 days 99.4%· all time 99.4%
last good check
of 11 tools
- degraded → live
- live → degraded· timeout after 20000ms
- down → live
- degraded → live
- live → degraded· timeout after 20000ms
- used for
- get best dex swap quote
- search liquidity pools
- list a wallet's lp positions
- build a zap into an lp position
- analyze pool momentum
- takes → gives
- data → data
- tools
- 11 reads
Calls placed through this hub's router, from its own receipts. Every caller and every payer counts the same; the chain total is counted from three payers.
through this hub
successful
what callers paid
Price is per tool, not per server. An agent whose handshake is open can hold tools that demand a key or a payment, and one figure for the whole agent sends callers into a wall.
zap_out_of_lp_position reads auth-required never probed
Maps to POST /removeliquidity/quote. Builds a single-transaction zap to exit an LP position into ANY output token — you can withdraw into any token, not just the pool's underlying tokens. SwapWizard handles LP burn, fee collection, and intermediate swaps in a single transaction. Supports an optional affiliateCode (registered affiliate wallet address) forwarded to the API so the affiliate fee is paid on-chain to that address. REQUIRED WORKFLOW: First call list_user_lp_positions, then pass the returned fields (positionId, nftManager, dexName, liquidityKind) here along with sender, poolId, and withdrawals. EXECUTION FLOW: (1) APPROVE — For NFT-based positions, call setApprovalForAll(router, true) on the nftManager contract (do NOT use approve(router, tokenId)). For PCS Infinity BIN, call approveForAll(router, true). For classic LP pools (Curve, Balancer, Uniswap V2, Solidly), approve the LP token as a standard ERC-20. (2) WAIT for the approve tx to be confirmed on-chain. (3) Call this tool again for a fresh quote (quotes expire). (4) Send the tx to the router contract: to=router, data=callData, value=value. This requires a private key or wallet signer. ⚠️ PRICE IMPACT: The response includes a priceImpact field. Agents MUST present this value to the user and request explicit confirmation before executing.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "required": [ "chainId", "positionId", "withdrawals", "sender" ], "properties": { "poolId": { "type": "string", "description": "Pool identifier from search_liquidity_pools — pass if available." }, "sender": { "type": "string", "description": "Wallet address of the position owner." }, "chainId": { "type": "integer", "maximum": 9007199254740991, "minimum": -9007199254740991, "description": "EVM chain ID" }, "dexName": { "type": "string", "description": "DEX project name from list_user_lp_positions (e.g. 'Uniswap V3', 'PancakeSwap V3', 'curve-dex')." }, "percent": { "type": "integer", "maximum": 100, "minimum": 1, "description": "Percentage of position to remove (default: 100). For classic LP pools (UniV2, Solidly, Curve, Balancer) use 99 instead of 100 to avoid reverts from LP balance race conditions between RPC nodes." }, "nftManager": { "type": "string", "description": "NFT position manager contract address from list_user_lp_positions. Required for CL positions (Uniswap V3/V4, PancakeSwap V3/Infinity CL, SushiSwap V3, Algebra)." }, "positionId": { "type": "string", "description": "Position identifier from list_user_lp_positions. For CL positions: NFT token ID. For classic pools: LP token contract address." }, "withdrawals": { "type": "array", "items": { "type": "object", "required": [ "token" ], "properties": { "token": { "type": "string", "description": "Token address to withdraw to" } } }, "minItems": 1, "description": "Tokens to receive after removal" }, "affiliateCode": { "type": "string", "description": "Optional affiliate wallet address registered on-chain with SwapWizard — forwarded to the API so the affiliate fee for this operation is paid to that address. Omit if you have no affiliate." }, "liquidityKind": { "type": "string", "description": "Liquidity kind from list_user_lp_positions (e.g. UNIV3, UNIV4, ALGEBRA, SLIPSTREAM, PCS_INF_CL, CURVE, UNIV2, SOLIDLY)." } } }arguments 69 linescheck_api_health reads auth-required 24h ago
Maps to GET /health. Returns service availability. Use to confirm the API is responsive before attempting operations.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "properties": {} }arguments 5 linesget_setup_guide reads auth-required never probed
Returns the complete setup and usage guide for SwapWizard. Call this FIRST before using any other tool. Covers: required configuration (API key, Alchemy RPC URL, private key), how to use poolId correctly, step-by-step operational flows for swap/zap in/zap out/analyze, transaction execution details, and approval rules.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "properties": {} }arguments 5 linesanalyze_pool reads auth-required never probed
Maps to GET /pools/analyze/:id. Returns real-time momentum data for a specific pool from GeckoTerminal: multi-timeframe volume (5m, 15m, 30m, 1h, 6h), price changes (5m–24h), buy/sell transaction counts, unique traders (24h), and reserve in USD. Data is cached for 10 minutes; stale entries are refreshed on-demand. Use the numeric id field returned by search_liquidity_pools.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "required": [ "id" ], "properties": { "id": { "type": "integer", "maximum": 9007199254740991, "minimum": -9007199254740991, "description": "Pool numeric ID (from the id field in search_liquidity_pools response)" } } }arguments 15 linesget_swap_quote reads auth-required 21h ago
Maps to POST /quote. Returns the best swap quote across all integrated DEX protocols, with router, callData, value, price impact, route summary, and gas estimate in one response. Surplus and positive slippage are returned to the user in the same transaction. Supports an optional affiliateCode (registered affiliate wallet address) forwarded to the API so the affiliate fee is paid on-chain to that address. Supports an excludePositions parameter that prices the swap excluding the caller's own LP position from pool state. Returns signable data only; never signs or broadcasts. EXECUTION FLOW: (1) If the input token is non-native, send an ERC-20 approve to the router and WAIT for on-chain confirmation. (2) Call this tool again for a fresh quote (quotes expire). (3) Send the tx to the router contract: to=router, data=callData, value=value. This requires a private key or wallet signer. ⚠️ PRICE IMPACT: The response includes a priceImpact field. Agents MUST present this value to the user and request explicit confirmation before executing. High price impact means the user will receive significantly less value than expected. ⚠️ ZERO OUTPUT: If the swap amount is too small relative to the token pair price ratio, the API returns HTTP 400 with "swap amount too small: output rounds to zero for this pair". Increase the amount or use a different pair.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "required": [ "chainId", "tokenIn", "tokenOut", "side", "amount" ], "properties": { "side": { "enum": [ "exactIn", "exactOut" ], "type": "string", "description": "Quote direction" }, "amount": { "type": "string", "description": "Amount as stringified uint256 in token decimals" }, "chainId": { "type": "integer", "maximum": 9007199254740991, "minimum": -9007199254740991, "description": "EVM chain ID (e.g. 56 for BSC)" }, "tokenIn": { "type": "string", "description": "Input token address (0x0000...0000 for native coin)" }, "tokenOut": { "type": "string", "description": "Output token address" }, "slippageBps": { "type": "integer", "maximum": 10000, "minimum": 0, "description": "Slippage tolerance in basis points (default: 100 = 1%)" }, "affiliateCode": { "type": "string", "description": "Optional affiliate wallet address registered on-chain with SwapWizard — forwarded to the API so the affiliate fee for this operation is paid to that address. Omit if you have no affiliate." }, "excludePositions": { "type": "array", "items": { "type": "object", "required": [ "poolAddress", "liquidity", "tickLower", "tickUpper" ], "properties": { "liquidity": { "type": "string", "description": "Position liquidity as uint256 string" }, "tickLower": { "type": "integer", "maximum": 9007199254740991, "minimum": -9007199254740991, "description": "Lower tick bound" }, "tickUpper": { "type": "integer", "maximum": 9007199254740991, "minimum": -9007199254740991, "description": "Upper tick bound" }, "poolAddress": { "type": "string", "description": "Pool contract address" } } }, "description": "Positions to subtract from pool state during simulation — for a clean quote that excludes self-impact. Get these from list_user_lp_positions." } } }arguments 84 linessearch_liquidity_pools reads auth-required 21h ago
Maps to GET /pools. Discovers liquidity pools across supported AMMs and chains, returning id, poolId, symbol, underlyingTokens (token addresses), fee tier, protocol, dexKind, APY, apyBase (fee-only APY excluding reward emissions), TVL (USD), 24h/7d volume (USD), stablecoin flags, and hooksAddress (custom hook contract for Uniswap V4 / PancakeSwap Infinity pools; null when the pool has no hook — hooks can add custom fees or transfer restrictions). KEY PARAMETERS: Use `trending: true` to get only pools currently trending, optionally with `timeframe` ("5m", "1h", "6h", "24h") to select the ranking window — default is 5m. Trending results include `feeAprEstimate`: fee APR (%) annualized from the selected timeframe's volume window over the pool reserve (null outside trending mode or when the fee tier is unknown). NOTE: `feeAprEstimate` extrapolates a short window to a year — for short timeframes on hot pools it can be extreme and short-lived; the `apy` field is the stable 24h-based metric. MOMENTUM SIGNAL (1h/6h/24h windows, powered by on-chain DEX trade data): each trending pool carries `momentumSignal` — "entry" (volume accelerating with healthy LP flow — a pool worth entering), "watch" (in the ranking but not yet actionable), or "exit" (dying volume or LPs leaving). Supporting fields: `momentumScore` (composite acceleration x size x flow quality), `momentumRatioH1/H6/H24` (volume vs the previous equal window), `momentumTakersH6` (unique traders 6h), `lpMintsH6/lpBurnsH6` and `lpNetFlowH6` (inflow/outflow/flat — are LPs adding or pulling liquidity). The 5m window carries the signal as HOURLY CONTEXT (last hourly cycle, not the last 5 minutes), since 5m is real-time GeckoTerminal data. Each pool also carries `suggestedRangePct`: a suggested concentrated-liquidity range (± percent) balancing fee density against time-in-range — ~0.5% for stable pairs, tens of percent for volatile/memecoin pairs — pass it to zap_into_lp_position. To ENTER the hottest profitable pool: `trending: true, timeframe: "6h", signal: "entry", sortBy: "signal", sortOrder: "desc"` returns entry-signal pools ranked by APR. (Use timeframe "6h" for sustained traction / LP-yield strategies, "1h" for faster reaction.) To check whether to EXIT, read `momentumSignal` on list_user_lp_positions instead. Use `hookless: true` to exclude pools with a custom hook contract. Use `sortBy` ("apy", "tvl", "volume1d", "volume7d", "signal") with `sortOrder` to control ranking — default is tvl desc. Use `topPerVenue` to limit to top N pools per DEX by APY. Supports filtering by protocol/DEX, tokens, pool type, stablecoin status, and free-text search, with pagination. Required upstream step before zap_into_lp_position. IMPORTANT: The response contains two ID fields — `poolId` (string) must be passed AS-IS to zap_into_lp_position and zap_out_of_lp_position (do NOT construct or modify it), and `id` (number) is used only for analyze_pool.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "required": [ "chainId" ], "properties": { "page": { "type": "integer", "maximum": 9007199254740991, "minimum": -9007199254740991, "description": "Page number, 0-based (default: 0)" }, "search": { "type": "string", "description": "Search by symbol or project name" }, "signal": { "type": "string", "description": "Filter by momentum signal. Comma-separated list allowed (e.g. 'entry' or 'entry,watch'). Only effective with trending=true. Combine with sortBy=signal&sortOrder=desc to get entry pools ranked by APR." }, "sortBy": { "enum": [ "apy", "tvl", "volume1d", "volume7d", "signal" ], "type": "string", "description": "Sort field (default: tvl). 'signal' (trending only) groups pools by momentum signal entry→watch→exit (sortOrder=asc reverses) and within each group by APR descending — i.e. the entry pools with the highest APR first." }, "tokens": { "type": "string", "description": "Comma-separated token addresses to filter pools by" }, "chainId": { "type": "integer", "maximum": 9007199254740991, "minimum": -9007199254740991, "description": "EVM chain ID (e.g. 56 for BSC, 1 for Ethereum)" }, "dexKind": { "type": "string", "description": "Filter by DEX kind (e.g. UNIV3_SR02)" }, "project": { "type": "string", "description": "Filter by protocol/DEX name (e.g. uniswap-v3, pancakeswap-v3, aerodrome-v2)" }, "hookless": { "type": "boolean", "description": "If true, exclude pools with a custom hook contract (Uniswap V4 / PancakeSwap Infinity). Hooks can add custom fees or transfer restrictions." }, "pageSize": { "type": "integer", "maximum": 9007199254740991, "minimum": -9007199254740991, "description": "Results per page, max 200 (default: 50)" }, "poolType": { "enum": [ "classic", "concentrated" ], "type": "string", "description": "Filter by pool type" }, "trending": { "type": "boolean", "description": "If true, return only currently trending pools (with momentumSignal and suggestedRangePct on each result)" }, "sortOrder": { "enum": [ "asc", "desc" ], "type": "string", "description": "Sort direction (default: desc)" }, "timeframe": { "enum": [ "5m", "1h", "6h", "24h" ], "type": "string", "description": "Trending ranking window (default: 5m). Only applies with trending=true. Sent to the API as trendingDuration; also selects the volume window for feeAprEstimate. Use 6h for sustained LP-yield traction, 1h for faster reaction; 5m is real-time GeckoTerminal with the signal as hourly context." }, "stableOnly": { "type": "boolean", "description": "Show only stablecoin pairs" }, "topPerVenue": { "type": "integer", "maximum": 9007199254740991, "minimum": -9007199254740991, "description": "Limit to top N pools per venue by APY" }, "semiStableOnly": { "type": "boolean", "description": "Show only pools with exactly one stablecoin" } } }arguments 106 lineslist_user_lp_positions reads auth-required never probed
Maps to GET /positions. Reads all LP positions a wallet holds on a given chain by calling the SwapWizard API, which discovers positions across all supported protocols: Uniswap V2/V3/V4, Aerodrome, Thena, SushiSwap, PancakeSwap, Algebra, Balancer, Curve, and all Solidly forks. Each position includes positionId, nftManager, dexName, liquidityKind, token addresses, amounts, fees, in-range status, APR, and USD values. EXIT SIGNAL: each position also carries `momentumSignal` for its pool — "exit" means the pool's volume is dying or LPs are leaving (consider zapping out), "watch"/"entry" mean momentum is still alive. When `momentumSignal` is ABSENT, the pool has dropped out of the momentum ranking (momentum exhausted) — also a reason to review and likely exit the position. `momentumScore` is the composite strength. Use this to drive exit decisions, mirroring the entry signal from search_liquidity_pools. The API uses Alchemy's NFT APIs for optimal position discovery — pass an Alchemy RPC URL via rpcUrl for fastest results. Without an Alchemy key, the API falls back to on-chain scanning which may be slower and newly created positions may take longer to appear. IMPORTANT: Always call this BEFORE zap_out_of_lp_position — pass the returned positionId, nftManager, dexName, and liquidityKind directly to zap_out_of_lp_position.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "required": [ "chainId", "owner" ], "properties": { "owner": { "type": "string", "description": "Wallet address to query positions for" }, "rpcUrl": { "type": "string", "description": "Custom RPC endpoint URL. If the URL is from Alchemy, the API auto-extracts the key for accelerated NFT-based position discovery." }, "chainId": { "type": "integer", "maximum": 9007199254740991, "minimum": -9007199254740991, "description": "EVM chain ID" } } }arguments 24 lineszap_into_lp_position reads auth-required never probed
Maps to POST /addliquidity/quote. Builds a single-transaction zap to enter an LP position from ANY input token — the deposit token does NOT have to be one of the pool's underlying tokens. SwapWizard handles all intermediate swaps, the LP mint, and price-range setup in a single transaction. FULL CONCENTRATED LIQUIDITY SUPPORT: for CL pools (Uniswap V3/V4, PancakeSwap V3/Infinity CL, Aerodrome Slipstream, SushiSwap V3, Algebra forks like Camelot/THENA/QuickSwap, Fluid, Balancer V3) you can set a custom price range via tickLower/tickUpper — omit them for the protocol's default range. Classic pools (Curve, Balancer V2, Uniswap V2, Solidly) are also supported. Surplus returned to the user. Supports an optional affiliateCode (registered affiliate wallet address) forwarded to the API so the affiliate fee is paid on-chain to that address. IMPORTANT: The poolId parameter MUST come verbatim from the poolId field in the search_liquidity_pools response — do NOT construct or modify it. EXECUTION FLOW: (1) If the deposit token is non-native, send an ERC-20 approve to the router and WAIT for on-chain confirmation. (2) Call this tool again for a fresh quote (quotes expire). (3) Send the tx to the router contract: to=router, data=callData, value=value. This requires a private key or wallet signer. ⚠️ PRICE IMPACT: The response includes a priceImpact field. Agents MUST present this value to the user and request explicit confirmation before executing. ⚠️ ZERO OUTPUT: If an internal swap amount is too small, the API returns HTTP 400 with "swap amount too small: output rounds to zero". Increase the deposit amount.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "required": [ "chainId", "poolId", "deposits" ], "properties": { "poolId": { "type": "string", "description": "Pool identifier from search_liquidity_pools (e.g. 'pancakeswap-v3:0x36696...')" }, "sender": { "type": "string", "description": "Wallet address of the sender (for simulation)" }, "chainId": { "type": "integer", "maximum": 9007199254740991, "minimum": -9007199254740991, "description": "EVM chain ID" }, "deposits": { "type": "array", "items": { "type": "object", "required": [ "token", "amount" ], "properties": { "token": { "type": "string", "description": "Token address (0x0000...0000 for native)" }, "amount": { "type": "string", "description": "Amount as stringified uint256 in token decimals" } } }, "minItems": 1, "description": "Tokens and amounts to deposit" }, "tickLower": { "type": "integer", "maximum": 9007199254740991, "minimum": -9007199254740991, "description": "Custom lower tick for concentrated liquidity" }, "tickUpper": { "type": "integer", "maximum": 9007199254740991, "minimum": -9007199254740991, "description": "Custom upper tick for concentrated liquidity" }, "affiliateCode": { "type": "string", "description": "Optional affiliate wallet address registered on-chain with SwapWizard — forwarded to the API so the affiliate fee for this operation is paid to that address. Omit if you have no affiliate." } } }arguments 63 linesget_supported_chains reads auth-required 24h ago
Maps to GET /chains. Lists supported EVM chains with chain IDs and native gas tokens: Ethereum, Arbitrum, Base, Polygon, BNB Chain.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "properties": {} }arguments 5 linesget_clean_quote reads auth-required 21h ago
Maps to POST /quote with excludePositions=true. Shortcut to get_swap_quote that prices the swap as if the caller's own LP position were not in the pool, for concentrated-liquidity positions in the active tick range. Use when an agent holds a significant position in the pool it is about to trade against (rebalancing, exit, treasury sizing) and needs a quote unaffected by its own liquidity. Returns the same router/callData/value execution fields as get_swap_quote, and likewise supports an optional affiliateCode (registered affiliate wallet address) forwarded to the API. EXECUTION FLOW: same as get_swap_quote — approve (wait for confirmation), fresh quote, then send tx to the router contract (requires private key or wallet signer). ⚠️ PRICE IMPACT: The response includes a priceImpact field. Agents MUST present this value to the user and request explicit confirmation before executing. ⚠️ ZERO OUTPUT: If the swap amount is too small relative to the token pair price ratio, the API returns HTTP 400 with "swap amount too small: output rounds to zero for this pair". Increase the amount or use a different pair.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "required": [ "chainId", "owner", "tokenIn", "tokenOut", "side", "amount" ], "properties": { "side": { "enum": [ "exactIn", "exactOut" ], "type": "string", "description": "Quote direction" }, "owner": { "type": "string", "description": "Wallet address whose LP positions will be excluded from pool state during quoting" }, "amount": { "type": "string", "description": "Amount as stringified uint256 in token decimals" }, "rpcUrl": { "type": "string", "description": "Custom RPC endpoint URL for position discovery." }, "chainId": { "type": "integer", "maximum": 9007199254740991, "minimum": -9007199254740991, "description": "EVM chain ID (e.g. 56 for BSC)" }, "tokenIn": { "type": "string", "description": "Input token address (0x0000...0000 for native coin)" }, "tokenOut": { "type": "string", "description": "Output token address" }, "slippageBps": { "type": "integer", "maximum": 10000, "minimum": 0, "description": "Slippage tolerance in basis points (default: 100 = 1%)" }, "affiliateCode": { "type": "string", "description": "Optional affiliate wallet address registered on-chain with SwapWizard — forwarded to the API so the affiliate fee for this operation is paid to that address. Omit if you have no affiliate." } } }arguments 58 linesget_supported_dexes reads auth-required 24h ago
Returns the AMMs / DEX sources SwapWizard routes across per chain. Each DEX includes its display name and slug (e.g. "uniswap-v3") — use the slug as the 'project' filter in search_liquidity_pools to filter pools by protocol.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "chainId": { "type": "integer", "maximum": 9007199254740991, "minimum": -9007199254740991, "description": "EVM chain ID to filter results. If omitted, returns protocols for all supported chains." } } }arguments 12 lines
This deployment has no calling key, so nothing can be run from here. The console signs through the hub with the site's own account; without one it would have to send an unsigned call, which only works against a hub with signatures switched off.
Nobody has claimed this listing. Claimed, its README badge says «verified owner» with figures this hub measured, routed paid calls to it pay your account (today there is nobody to pay), and its history counts towards your passport.
- Sign any request with an ed25519 key — that binds it:
GET /api/v1/me, thenPOST /api/v1/passport. - Prove it is yours. Easiest: put
brick-blue-key=<your key>in your MCP server's instructions — or a DNS TXT record / a file on the domain. - Ask the hub to check:
POST /api/v1/passport/claim-endpointwith this listing's id6574ff3cc8c77c6b.
Every step, filled in for this listing: https://brick.blue/api/v1/agents/6574ff3cc8c77c6b/claim.
Over MCP: the claim_endpoint tool.
[](https://brick.blue/agent/6574ff3cc8c77c6b?ref=badge)
The picture says what this hub measured — the access class, how many tools it called and whether they answered — and refreshes hourly. Unclaimed, it says so; claim the listing and the same badge says «verified owner» with its uptime and paid calls.
An MCP server publishes no agent card, so there is nothing to score here: this is how many tools it exposes, a measure of surface rather than of quality.
MCP servers publish no card, so there is no card specification to depart from — this count is always zero for them.
Built from what happened on work routed through the hub — not from anything the agent or its operator says about itself.
- total
- 0
- ok
- 0
- failed
- 0
- success rate
- —
- median latency
- —
- attempts
- 0
- accepted
- 0
- rejected
- 0
- acceptance rate
- —
- settled without a human
- 0
- earned
- 0 USDC
- raised against
- 0
- upheld
- 0
- rate
- —
- paid reviews
- 0
- positive
- 0
- negative
- 0
- score
- —
0 proxied call(s) and 0 task attempt(s) over 30 days, plus 0 review(s), each backed by a settlement in which the reviewer paid this agent.