Serveur MCP
Vurto Swap
io.github.cryptoconspiracy/vurto-swap
Ce que fait ce MCP
Quotes, builds, signs, executes, and monitors non-custodial token swaps across EVM chains and Solana.
Capacités
Outils
9
outils
double_build
Builds signable/sendable plans for BOTH legs of a Double Out or Double In swap â two ordinary swap_build calls under the hood, kept together for convenience. Returns { legA, legB }, each a full SwapPlan exactly like swap_build's. The two legs are NOT atomic â there is no combined contract call, each is a transaction (or CoW signature) the wallet sends separately, same as any other swap. Execute leg A fully first (steps, signing, report_execution) and confirm it landed before starting leg B. If leg A fails or is rejected, do NOT execute leg B â proceeding would leave the wallet with only half the ratio the user asked for, which defeats the purpose of a Double swap.
Accès externe
Schéma d’entrée
{'type': 'object', 'required': ['chainId', 'wallet', 'legA', 'legB'], 'properties': {'legA': {'type': 'object', 'properties': {'amount': {'type': 'string', 'description': 'Human decimal amount, e.g. "100". Use this OR amountRaw, not both.'}, 'wallet': {'type': 'string', 'description': 'Wallet that will sign. Required for builds and EVM execution/history calls. On an anonymous EVM quote, pass it to make the returned quoteId executable; without it the quote is indicative.'}, 'chainId': {'type': ['integer', 'string'], 'description': 'EVM: integer from GET /v1/chains (1, 10, 56, 100, 137, 8453, 42161, 43114, 130). Solana: string from GET /v1/svm/chains ("solana-mainnet").'}, 'quoteId': {'type': 'string', 'description': 'Optional: build exactly this route from a prior double_quote.'}, 'tokenIn': {'type': 'string', 'description': "Contract address (Solana: mint), or symbol (case-insensitive). A symbol matching more than one token on this chain fails with ambiguous_token and every candidate â\x80\x94 pick the address you meant and retry. On Solana only VERIFIED tokens resolve by symbol, because there anyone can mint a token using another one's symbol; an unverified token has to be named by its mint."}, 'receiver': {'type': 'string', 'description': 'Optional: deliver the output to this address instead of the signing wallet. Only providers with supportsReceiver true on the resulting quote honor it â\x80\x94 others are left out of quotes[] entirely rather than risk sending to the wrong address. supportsReceiver is present on Solana quotes too, so read it instead of assuming. On Solana, selling into native SOL with a separate destination is refused on every provider (receiver_native_sol_unsupported): closing the wrapped-SOL account sends balance and rent to whoever signs. Ask for wSOL instead.'}, 'tokenOut': {'type': 'string', 'description': 'Contract address, or symbol.'}, 'amountRaw': {'type': 'string', 'description': "Raw integer string in tokenIn's smallest unit."}, 'slippageBps': {'type': 'integer', 'description': 'Optional, a sane per-pair default applies when omitted.'}}, 'additionalProperties': False}, 'legB': {'type': 'object', 'properties': {'amount': {'type': 'string', 'description': 'Human decimal amount, e.g. "100". Use this OR amountRaw, not both.'}, 'wallet': {'type': 'string', 'description': 'Wallet that will sign. Required for builds and EVM execution/history calls. On an anonymous EVM quote, pass it to make the returned quoteId executable; without it the quote is indicative.'}, 'chainId': {'type': ['integer', 'string'], 'description': 'EVM: integer from GET /v1/chains (1, 10, 56, 100, 137, 8453, 42161, 43114, 130). Solana: string from GET /v1/svm/chains ("solana-mainnet").'}, 'quoteId': {'type': 'string'}, 'tokenIn': {'type': 'string', 'description': "Contract address (Solana: mint), or symbol (case-insensitive). A symbol matching more than one token on this chain fails with ambiguous_token and every candidate â\x80\x94 pick the address you meant and retry. On Solana only VERIFIED tokens resolve by symbol, because there anyone can mint a token using another one's symbol; an unverified token has to be named by its mint."}, 'receiver': {'type': 'string', 'description': 'Optional: deliver the output to this address instead of the signing wallet. Only providers with supportsReceiver true on the resulting quote honor it â\x80\x94 others are left out of quotes[] entirely rather than risk sending to the wrong address. supportsReceiver is present on Solana quotes too, so read it instead of assuming. On Solana, selling into native SOL with a separate destination is refused on every provider (receiver_native_sol_unsupported): closing the wrapped-SOL account sends balance and rent to whoever signs. Ask for wSOL instead.'}, 'tokenOut': {'type': 'string', 'description': 'Contract address, or symbol.'}, 'amountRaw': {'type': 'string', 'description': "Raw integer string in tokenIn's smallest unit."}, 'slippageBps': {'type': 'integer', 'description': 'Optional, a sane per-pair default applies when omitted.'}}, 'additionalProperties': False}, 'wallet': {'type': 'string', 'description': 'Wallet that will sign. Required for builds and EVM execution/history calls. On an anonymous EVM quote, pass it to make the returned quoteId executable; without it the quote is indicative.'}, 'chainId': {'type': ['integer', 'string'], 'description': 'EVM: integer from GET /v1/chains (1, 10, 56, 100, 137, 8453, 42161, 43114, 130). Solana: string from GET /v1/svm/chains ("solana-mainnet").'}, 'maxSlippageBps': {'type': 'integer', 'description': 'Optional ceiling, 0-10000, applied to both legs.'}}, 'additionalProperties': False}
double_quote
Compares ranked routes for TWO swap legs at once â "Double Out" (one source token split into two destinations) or "Double In" (two source tokens converging on one destination). This exists because building a liquidity pool or matching a target ratio needs both legs priced against the market at the same instant, not one after another with the price moving in between. Each leg is independently quoted (two ordinary swap_quote calls under the hood) â this tool is a convenience that keeps them together, not a combined/atomic route. For mode "out": legA.tokenIn must equal legB.tokenIn (the shared source); tokenOut differs. For mode "in": legA.tokenOut must equal legB.tokenOut (the shared destination); tokenIn differs. Pass the exact amount each leg should trade â this tool does not compute percentages or splits for you. If the shared token is the chain's native asset, remember gas is paid twice (once per leg's eventual transaction) â do not quote/build a total that leaves nothing for the second leg's gas.
Lecture seule
Accès externe
Schéma d’entrée
{'type': 'object', 'required': ['mode', 'chainId', 'legA', 'legB'], 'properties': {'legA': {'type': 'object', 'required': ['tokenIn', 'tokenOut'], 'properties': {'amount': {'type': 'string', 'description': 'Human decimal amount, e.g. "100". Use this OR amountRaw, not both.'}, 'wallet': {'type': 'string', 'description': 'Wallet that will sign. Required for builds and EVM execution/history calls. On an anonymous EVM quote, pass it to make the returned quoteId executable; without it the quote is indicative.'}, 'chainId': {'type': ['integer', 'string'], 'description': 'EVM: integer from GET /v1/chains (1, 10, 56, 100, 137, 8453, 42161, 43114, 130). Solana: string from GET /v1/svm/chains ("solana-mainnet").'}, 'tokenIn': {'type': 'string', 'description': "Contract address (Solana: mint), or symbol (case-insensitive). A symbol matching more than one token on this chain fails with ambiguous_token and every candidate â\x80\x94 pick the address you meant and retry. On Solana only VERIFIED tokens resolve by symbol, because there anyone can mint a token using another one's symbol; an unverified token has to be named by its mint."}, 'receiver': {'type': 'string', 'description': 'Optional: deliver the output to this address instead of the signing wallet. Only providers with supportsReceiver true on the resulting quote honor it â\x80\x94 others are left out of quotes[] entirely rather than risk sending to the wrong address. supportsReceiver is present on Solana quotes too, so read it instead of assuming. On Solana, selling into native SOL with a separate destination is refused on every provider (receiver_native_sol_unsupported): closing the wrapped-SOL account sends balance and rent to whoever signs. Ask for wSOL instead.'}, 'tokenOut': {'type': 'string', 'description': 'Contract address, or symbol.'}, 'amountRaw': {'type': 'string', 'description': "Raw integer string in tokenIn's smallest unit."}, 'slippageBps': {'type': 'integer', 'description': 'Optional, a sane per-pair default applies when omitted.'}}, 'additionalProperties': False}, 'legB': {'type': 'object', 'required': ['tokenIn', 'tokenOut'], 'properties': {'amount': {'type': 'string', 'description': 'Human decimal amount, e.g. "100". Use this OR amountRaw, not both.'}, 'wallet': {'type': 'string', 'description': 'Wallet that will sign. Required for builds and EVM execution/history calls. On an anonymous EVM quote, pass it to make the returned quoteId executable; without it the quote is indicative.'}, 'chainId': {'type': ['integer', 'string'], 'description': 'EVM: integer from GET /v1/chains (1, 10, 56, 100, 137, 8453, 42161, 43114, 130). Solana: string from GET /v1/svm/chains ("solana-mainnet").'}, 'tokenIn': {'type': 'string', 'description': "Contract address (Solana: mint), or symbol (case-insensitive). A symbol matching more than one token on this chain fails with ambiguous_token and every candidate â\x80\x94 pick the address you meant and retry. On Solana only VERIFIED tokens resolve by symbol, because there anyone can mint a token using another one's symbol; an unverified token has to be named by its mint."}, 'receiver': {'type': 'string', 'description': 'Optional: deliver the output to this address instead of the signing wallet. Only providers with supportsReceiver true on the resulting quote honor it â\x80\x94 others are left out of quotes[] entirely rather than risk sending to the wrong address. supportsReceiver is present on Solana quotes too, so read it instead of assuming. On Solana, selling into native SOL with a separate destination is refused on every provider (receiver_native_sol_unsupported): closing the wrapped-SOL account sends balance and rent to whoever signs. Ask for wSOL instead.'}, 'tokenOut': {'type': 'string', 'description': 'Contract address, or symbol.'}, 'amountRaw': {'type': 'string', 'description': "Raw integer string in tokenIn's smallest unit."}, 'slippageBps': {'type': 'integer', 'description': 'Optional, a sane per-pair default applies when omitted.'}}, 'additionalProperties': False}, 'mode': {'enum': ['out', 'in'], 'type': 'string', 'description': '"out": one source, two destinations. "in": two sources, one destination.'}, 'wallet': {'type': 'string', 'description': 'Wallet that will sign. Required for builds and EVM execution/history calls. On an anonymous EVM quote, pass it to make the returned quoteId executable; without it the quote is indicative.'}, 'chainId': {'type': ['integer', 'string'], 'description': 'EVM: integer from GET /v1/chains (1, 10, 56, 100, 137, 8453, 42161, 43114, 130). Solana: string from GET /v1/svm/chains ("solana-mainnet").'}}, 'additionalProperties': False}
nn_build
Builds ONE signable/sendable atomic transaction executing every leg of an N:N basket through VurtoSwapRouter. Always re-quotes the whole basket fresh from chainId/inputLegs/outputLegs â there is no quoteId handoff for N:N, pass the same fields used for nn_quote (or skip nn_quote and call this directly). No API key required: pass the wallet that will sign. A machine credential is optional and only raises your limit from the per-IP cap to the credential budget. Returns steps[]: one approve step per DISTINCT input token that still needs allowance, followed by ONE transaction step that executes every leg atomically. The approve target is the VurtoSwapRouter address (steps[].spender / the build's router), NOT each leg's underlying provider â this router pulls every input token itself inside one contract call, so approving providers individually the way swap_build does would approve the wrong address. If simulation.status is approval_required, send the approve step(s) first and call nn_build again for the executable transaction. legs[].routeSwitch, when present on a leg, means the provider the quote picked for THAT leg refused to build (it hit its request limit) and the leg was built with another provider instead: {from, to, reason}. Only that leg changed, the others are untouched, and the replacement is what will be signed: say which provider replaced it before the user signs. IMPORTANT: report_execution and swap_status do NOT support nn_build's transaction step â both key off a single quoteId, and this build has none (it is one transaction covering every leg, not one quote). After sending it, confirm success by checking the transaction receipt directly, not swap_status.
Accès externe
Schéma d’entrée
{'type': 'object', 'required': ['chainId', 'wallet', 'inputLegs', 'outputLegs'], 'properties': {'wallet': {'type': 'string', 'description': 'Wallet that will sign. Required for builds and EVM execution/history calls. On an anonymous EVM quote, pass it to make the returned quoteId executable; without it the quote is indicative.'}, 'chainId': {'type': ['integer', 'string'], 'description': 'EVM: integer from GET /v1/chains (1, 10, 56, 100, 137, 8453, 42161, 43114, 130). Solana: string from GET /v1/svm/chains ("solana-mainnet").'}, 'inputLegs': {'type': 'array', 'items': {'type': 'object', 'required': ['tokenIn'], 'properties': {'amount': {'type': 'string', 'description': 'Human decimal amount, e.g. "100". Use this OR amountRaw, not both.'}, 'tokenIn': {'type': 'string', 'description': 'Contract address, or symbol (case-insensitive).'}, 'amountRaw': {'type': 'string', 'description': "Raw integer string in tokenIn's smallest unit."}}, 'additionalProperties': False}, 'minItems': 1}, 'outputLegs': {'type': 'array', 'items': {'type': 'object', 'required': ['tokenOut', 'outputPercent'], 'properties': {'receiver': {'type': 'string', 'description': "Optional: deliver this leg's output to a different address than the signing wallet."}, 'tokenOut': {'type': 'string', 'description': 'Contract address, or symbol.'}, 'outputPercent': {'type': 'integer', 'description': 'Integer percent (1-100) of the TOTAL basket value this leg receives. Every outputLegs[].outputPercent in the request must sum to exactly 100.'}}, 'additionalProperties': False}, 'minItems': 1}, 'slippageBps': {'type': 'integer', 'description': 'Optional, 5-500, applied to every leg. Default 50.'}}, 'additionalProperties': False}
nn_quote
N:N â quotes a basket where N input tokens fund M output tokens in ONE atomic on-chain transaction. The backend runs a waterfall allocation deciding which input finances which output, then quotes the real tokenIn->tokenOut route for each resulting slice through the same provider fan-out swap_quote uses. NOT decomposable into independent swap_quote/double_quote calls â the allocation itself is the thing being computed, not just N+M separate prices for legs you already know. inputLegs[]: what you sell (tokenIn + amount or amountRaw, each). outputLegs[]: what you want back, as outputPercent â an integer percent of the TOTAL basket value, not a fixed amount, because the actual split depends on the allocation; every outputLegs[].outputPercent in the request must sum to exactly 100. Up to 10 combined input+output legs; the waterfall never produces more than inputLegs.length + outputLegs.length - 1 real on-chain legs. Returns { legs[], failures[] }. Each entry in legs[] is a real quoted tokenIn->tokenOut leg (a NormalizedQuote under .quote, plus amountIn/tokenIn/tokenOut/receiver for that slice) â this is what nn_build will execute, not a rough preview. failures[] lists any slice that found no route; a partial basket is possible and reported, never silently dropped.
Lecture seule
Accès externe
Schéma d’entrée
{'type': 'object', 'required': ['chainId', 'inputLegs', 'outputLegs'], 'properties': {'wallet': {'type': 'string', 'description': 'Wallet that will sign. Required for builds and EVM execution/history calls. On an anonymous EVM quote, pass it to make the returned quoteId executable; without it the quote is indicative.'}, 'chainId': {'type': ['integer', 'string'], 'description': 'EVM: integer from GET /v1/chains (1, 10, 56, 100, 137, 8453, 42161, 43114, 130). Solana: string from GET /v1/svm/chains ("solana-mainnet"). On EVM the multi-swap router must be deployed on the chain or the quote fails with multi_swap_not_supported_on_chain; on Solana there is no router contract, several top-level instructions in one transaction are already all-or-nothing by runtime rule.'}, 'inputLegs': {'type': 'array', 'items': {'type': 'object', 'required': ['tokenIn'], 'properties': {'amount': {'type': 'string', 'description': 'Human decimal amount, e.g. "100". Use this OR amountRaw, not both.'}, 'tokenIn': {'type': 'string', 'description': 'Contract address, or symbol (case-insensitive).'}, 'amountRaw': {'type': 'string', 'description': "Raw integer string in tokenIn's smallest unit."}}, 'additionalProperties': False}, 'minItems': 1}, 'outputLegs': {'type': 'array', 'items': {'type': 'object', 'required': ['tokenOut', 'outputPercent'], 'properties': {'receiver': {'type': 'string', 'description': "Optional: deliver this leg's output to a different address than the signing wallet."}, 'tokenOut': {'type': 'string', 'description': 'Contract address, or symbol.'}, 'outputPercent': {'type': 'integer', 'description': 'Integer percent (1-100) of the TOTAL basket value this leg receives. Every outputLegs[].outputPercent in the request must sum to exactly 100.'}}, 'additionalProperties': False}, 'minItems': 1}, 'slippageBps': {'type': 'integer', 'description': 'Optional, 5-500, applied to every leg. Default 50.'}}, 'additionalProperties': False}
prepare_signing
Synthesizes the local CLI signer invocation for one step of a swap_build plan. Does not call the Vurto backend â this only assembles the payload. You (the agent) do not need a private key and must never ask for one in chat: signing happens locally on the user's machine. RUN the command yourself as a background task (it blocks until the user approves/rejects/times out, then prints one JSON line and exits) and react to its exit â never ask the user "did you sign?". EVM supports "approve"/"transaction" steps (send tx.to/tx.data on-chain) and "signature" steps (sign step.typedData off-chain, EIP-712 â a CoW order; no gas, no transaction, no hash). expected_keys in the response tells you which result field to read: txHash for the first two, signature for the third. Solana has no steps[] and no approve: pass chainId "solana-mainnet" and step {transaction: build.transaction, executionRef: build.executionRef}. The response returns a different signer (Solana keys are not EVM keys) with the same shape, and expected_keys is signedTransaction â POST it to /v1/svm/execute, which broadcasts it and returns the signature.
Lecture seule
Idempotent
Schéma d’entrée
{'type': 'object', 'required': ['buildId', 'walletAddress', 'chainId', 'step'], 'properties': {'step': {'type': 'object', 'properties': {'tx': {'type': 'object', 'properties': {'to': {'type': 'string'}, 'data': {'type': 'string'}, 'value': {'type': 'string'}}, 'description': 'Required when type is "approve" or "transaction".'}, 'type': {'enum': ['approve', 'transaction', 'signature'], 'type': 'string', 'description': 'EVM only.'}, 'typedData': {'type': 'object', 'properties': {'types': {'type': 'object'}, 'domain': {'type': 'object'}, 'message': {'type': 'object'}, 'primaryType': {'type': 'string'}}, 'description': 'Required when type is "signature" â\x80\x94 pass steps[].typedData from swap_build verbatim.'}, 'transaction': {'type': 'string', 'description': 'Solana only: build.transaction, base64, verbatim.'}, 'executionRef': {'type': 'string', 'description': 'Solana only: build.executionRef when the build has one. Its absence is meaningful, not an omission: a route we assembled ourselves is broadcast directly, an aggregator order has to go back to the aggregator to land.'}, 'humanSummary': {'type': 'string'}}, 'description': "EVM: one entry from swap_build's steps[]. Solana: {transaction, executionRef} from the build."}, 'buildId': {'type': 'string', 'description': 'From a prior swap_build/swap_refresh response.'}, 'chainId': {'type': ['integer', 'string'], 'description': 'EVM: integer from GET /v1/chains (1, 10, 56, 100, 137, 8453, 42161, 43114, 130). Solana: string from GET /v1/svm/chains ("solana-mainnet").'}, 'walletAddress': {'type': 'string', 'description': 'The wallet the plan was built for. The signer refuses to sign if the connected wallet does not match. On Solana this is base58 and CASE-SENSITIVE: lowercasing it produces a different, non-existent address.'}}, 'additionalProperties': False}
report_execution
Reports a completed swap, closing the loop. EVM transaction: pass wallet + txHash + quoteId; never report an approve step as an execution. EVM CoW signature: pass wallet + chainId + quoteId + signature; the server reloads the stored build and submits the signed order, returning uid (there is no transaction hash for this path). Solana: pass buildId + signature; the server verifies the fee payer and transaction on the network. No API key required; a machine credential only raises limits.
Accès externe
Idempotent
Schéma d’entrée
{'type': 'object', 'properties': {'txHash': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{64}$', 'description': 'EVM transaction swap only; do not report approve hashes.'}, 'wallet': {'type': 'string', 'description': 'Wallet that will sign. Required for builds and EVM execution/history calls. On an anonymous EVM quote, pass it to make the returned quoteId executable; without it the quote is indicative.'}, 'buildId': {'type': 'string', 'description': 'Solana: buildId returned by swap_build.'}, 'chainId': {'type': ['integer', 'string'], 'description': 'EVM CoW: integer chain id. Solana may use "solana-mainnet", but buildId + signature are sufficient.'}, 'quoteId': {'type': 'string', 'description': 'EVM: quote id from the built plan.'}, 'signature': {'type': 'string', 'description': 'EVM: EIP-712 CoW signature. Solana: transaction signature.'}}, 'additionalProperties': False}
swap_build
Build a signable/sendable plan for a swap. This is the tool that does the work â an agent that only knows this tool can execute a swap end to end. Quotes and builds the best route in one call when quoteId is omitted (recommended); pass quoteId from a prior swap_quote to build exactly that route instead. No API key required: pass the wallet that will sign. A machine credential is optional and only raises your limit from the per-IP cap to the credential budget. Four things to hold onto: 1. steps[] are ORDERED and REQUIRED. Skipping an approve step guarantees a revert. 2. If simulation.status is "approval_required", sign/send only the approve step(s), do not report them as the swap execution, then call swap_build again with quoteId set to the quote.id of that build (the approved route; without it a fresh quote may pick another provider whose spender you never approved). If it is "incomplete", do not sign anything: the transaction was never independently verified. 3. If a step has type "signature", there is no transaction and never will be one for that step â what exists afterward is the uid from report_execution, not a hash. 4. If the provider is cowswap and the token sold is the chain's native asset, the transaction only REGISTERS the order â a successful receipt is not a successful swap. Use swap_status, not the receipt, to know what actually happened. 5. routeSwitch, when present, means the route you asked for refused to build (it hit its request limit) and the plan was built with another provider instead: {from, to, reason}. The quote in the plan is the route that will actually be signed. If the user picked that route themselves, say which provider replaced it before they sign.
Accès externe
Schéma d’entrée
{'type': 'object', 'required': ['chainId', 'wallet'], 'properties': {'amount': {'type': 'string', 'description': 'Human decimal amount, e.g. "100". Use this OR amountRaw, not both.'}, 'wallet': {'type': 'string', 'description': 'Wallet that will sign. Required for builds and EVM execution/history calls. On an anonymous EVM quote, pass it to make the returned quoteId executable; without it the quote is indicative.'}, 'chainId': {'type': ['integer', 'string'], 'description': 'EVM: integer from GET /v1/chains (1, 10, 56, 100, 137, 8453, 42161, 43114, 130). Solana: string from GET /v1/svm/chains ("solana-mainnet").'}, 'quoteId': {'type': 'string', 'description': 'Optional: build exactly this route from a prior swap_quote, instead of quoting fresh.'}, 'tokenIn': {'type': 'string', 'description': "Contract address (Solana: mint), or symbol (case-insensitive). A symbol matching more than one token on this chain fails with ambiguous_token and every candidate â\x80\x94 pick the address you meant and retry. On Solana only VERIFIED tokens resolve by symbol, because there anyone can mint a token using another one's symbol; an unverified token has to be named by its mint."}, 'receiver': {'type': 'string', 'description': 'Optional: deliver the output to this address instead of the signing wallet. Only providers with supportsReceiver true on the resulting quote honor it â\x80\x94 others are left out of quotes[] entirely rather than risk sending to the wrong address. supportsReceiver is present on Solana quotes too, so read it instead of assuming. On Solana, selling into native SOL with a separate destination is refused on every provider (receiver_native_sol_unsupported): closing the wrapped-SOL account sends balance and rent to whoever signs. Ask for wSOL instead.'}, 'tokenOut': {'type': 'string', 'description': 'Contract address, or symbol.'}, 'amountRaw': {'type': 'string', 'description': "Raw integer string in tokenIn's smallest unit."}, 'slippageBps': {'type': 'integer', 'description': 'Optional, a sane per-pair default applies when omitted.'}, 'maxSlippageBps': {'type': 'integer', 'description': 'Optional ceiling, 0-10000, enforced on every future refresh of this build â\x80\x94 once set it never loosens.'}}, 'additionalProperties': False}
swap_quote
Compare ranked routes across providers for a swap, without building or spending anything. Ranked by net value after gas and platform fee, not raw output, with ONE unit price for the output token across every route, so a friendlier price feed can never put a route that delivers fewer tokens on top. Each quote also carries estimatedGas, the gas in units behind the same gasUsd, if you would rather rank against a gas price you read yourself. A quote is only usable by swap_build for about 10-12 seconds â do not hold onto a quoteId and build it later, quote again instead.
Lecture seule
Accès externe
Schéma d’entrée
{'type': 'object', 'required': ['chainId', 'tokenIn', 'tokenOut'], 'properties': {'amount': {'type': 'string', 'description': 'Human decimal amount, e.g. "100". Use this OR amountRaw, not both.'}, 'wallet': {'type': 'string', 'description': 'Wallet that will sign. Required for builds and EVM execution/history calls. On an anonymous EVM quote, pass it to make the returned quoteId executable; without it the quote is indicative.'}, 'chainId': {'type': ['integer', 'string'], 'description': 'EVM: integer from GET /v1/chains (1, 10, 56, 100, 137, 8453, 42161, 43114, 130). Solana: string from GET /v1/svm/chains ("solana-mainnet").'}, 'tokenIn': {'type': 'string', 'description': "Contract address (Solana: mint), or symbol (case-insensitive). A symbol matching more than one token on this chain fails with ambiguous_token and every candidate â\x80\x94 pick the address you meant and retry. On Solana only VERIFIED tokens resolve by symbol, because there anyone can mint a token using another one's symbol; an unverified token has to be named by its mint."}, 'receiver': {'type': 'string', 'description': 'Optional: deliver the output to this address instead of the signing wallet. Only providers with supportsReceiver true on the resulting quote honor it â\x80\x94 others are left out of quotes[] entirely rather than risk sending to the wrong address. supportsReceiver is present on Solana quotes too, so read it instead of assuming. On Solana, selling into native SOL with a separate destination is refused on every provider (receiver_native_sol_unsupported): closing the wrapped-SOL account sends balance and rent to whoever signs. Ask for wSOL instead.'}, 'tokenOut': {'type': 'string', 'description': 'Contract address, or symbol.'}, 'amountRaw': {'type': 'string', 'description': "Raw integer string in tokenIn's smallest unit."}, 'slippageBps': {'type': 'integer', 'description': 'Optional, a sane per-pair default applies when omitted.'}}, 'additionalProperties': False}
swap_status
Re-checks a swap. EVM: pass wallet + executionId (the id from report_execution); for CoW ETH-flow this consults the orderbook and distinguishes order_expired_refundable from order_expired_refunded instead of trusting the registration receipt. Solana: pass signature; answers come directly from the network and may be confirmed, pending, failed or expired.
Lecture seule
Accès externe
Idempotent
Schéma d’entrée
{'type': 'object', 'required': [], 'properties': {'wallet': {'type': 'string', 'description': 'Wallet that will sign. Required for builds and EVM execution/history calls. On an anonymous EVM quote, pass it to make the returned quoteId executable; without it the quote is indicative.'}, 'signature': {'type': 'string', 'description': 'Solana: the transaction signature. Answers come from the network itself: confirmed, pending, failed, or expired (past lastValidBlockHeight the transaction can no longer enter any block).'}, 'executionId': {'type': 'string', 'description': 'EVM: the id returned by report_execution.'}}, 'additionalProperties': False}
Historique
Modifications récentes des outils
Modifié
swap_build
2 October 2026 02:41
Ajouté
swap_status
26 September 2026 02:40
Ajouté
report_execution
26 September 2026 02:40
Ajouté
prepare_signing
26 September 2026 02:40
Ajouté
nn_build
26 September 2026 02:40
Ajouté
nn_quote
26 September 2026 02:40
Ajouté
double_build
26 September 2026 02:40
Ajouté
double_quote
26 September 2026 02:40
Ajouté
swap_build
26 September 2026 02:40
Ajouté
swap_quote
26 September 2026 02:40
Découvrir
Serveurs MCP similaires
SAP MCP Server
ai.oobeprotocol.sap.mcp/sap-mcp
Provides an MCP gateway connecting SAP-related tools with Solana, DeFi, decentralized identity, and x402 payments.
FortFi Treasury MCP
io.github.rebelArtists/fortfi-treasury-mcp
Provides policy-controlled crypto treasury operations across chains, including wallets, payments, token discovery, swaps, bridges…
DPX — Institutional Cross-Border Settlement
io.github.untitledfinancial/dpx
Provides compliance-gated cross-border crypto settlement, agent registration and spending mandates, stablecoin routing, ESG and s…
Peer
io.github.zkp2p/peer
Reads Peer protocol, checkout, deposit, wallet, Peer Cash, cross-chain routing, payout, and IntentGuardian data on Base and relat…
Robyn — Gasless Cross-Chain for AI Agents
io.github.ox31461/robyn
Supports gasless cross-chain transfers, wallet and transaction checks, spending mandates, privacy-preserving messaging, and signe…
MERX - TRON Resource Exchange
exchange.merx/mcp
Manages TRON energy and bandwidth purchasing, resource monitoring, transaction cost estimation, wallet operations, token transfer…
Wisely x402 Agent-Payment Infrastructure
com.wiselyenterprisesllc/x402-agent-payment-infrastructure
Provides agent payment workflows for x402 endpoints, wallet handoffs, receipts, creator catalogs, local commerce bridges, endpoin…
AgentTools Hub
io.github.Thyphex/agenttools-hub
Offers calculators, unit and data converters, reference lookups, live crypto data, wallet utilities, and paid x402 access.