{"data":{"name":"io.github.cryptoconspiracy/vurto-swap","title":"Vurto Swap","description":"Token swaps at the best net price on 9 EVM chains and Solana. No API key, non-custodial.","version":"1.0.0","websiteUrl":"https://swap.vurto.cc/agent-api.md","repositoryUrl":null,"remotes":[{"url":"https://swap.vurto.cc/mcp","type":"streamable-http"}],"packages":[],"status":"active","isLatest":true,"publishedAt":"2026-09-24T19:34:05.331Z","updatedAt":"2026-09-24T19:34:05.331Z","source":"official-registry","verification":"official","confidence":100,"stars":null,"sources":[{"stars":null,"title":"Vurto Swap","source":"official-registry","sourceId":"io.github.cryptoconspiracy/vurto-swap","updatedAt":"2026-09-24T19:34:05.331Z","confidence":100,"websiteUrl":"https://swap.vurto.cc/agent-api.md","description":"Token swaps at the best net price on 9 EVM chains and Solana. No API key, non-custodial.","verification":"official","repositoryUrl":null}],"toolIndex":{"tools":[{"serverName":"io.github.cryptoconspiracy/vurto-swap","endpointFingerprint":"6149b5dca9a74b2716d18ebca5e090f9e8b5310d02fd6bb7d6cfa81d47fd8605","name":"check_access","title":null,"description":"The Check access of a paying wallet, the proof check_credits asks for (access), valid 24 hours. Hand here the signature of check_access_challenge with its nonce and message, unchanged. The challenge is consumed here, once, so the access goes only to whoever holds that signature: keep it secret, it lists this payer's Checks. A challenge of another kind (destination_challenge, the claim of another charge) is refused with check_access_challenge_invalid. Returns { access, payer, expiresAt }.","inputSchema":{"type":"object","properties":{"wallet":{"type":"string","description":"The paying wallet."},"nonce":{"type":"string","description":"From check_access_challenge."},"message":{"type":"string","description":"From check_access_challenge, unchanged."},"signature":{"type":"string","description":"EVM: the EIP-191 or EIP-712 signature. Solana: the ed25519 signature in base58."},"transaction":{"type":"string","description":"Solana: the signed proofTransaction (base64), never sent."}},"required":["wallet","nonce","message"],"additionalProperties":false},"annotations":{"title":"Check: get the access of a paying wallet","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"definitionHash":"bee43bcf45cc4a7243bc394c6b12d3a178a25bc1ab7b701f1700f3d0a0378d9d","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T02:46:21.504Z","metadataTrust":"untrusted"},{"serverName":"io.github.cryptoconspiracy/vurto-swap","endpointFingerprint":"6149b5dca9a74b2716d18ebca5e090f9e8b5310d02fd6bb7d6cfa81d47fd8605","name":"check_access_challenge","title":null,"description":"Only for check_credits (listing a payer's Checks by wallet); paying, analysing and reading one Check need only its id. The challenge of the Check access, of its own: the text says what the signature grants (read and use the paid Checks of this wallet for 24 hours), the site and until when to sign, and that it moves no funds and authorizes no destination. chainId is any network check_info lists: on EVM it is the domain of typedData, on Solana it gives proofTransaction. Returns { nonce, message, expiresAt, buildId (check-access-<nonce>), typedData (EVM) | proofTransaction (Solana) }. Sign it with prepare_signing (EVM: a signature step with typedData; Solana: the proofTransaction, never sent), then call check_access. Never use destination_challenge or destination_authorize for the Check: they do not give an access.","inputSchema":{"type":"object","properties":{"wallet":{"type":"string","description":"The paying wallet."},"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\")."}},"required":["wallet","chainId"],"additionalProperties":false},"annotations":{"title":"Check: the text the paying wallet signs for its access","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"definitionHash":"689591d68b44d144acad7d4357c20ffae6d0768607c5773c183fe03e9e1661bd","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T02:46:21.504Z","metadataTrust":"untrusted"},{"serverName":"io.github.cryptoconspiracy/vurto-swap","endpointFingerprint":"6149b5dca9a74b2716d18ebca5e090f9e8b5310d02fd6bb7d6cfa81d47fd8605","name":"check_analyze","title":null,"description":"Spends ONE paid credit on the networks it paid: evmWallet on the EVM networks paid, solanaWallet on Solana if it was paid. Give a wallet for each family the credit paid (check_wallet_missing otherwise) and none for a family it did not (check_family_not_paid). The free screening (OFAC SDN, issuer freeze) and Scorechain read each wallet once, Merkle Science (through Didit) once per network, at most the networks paid plus 2 lookups in all. Returns check with status used, target { wallets { evm, svm }, networks }, seal (the worst network: red, risk found; yellow, medium risk; grey, a paid reading did not come back; green, no risk, Merkle no_data included), result and screening (of the worst network), networks [{ chainId, seal, result { verdict, risk, tools [{ tool, result clear|flagged|unavailable, score 0-100, severity, summary, category, factors, sourceOfFunds, destinationOfFunds, analyzedAt, fromHistory }], details }, screening }] and events (the real steps, with ms). The same credit and the same wallets again answers what is stored, with no provider call; other wallets are check_credit_used (409). Two calls at once run ONE analysis (the other gets check_running, 409). check_unreadable (503): a reading did not answer, the credit is still valid, call again with the same arguments (details.missing names tool:network). analysis_tool_unavailable (503): a tool is down and the credit was not touched.","inputSchema":{"type":"object","properties":{"checkId":{"type":"string","description":"The Check id from check_charge (CHK-...). It is the capability of this Check: keep it, and keep it private."},"evmWallet":{"type":"string","description":"The EVM wallet to analyse (0x...), when the credit paid an EVM network."},"solanaWallet":{"type":"string","description":"The Solana wallet to analyse (base58, case-sensitive), when the credit paid Solana."},"wallet":{"type":"string","description":"Instead of the two above, for a credit of one family: the wallet, its family read from the address."}},"required":["checkId"],"additionalProperties":false},"annotations":{"title":"Check: analyse a wallet with a credit","readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"definitionHash":"3917d50d50e47411db20234cae786213c7a5ba4c1cc7f8182bc261daf8e0ce6a","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T02:46:21.504Z","metadataTrust":"untrusted"},{"serverName":"io.github.cryptoconspiracy/vurto-swap","endpointFingerprint":"6149b5dca9a74b2716d18ebca5e090f9e8b5310d02fd6bb7d6cfa81d47fd8605","name":"check_buy_challenge","title":null,"description":"Step one of buying a Check (owner, 12/11/2026: only a wallet that passes the free screening buys, so it signs first). The challenge of its own, scope buy: the text says this wallet pays for a Check and is screened before buying, valid 10 minutes, and that it moves no funds and authorizes no destination. chainId is any network check_info lists. Returns { nonce, message, expiresAt, buildId (check-buy-<nonce>), typedData (EVM) | proofTransaction (Solana) }. Sign it with prepare_signing, then call check_buy_proof.","inputSchema":{"type":"object","properties":{"wallet":{"type":"string","description":"The paying wallet."},"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\")."}},"required":["wallet","chainId"],"additionalProperties":false},"annotations":{"title":"Check: the text the paying wallet signs to buy","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"definitionHash":"cf605bac35aa74b157e3972824d8625ccc16a2ec7fe993e3c8ee2ba983a01f7a","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T02:46:21.504Z","metadataTrust":"untrusted"},{"serverName":"io.github.cryptoconspiracy/vurto-swap","endpointFingerprint":"6149b5dca9a74b2716d18ebca5e090f9e8b5310d02fd6bb7d6cfa81d47fd8605","name":"check_buy_proof","title":null,"description":"Hand here the signature of check_buy_challenge with its nonce and message, unchanged. The challenge is consumed once, the wallet goes through the free screening (OFAC, issuer freezes), and only if it passes it returns { buyProof (vcb_..., 10 minutes, secret), payer, screening: passed, expiresAt }. A blocked wallet gets payer_blocked (403). A challenge of another kind (check_access_challenge, destination_challenge) is refused with check_buy_challenge_invalid. Pass buyProof to check_charge.","inputSchema":{"type":"object","properties":{"wallet":{"type":"string","description":"The paying wallet."},"nonce":{"type":"string"},"message":{"type":"string","description":"From check_buy_challenge, unchanged."},"signature":{"type":"string","description":"EVM: the EIP-191 or EIP-712 signature. Solana: the ed25519 signature in base58."},"transaction":{"type":"string","description":"Solana: the signed proofTransaction (base64), never sent."}},"required":["wallet","nonce","message"],"additionalProperties":false},"annotations":{"title":"Check: prove the paying wallet and screen it","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"definitionHash":"be5b6f5d84e2a8dfcd365f9ec42410fc4bc26b084209bf03b06c77599a8214ad","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T02:46:21.504Z","metadataTrust":"untrusted"},{"serverName":"io.github.cryptoconspiracy/vurto-swap","endpointFingerprint":"6149b5dca9a74b2716d18ebca5e090f9e8b5310d02fd6bb7d6cfa81d47fd8605","name":"check_charge","title":null,"description":"Builds the USDC transfer of the Check price for the networks chosen (networks, from check_info checkNetworks: perNetwork each, never above maximum) from payer to the analysis fee wallet on chainId (any network of check_info networks), for the payer to sign. The credit is bound to those networks. Needs buyProof, the purchase proof of THIS payer from check_buy_proof (the payer signed and passed the free screening); without it, or with another wallet's, check_buy_proof_required (401). The server also measures the sender on-chain. Returns { check { id, status awaiting_payment, amount, amountRaw, token, feeWallet }, transaction, plan (buildId check-<id>, steps on EVM or transaction on Solana), report }. check.id (CHK-...) is the capability of this Check: whoever holds it reports the payment, analyses and reads the result, so keep it private and keep it to come back to the result. Each call makes a NEW Check, good for 30 minutes (expiresAt): a transaction mined after that is credited by the price of now on the networks it covers (check_report_payment). Pass checkId of one still awaiting payment and in its time to rebuild its transfer (the Solana one expires in about a minute). Sign the transaction exactly as returned: it carries the mark of THIS Check (16 bytes after the transfer arguments on EVM, a memo on Solana). A transfer you build yourself is refused with analysis_payment_rejected reason charge_not_tied after the money left: do not pay again, prove the wallet with destination_challenge (receiver = details.feeWallet, chargeId = the check id, chargeTxHash = that hash) and destination_authorize, then report the same hash again. Refusals: analysis_tool_unavailable (503, a tool is down: nothing is built), check_credit_limit (409), payer_blocked (403), check_network_unsupported (400), check_networks_required (400), check_already_paid (409, checkId of a paid Check), check_charge_expired (409), kyc_required (403, tools with crystal and no approved KYC), invalid_check (400, an unknown tool), check_unavailable (503, also crystal while it has no price).","inputSchema":{"type":"object","properties":{"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\")."},"buyProof":{"type":"string","description":"The purchase proof of this payer from check_buy_proof (vcb_..., 10 minutes). Secret."},"payer":{"type":"string","description":"The paying wallet, the one that signs the transfer (0x on EVM, base58 on Solana)."},"networks":{"type":"array","items":{"type":"string"},"description":"The networks to analyse, from check_info checkNetworks (e.g. [\"1\",\"8453\",\"solana-mainnet\"]). The price is perNetwork times these, never above maximum."},"tools":{"type":"array","items":{"type":"string","enum":["crystal"]},"description":"Optional: [\"crystal\"] adds Crystal on every network chosen, at the optionalTools price of check_info. Only for a payer whose identity check (KYC) is approved: otherwise kyc_required (403) and nothing is built. Scorechain and Merkle Science always run."},"checkId":{"type":"string","description":"Optional: a Check still awaiting payment, to rebuild its transfer instead of making a new Check."}},"required":["chainId","payer","networks","buyProof"],"additionalProperties":false},"annotations":{"title":"Check: build the payment","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"definitionHash":"93911c8189874005380bc4fb20c66fff1807d27ab099c9164f6c835b87888601","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T02:46:21.504Z","metadataTrust":"untrusted"},{"serverName":"io.github.cryptoconspiracy/vurto-swap","endpointFingerprint":"6149b5dca9a74b2716d18ebca5e090f9e8b5310d02fd6bb7d6cfa81d47fd8605","name":"check_credits","title":null,"description":"The paid Checks of a paying wallet, newest first, 50 a page with nextCursor: unused credits (status paid), a reading in flight or interrupted (status running: call check_analyze again with its target to resume) and the analyses already run (status used, with target and seal), to find a Check id you lost. The one check_* tool that reads by wallet, so the one that needs access, the Check access of this payer (check_access_challenge, then check_access).","inputSchema":{"type":"object","properties":{"payer":{"type":"string","description":"The paying wallet."},"access":{"type":"string","description":"The Check access of this payer from check_access (vca_...). Secret: it lists this payer's Checks."},"cursor":{"type":"string","description":"nextCursor of the previous page, for the next 50."}},"required":["payer","access"],"additionalProperties":false},"annotations":{"title":"Check: list this payer's Checks","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"ca954a79ac61e9073cee10617b7a384c47045c697f5c6ea126b2ea1c6d4d5b08","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T02:46:21.504Z","metadataTrust":"untrusted"},{"serverName":"io.github.cryptoconspiracy/vurto-swap","endpointFingerprint":"6149b5dca9a74b2716d18ebca5e090f9e8b5310d02fd6bb7d6cfa81d47fd8605","name":"check_info","title":null,"description":"The paid Check of any wallet: price { maximum (dollars, the most a Check costs, every network), perNetwork (one consultation), amount (= maximum, for older clients), currency }; tools: the base tools switched on now (Scorechain and Merkle Science; one Vurto switched off is not listed); the price of a Check is perNetwork times the networks chosen, never above maximum. checkNetworks [{ chainId, family }] (the seven to choose: 1, 10, 56, 137, 8453, 42161, solana-mainnet), networks [{ chainId, family, token (the USDC that pays), feeWallet }] (where it is paid: the nine EVM networks and solana-mainnet), creditLimit and chargeValidSeconds (1800). optionalTools [{ tool: \"crystal\", kycRequired: true, perNetwork, maximum }]: Crystal on top of Scorechain and Merkle Science, with the price per network and the maximum WITH it; empty when it is not sold or is switched off. check_charge leaves a tool that is switched off out of a new purchase, without charging it, and says so in skippedChecks; with no tool that gives a score left (Merkle Science or Crystal), check_unavailable (503). Public, no proof needed.","inputSchema":{"type":"object","properties":{},"additionalProperties":false},"annotations":{"title":"Check: price, networks and fee wallets","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"1ee218303ebbccecd7ad71fb966ecf3d4e19f15c78365f71dce3b53b773ecdc7","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T02:46:21.504Z","metadataTrust":"untrusted"},{"serverName":"io.github.cryptoconspiracy/vurto-swap","endpointFingerprint":"6149b5dca9a74b2716d18ebca5e090f9e8b5310d02fd6bb7d6cfa81d47fd8605","name":"check_report_payment","title":null,"description":"Hand the Check payment to the server once it is mined, by the Check id. The server reads it on-chain (the payer the charge names signed it, the network USDC reached the fee wallet, at least the price, after the charge, the mark) and reserves the hash for this Check only. 201 with check.status paid: the credit exists. analysis_payment_pending (409): not mined yet, call again in a few seconds. analysis_payment_rejected (400, details.reason): this transaction does not pay this Check. tx_already_used (409): the hash already paid something else. check_not_found (404): no Check has this id. Mined after the charge's 30 minutes it still credits by the price of now on the networks it covers (lateCharge true, check.paidNetworks may be fewer); check_charge_expired (409) only when it covers none. check_credit_limit (409) and payer_blocked (403) are checked again here; nothing is reserved, so the same hash reported later still counts. Repeating the same hash is safe; never pay again.","inputSchema":{"type":"object","properties":{"checkId":{"type":"string","description":"The Check id from check_charge (CHK-...). It is the capability of this Check: keep it, and keep it private."},"txHash":{"type":"string","description":"The EVM transaction hash or the Solana signature."}},"required":["checkId","txHash"],"additionalProperties":false},"annotations":{"title":"Check: report the payment","readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"definitionHash":"cd095a6cf5843ee169d6aecce8657c4cfe110d5d5f9faa6a8aa816fc04cea838","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T02:46:21.504Z","metadataTrust":"untrusted"},{"serverName":"io.github.cryptoconspiracy/vurto-swap","endpointFingerprint":"6149b5dca9a74b2716d18ebca5e090f9e8b5310d02fd6bb7d6cfa81d47fd8605","name":"check_result","title":null,"description":"Reads one Check by its id, as stored (status, target, seal, result, screening, networks, events). Never calls a paid provider. An unknown id gets check_not_found (404).","inputSchema":{"type":"object","properties":{"checkId":{"type":"string","description":"The Check id from check_charge (CHK-...). It is the capability of this Check: keep it, and keep it private."}},"required":["checkId"],"additionalProperties":false},"annotations":{"title":"Check: read a stored result","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"30e26993b2eb89a3a101b16e53eecbbd4123b6352371f44f8dc6dcec91ea7bfd","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T02:46:21.504Z","metadataTrust":"untrusted"},{"serverName":"io.github.cryptoconspiracy/vurto-swap","endpointFingerprint":"6149b5dca9a74b2716d18ebca5e090f9e8b5310d02fd6bb7d6cfa81d47fd8605","name":"destination_authorize","title":null,"description":"Hand over the signature of destination_challenge. The server checks it is the paying wallet's signature over that exact challenge, for that receiver and chain, unexpired and unused, and then lets builds deliver to that receiver for 30 minutes. Nothing else unlocks it. Errors: signature_invalid, authorization_expired, authorization_replayed, authorization_destination_mismatch, authorization_network_mismatch.","inputSchema":{"type":"object","properties":{"wallet":{"type":"string"},"receiver":{"type":"string"},"chainId":{"type":["integer","string"]},"nonce":{"type":"string","description":"From destination_challenge."},"message":{"type":"string","description":"From destination_challenge, unchanged."},"signature":{"type":"string","description":"EVM: 0x hex, EIP-712 over typedData or EIP-191 over message. Solana: base58 over message."},"transaction":{"type":"string","description":"Solana only: the signed proofTransaction, base64, instead of signature."}},"required":["wallet","receiver","chainId","nonce","message"],"additionalProperties":false},"annotations":{"title":"Authorize another destination with the wallet signature","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"definitionHash":"0a130a55b3d75b52edc4b49f87ab996905952688ab73394e00c5e7c4c849ce2b","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T02:46:21.504Z","metadataTrust":"untrusted"},{"serverName":"io.github.cryptoconspiracy/vurto-swap","endpointFingerprint":"6149b5dca9a74b2716d18ebca5e090f9e8b5310d02fd6bb7d6cfa81d47fd8605","name":"destination_challenge","title":null,"description":"Destination lock. A receiver different from the signing wallet is refused by swap_build, double_build and nn_build (403 destination_not_authorized) until the paying wallet signs an authorization for that exact address on that chain. This returns {nonce, message, expiresAt} plus, on EVM, typedData (EIP-712, the same fields) and, on Solana, proofTransaction (a memo that can never land, for Ledger). Show the user the full receiver and network and get their explicit yes; then sign: on EVM call prepare_signing with step {type: \"signature\", typedData} and run it; on Solana sign message (or proofTransaction) with the wallet. Then call destination_authorize. Never sign this without the user asking to send to that address. Paying an invoice to its receiver does not unlock through this, but an invoice with payerChecks asks for the same proof of the paying wallet (payer_signature_required).","inputSchema":{"type":"object","properties":{"wallet":{"type":"string","description":"The wallet that pays and signs."},"receiver":{"type":"string","description":"The full destination address. Solana base58 is case-sensitive."},"chainId":{"type":["integer","string"],"description":"EVM chain id, or \"solana-mainnet\"."},"chargeId":{"type":"string","description":"Only to claim a payment of yours refused with charge_not_tied or tx_for_another_payment: the loteId or invoice id. Goes with chargeTxHash, and the report goes again to the route it was refused on; the text you sign names both, and an authorization without them does not claim anything."},"chargeTxHash":{"type":"string","description":"Only with chargeId: the hash of the payment you are claiming."}},"required":["wallet","receiver","chainId"],"additionalProperties":false},"annotations":{"title":"Ask to send the output to another wallet","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"definitionHash":"30ace420e5255ea878a26482d0d0638afa5f8d04ecc4e76bc4ab68747329b434","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T02:46:21.504Z","metadataTrust":"untrusted"},{"serverName":"io.github.cryptoconspiracy/vurto-swap","endpointFingerprint":"6149b5dca9a74b2716d18ebca5e090f9e8b5310d02fd6bb7d6cfa81d47fd8605","name":"double_build","title":null,"description":"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.","inputSchema":{"type":"object","properties":{"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\")."},"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."},"legA":{"type":"object","properties":{"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\")."},"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."},"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 — 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."},"tokenOut":{"type":"string","description":"Contract address, or symbol."},"amount":{"type":"string","description":"Human decimal amount, e.g. \"100\". Use this OR amountRaw, not both."},"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."},"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 — 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. Building with a receiver needs the paying wallet's signed authorization first (destination_challenge, then destination_authorize), or the build fails with destination_not_authorized."},"quoteId":{"type":"string","description":"Optional: build exactly this route from a prior double_quote."}},"additionalProperties":false},"legB":{"type":"object","properties":{"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\")."},"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."},"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 — 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."},"tokenOut":{"type":"string","description":"Contract address, or symbol."},"amount":{"type":"string","description":"Human decimal amount, e.g. \"100\". Use this OR amountRaw, not both."},"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."},"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 — 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. Building with a receiver needs the paying wallet's signed authorization first (destination_challenge, then destination_authorize), or the build fails with destination_not_authorized."},"quoteId":{"type":"string"}},"additionalProperties":false},"maxSlippageBps":{"type":"integer","description":"Optional ceiling, 0-10000, applied to both legs."}},"required":["chainId","wallet","legA","legB"],"additionalProperties":false},"annotations":{"title":"Build a two-leg plan","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"definitionHash":"7293902537fd8f25fa64c9a675747e2cd26ea2f346e3cec2fa8dc22d307a97ce","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T02:46:21.504Z","metadataTrust":"untrusted"},{"serverName":"io.github.cryptoconspiracy/vurto-swap","endpointFingerprint":"6149b5dca9a74b2716d18ebca5e090f9e8b5310d02fd6bb7d6cfa81d47fd8605","name":"double_quote","title":null,"description":"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.","inputSchema":{"type":"object","properties":{"mode":{"type":"string","enum":["out","in"],"description":"\"out\": one source, two destinations. \"in\": two sources, one destination."},"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\")."},"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."},"legA":{"type":"object","required":["tokenIn","tokenOut"],"properties":{"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\")."},"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."},"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 — 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."},"tokenOut":{"type":"string","description":"Contract address, or symbol."},"amount":{"type":"string","description":"Human decimal amount, e.g. \"100\". Use this OR amountRaw, not both."},"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."},"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 — 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. Building with a receiver needs the paying wallet's signed authorization first (destination_challenge, then destination_authorize), or the build fails with destination_not_authorized."}},"additionalProperties":false},"legB":{"type":"object","required":["tokenIn","tokenOut"],"properties":{"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\")."},"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."},"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 — 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."},"tokenOut":{"type":"string","description":"Contract address, or symbol."},"amount":{"type":"string","description":"Human decimal amount, e.g. \"100\". Use this OR amountRaw, not both."},"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."},"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 — 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. Building with a receiver needs the paying wallet's signed authorization first (destination_challenge, then destination_authorize), or the build fails with destination_not_authorized."}},"additionalProperties":false}},"required":["mode","chainId","legA","legB"],"additionalProperties":false},"annotations":{"title":"Compare two-leg routes","readOnlyHint":true,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"definitionHash":"b4173a75631edb869e11152e743557af1b50478c92bfebefaeb417dc728f6b08","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T02:46:21.504Z","metadataTrust":"untrusted"},{"serverName":"io.github.cryptoconspiracy/vurto-swap","endpointFingerprint":"6149b5dca9a74b2716d18ebca5e090f9e8b5310d02fd6bb7d6cfa81d47fd8605","name":"invoice_analysis_pay","title":null,"description":"Do not use it on an invoice whose split.rule is \"flat\" or \"brackets\" (created since 10/11/2026): its fee is inside the payment and already pays the analysis of both wallets, and the call is refused with analysis_included_in_fee (409). Without checks: the charge of the invoice creator, for an older invoice with payerChecks or paid checks whose analysis.status is awaiting_payment (see invoice_get). Builds ONE USDC transfer of analysis.amount (the price written when that invoice was created: 0.10 Scorechain, 0.40 Merkle Science, 0.50 both) to the Vurto fee wallet (analysis.to), signed by the invoice creator. Sign the charge transaction exactly as returned: it carries the mark that ties the payment to this charge (16 bytes after the transfer arguments on EVM, a memo on Solana). A transfer you build yourself is refused with analysis_payment_rejected, reason charge_not_tied, after the money has left; do not pay again, prove the wallet (destination_challenge with wallet = payer, receiver = details.feeWallet, chargeId = this charge and chargeTxHash = that hash, then destination_authorize) and report the same hash again. Nothing is signed or sent here. The free screening runs first on the receiving wallet and on the creator: a rejected wallet gets screening_blocked (403) and nothing is built; a screening that cannot be read gets screening_unavailable (503). payer must be the creator (the receiving wallet when the invoice was created without a session, which is always the case over MCP); any other wallet gets not_invoice_creator (403) before anything is built. plan has the same shape as invoice_pay (prepare_signing; on Solana POST the signed transaction to /v1/svm/execute), then call invoice_report_analysis_payment with the hash or signature. Paying it from another token is a swap built over the HTTP API (POST /v1/swap on EVM, POST /v1/svm/swap on Solana) from the creator wallet with tokenOut = analysis.token, receiver = analysis.to and invoiceId = this invoice, sized so the guaranteed minimum covers analysis.amountRaw; report its hash or signature to invoice_report_analysis_payment. On EVM only a swap built that way counts (the transaction must match that build); on Solana the Vurto fee wallet must be the only wallet whose USDC rises in it, and it must be the transaction we built, which carries the mark. The minimum must stay between the charge and 10% above it (charge_swap_below_amount, charge_swap_above_amount). A swap that only pays a fee to the same wallet does not count. Errors: no_paid_check, analysis_already_paid, analysis_included_in_fee, invoice_already_paid, not_invoice_creator, screening_blocked, screening_unavailable. Invoices of the new model (Solana, and EVM networks with a split contract): this is how the PAYER buys the paid analysis of the RECEIVING wallet, with their own money, before paying. Pass payer = the paying wallet and checks ([\"merkle-science\"], [\"scorechain\"] or both). Since 16/11/2026 the charge is one consultation at the fixed price (https://docs.vurto.cc/fees), the same with one tool or two and whatever the amount, in the network USDC: invoice_get receiverAnalysisFee gives it before you build ({available: true, amount} in dollars) or says the amount is below the minimum ({available: false, minimum}). Below the minimum the call is refused with amount_below_analysis_minimum (400, details.minimum), and on an invoice in a token that is not a dollar stablecoin with stablecoin_required (400). Adding a tool to an analysis already paid and fresh is a new purchase at the same fee. A tool that already ran on that wallet for this payer up to 30 days ago, with no movement measured on the wallet since (on EVM: the same nonce, native balance and balance of every dollar stablecoin of the network, and no contract code; on Solana: no new confirmed signature and the same SOL and associated dollar stablecoin accounts; a read that fails, or any other token or NFT, is not seen, and then the provider is called), comes from the history instead of the provider; each paid tool of the report carries analyzedAt, the day it ran. A new purchase needs no wallet proof, the payment itself proves it; giving it up and changing the tools of an existing charge do (destination_challenge/destination_authorize for this invoice's receiver; without it payer_signature_required, 401). The free screening of both wallets must pass (screening_blocked 403). It returns receiverAnalysis {status: awaiting_payment, amount, to} and the USDC transfer to sign; report it with invoice_report_analysis_payment (txHash and payer). The fee follows the invoice amount, never the number of tools, and the analysis never goes inside the payment. A charge opened before 11/11/2026 and not paid is rewritten with the fee the next time it is built, and reporting a hash on it pays the recorded value only when the network mined it before this deploy; otherwise the charge is rewritten and the answer is analysis_charge_replaced (409): build and sign again. There is no free reuse: every purchase pays the fee. analysis_tool_unavailable (503) when the tool is not answering: nothing is charged. An open, unpaid analysis does not hold invoice_pay, because anyone can open one naming a wallet: pay and report it BEFORE invoice_pay if you want its verdict to count. A paid one goes stale when the receiving wallet moves, and then invoice_pay refuses with receiver_analysis_unpaid (409) until it is redone. checks: [] gives it up. The result comes back without the receiving wallet. Paying it from another token exists on Solana only: POST /v1/svm/swap from the payer with receiver = the fee wallet (receiverAnalysis.to) and invoiceId = this invoice. On EVM the payer pays with the USDC transfer. A tool in checks that Vurto switched off is left out and not charged (skippedChecks); when every tool asked was switched off the answer is only { skippedChecks }, and an open charge is not touched.","inputSchema":{"type":"object","properties":{"id":{"type":"string","description":"INV-XXXX-XXXX or the 8-character id."},"payer":{"type":"string","description":"With checks: the paying wallet, which buys the analysis of the receiving wallet. Without checks: the invoice creator wallet, which pays the analysis it asked for (payerChecks, or the older paid checks of an invoice created before 07/11/2026)."},"checks":{"type":"array","items":{"type":"string","enum":["scorechain","merkle-science","crystal"]},"description":"The paid analyses of the RECEIVING wallet the payer buys. [] gives up an unpaid one, and only [] does: on an invoice whose payer analysis is split, leaving it out is invalid_check (400)."},"walletProof":{"type":"string","description":"Only when checks name \"crystal\": the walletProof of the PAYER from kyc_proof (vkp_..., 30 minutes). The destination authorization does not prove the wallet for Crystal; without the proof, kyc_wallet_signature_required (401)."}},"required":["id","payer"],"additionalProperties":false},"annotations":{"title":"Build the paid-analysis payment","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"definitionHash":"8f34c97f78a817a32264ef7d57aaf9cf26cea0ac97baa9e91ce5c6e5ff51f327","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T02:46:21.504Z","metadataTrust":"untrusted"},{"serverName":"io.github.cryptoconspiracy/vurto-swap","endpointFingerprint":"6149b5dca9a74b2716d18ebca5e090f9e8b5310d02fd6bb7d6cfa81d47fd8605","name":"invoice_create","title":null,"description":"Create a payment request: who receives, which token, how much, on which network. Returns invoice.id, invoice.label (INV-XXXX-XXXX, what people copy), invoice.url (share this, after paying the analysis charge if the invoice has one; it previews with the QR on WhatsApp and Telegram) and invoice.qr (PNG). No signature or API key needed. New invoices only receive VERIFIED dollar stablecoins on the network allowlist, even without paid analysis. A new invoice without payerChecks carries no fee; with payerChecks, the analysis fee of both wallets is deducted from the amount through the split (see payerChecks). Previously created invoices keep their terms. Tokens resolve by address or symbol — an unverified token is refused because a cloned \"USDC\" with its own pool would let the creator sell a fake at any price. The payer can pay with ANY token on that network. Paid checks in checks are closed for new invoices (paid_check_moved): use payerChecks. the free screening of the receiving wallet must pass for the invoice to be created (receiver_blocked 403, screening_unavailable 503), and payerChecks adds the paid analysis of both wallets, paid by the fee deducted from the amount. A paid tool in payerChecks that Vurto switched off is left out and not charged, and the answer lists it in skippedChecks (never an error).","inputSchema":{"type":"object","properties":{"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\")."},"recipient":{"type":"string","description":"Who receives: a wallet (EVM 0x address, or base58 on Solana, case-sensitive) or a Vurto user as \"@handle\". With \"@handle\" the Vurto Profile picks one of that user's wallets on this network (random among the ones they marked for regular or, with confidential, private transfers; the rotation only moves after a confirmed payment), the invoice carries recipientHandle, and the free screening runs on the wallet picked. On a regular invoice the payment transaction still carries that wallet; only the private one keeps it from the payer. recipient_unavailable (400) is the same answer for a handle that does not exist and one with no wallet on this network."},"token":{"type":"string","description":"Token to receive: address/mint or symbol of a verified dollar stablecoin on the network allowlist. Other tokens return stablecoin_required, even without paid analysis."},"amount":{"type":"string","description":"Human decimal amount, e.g. \"100\". Decimals come from the token list, not from you."},"memo":{"type":"string","description":"Optional note, up to 80 chars, visible to anyone with the link."},"confidential":{"type":"boolean","description":"true creates a private invoice, paid through the Vurto Private Contract. It exists only where that contract is published for this network and token: elsewhere 400 private_coming_soon and nothing is created. It takes no payerChecks (private_invoice_checks): the contract runs its own paid analysis package, and the fee is charged at the contract entry. It is paid ONLY on its page (the link), never through invoice_pay (409 private_invoice_vault_only), because a direct transfer would show both wallets on-chain; whoever pays needs an approved KYC to enter the contract. Reading it gives confidential: true, privateContract: true and recipient null. Only the boolean true asks for it: any other value except false is refused with private_coming_soon, so a string never turns into a common invoice you think is private."},"checks":{"type":"array","items":{"type":"string","enum":["scorechain","merkle-science","crystal"]},"description":"Closed for new invoices (07/11/2026): a paid check here (\"scorechain\", \"merkle-science\") is refused with paid_check_moved, on every network. Use payerChecks for the analysis of the paying wallet, and the payer buys the analysis of the receiving wallet with invoice_analysis_pay. Invoices created before keep their charge, paid by the creator with invoice_analysis_pay. Any other value is refused with invalid_check."},"payerChecks":{"type":"array","items":{"type":"string","enum":["scorechain","merkle-science","crystal"]},"description":"Solana and EVM networks with invoiceSplit=true in /v1/chains, stablecoin invoices only: USDC, USDT (including USDT0), PYUSD, USDG and USD1, by verified address on each network. Availability differs by network. You (the receiver) choose the PAID analysis of the PAYER wallet; your own wallet goes through the same tools. One analysis fee covers both wallets, the same with one tool or two: two consultations at the fixed price (https://docs.vurto.cc/fees), deducted from the amount through the split. invoice.split comes back with rule \"flat\", fee and receiverAmount: the payer sends the amount and you receive receiverAmount. There is no charge to pay first, so the link can be shared right away. Below the minimum: amount_below_analysis_minimum (400, details.minimum). It runs when the payer calls invoice_pay, after the free screening passes, and no field switches it off. The result goes to you alone, on the site, signed in with this wallet: invoice_get here does not carry it. \"crystal\" (Crystal Risk Check, direct, since 17/11/2026) is only for a PROVEN wallet whose identity check (KYC) is approved: an agent proves the receiving wallet with kyc_proof_challenge, prepare_signing and kyc_proof, and passes the walletProof it returns (30 minutes) in this call; without it the call is refused with kyc_wallet_signature_required (401), and without the KYC with kyc_required (403); nothing is created. The KYC itself is done once by the person, on the site. It is sold at the same price per consultation as Merkle Science, on top of the fixed one, so the fee and the minimum rise with it, and it covers Ethereum, Optimism, BNB Chain, Polygon, Base, Arbitrum One, Avalanche and Solana (not Gnosis nor Unichain). It reads on the same 0 to 100 scale as Merkle Science; a wallet Crystal has no data on is never called clean (it reads as not read, and does not block a payment by itself). Refused: split_not_available_on_chain where no split contract is configured, stablecoin_required for tokens outside the network allowlist, amount_below_analysis_minimum below the minimum, analysis_tool_unavailable (503) when the tool is not answering, and nothing is created or charged."},"walletProof":{"type":"string","description":"Only with \"crystal\": the walletProof of THIS wallet (the receiver on invoice_create, the payer on payout_batch) from kyc_proof (vkp_..., 30 minutes). Secret. It proves the wallet is yours; the KYC itself is read from that wallet."}},"required":["chainId","recipient","token","amount"],"additionalProperties":false},"annotations":{"title":"Create an invoice","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"definitionHash":"d2a7d44396ad30e1e465b6158d055d26259a4e3b7aac6b32ccc38698315b28fa","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T02:46:21.504Z","metadataTrust":"untrusted"},{"serverName":"io.github.cryptoconspiracy/vurto-swap","endpointFingerprint":"6149b5dca9a74b2716d18ebca5e090f9e8b5310d02fd6bb7d6cfa81d47fd8605","name":"invoice_get","title":null,"description":"Read an invoice by id (INV-XXXX-XXXX, with or without dashes): requested amount, token, network, receiver, status (open or paid), the paying transaction once paid, and received (the raw amount measured on-chain so far). Pending payments are re-checked on-chain by the read, at most two per read and each at most every 15 seconds. checks lists the older paid screening of an invoice created before 07/11/2026 ([] for new ones), which paying runs on both wallets once analysis.status is paid; payerChecks lists the analysis of the paying wallet the receiver asked and paid for. receiverAnalysisFee, on an open invoice where the payer can buy the receiving wallet analysis (invoice_analysis_pay with checks): {available: true, amount} is the charge in dollars, one consultation at the fixed price, or {available: false, minimum} when the amount is below the minimum and there is nothing to buy. For such an older invoice, analysis.report (Merkle Science only) carries, once the invoice is paid, the detail of both wallets; for payerChecks the result goes to the creator alone, on the site, and does not come here (over the web app, a signed session of the creator also sees the detail of the receiving wallet while it is open): score, severity, summary, main risk category, risk factors and sourceOfFunds (the largest origins of the money, up to 8, with category, entity, percentage, USD amount and direct or indirect exposure). confidential is true on a private invoice, with recipient null here. With privateContract: true it is paid only on its page through the Vurto Private Contract (invoice_pay answers private_invoice_vault_only) and paidTx stays null. With privateContract false it is a private invoice created before 14/10/2026: it can no longer be paid (invoice_pay answers private_invoice_paused), and its paying transaction, once paid, shows the receiver on-chain.","inputSchema":{"type":"object","properties":{"id":{"type":"string","description":"INV-XXXX-XXXX or the 8-character id."}},"required":["id"],"additionalProperties":false},"annotations":{"title":"Read an invoice","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"definitionHash":"c55edb49cbc06713c82f03e96cd1d4e0a41b8958fefe069122113a7fc6ffd684","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T02:46:21.504Z","metadataTrust":"untrusted"},{"serverName":"io.github.cryptoconspiracy/vurto-swap","endpointFingerprint":"6149b5dca9a74b2716d18ebca5e090f9e8b5310d02fd6bb7d6cfa81d47fd8605","name":"invoice_pay","title":null,"description":"Build the plan to pay an invoice from payer, with the token payer holds (default: the invoice token). Nothing is signed or sent here. Both wallets are screened first (payer_blocked, receiver_blocked); when the invoice has checks [\"scorechain\"] (see invoice_get), the creator chose and paid the Scorechain sanctions API, so this call sends the payer wallet and the receiver wallet to Scorechain, a third party (an invoice created before 22/10/2026 with the then-free Scorechain keeps running it without a charge). method \"transfer\": same token, a direct transfer built from the stored invoice (no fee, no gain; the receiver sees the payer as sender). method \"swap\": another token; amountIn is computed so the GUARANTEED minimum output covers the requested amount, the route is always the one with GAIN when there is one, and the output goes straight to the receiver (the transaction is public and signed by the payer, so the receiver can see the paying wallet on-chain). Any surplus over the requested amount goes to the receiver. plan has the same shape as a swap_build plan: on EVM sign steps[] in order with prepare_signing (approve steps first, then the transaction); on Solana pass {transaction, executionRef} to prepare_signing and POST the signed transaction to /v1/svm/execute. If simulation.status is approval_required, send the approve and call invoice_pay again. When the invoice has paid checks, the creator must have paid the analysis first (analysis_unpaid, 409). With \"merkle-science\" this call then sends the payer wallet and the receiver wallet to Didit/Merkle Science, and a HIGH or CRITICAL risk (score 70 or more) refuses with payer_blocked or receiver_blocked; the detail shows in invoice_get analysis.report. At most 3 different payer wallets are analysed per invoice by each paid check; a 4th gets analysis_attempts_exceeded (429). Since 23/10/2026 the payer proves the wallet BEFORE the paid analysis runs on it: over MCP that proof is the destination authorization signed by the payer for this invoice's receiver (destination_challenge with wallet = payer, receiver = the invoice receiver, chainId of the invoice, sign the message, then destination_authorize). Without it this call returns payer_signature_required (401) and no analysis slot is spent. Invoices with payerChecks and split.rule \"flat\" (since 16/11/2026; \"brackets\" from 10/11): nothing is paid first; the paid analysis runs HERE on BOTH wallets, the payer and the receiver, after the free screening, and the plan is the split that delivers split.receiverAmount to the receiver and split.fee to the Vurto fee wallet. A Vurto Dead Alive donation (invoice_get analysisOf \"payer\") takes as split.fee 2% of the amount, no floor, plus the price of each paid analysis the streamer chose for the donor wallet (since 16/11/2026, https://docs.vurto.cc/fees; payerChecks says which ran); before signing, split.fee must be at most 10% of the amount on a donation, at most 2.40 USD, two consultations of 1.20 at most each (and below the amount), on a \"flat\" invoice, and at most 5% of the amount on a \"brackets\" one (pure percent since 16/11/2026, no fixed amount above it). The smallest donation is where its fee fits 10%, the same on EVM and Solana. Older invoices with payerChecks: the creator pays the analysis first (analysis_unpaid, 409), and it runs HERE, on the payer wallet, after its free screening passes; no field switches it off. The payer proves the wallet first (destination_challenge/destination_authorize; payer_signature_required 401). Up to 2 different payer wallets run here; after that the plan comes out with warning, and the analysis runs on the report of a confirmed payment of the whole amount, with the result going to the creator. A transaction that reaches the receiver settles the invoice: the analysis refuses nothing after the money has arrived. analysis_tool_unavailable (503) means try again in a few minutes. The plan delivers the whole amount to the receiver. An invoice that carries split keeps it (see invoice_get split): method \"transfer\" is then ONE payment transaction (on EVM, sign the exact approve step first, then pay on the invoice split contract: VurtoInvoiceSplitV2 since 16/11/2026, VurtoInvoiceSplit before; on the V2 with a token whose EIP-2612 permit checks out (its DOMAIN_SEPARATOR matches the domain read from it: the USDC of Circle does, USDT and the BNB pegs do not) the plan also has plan.permit, an EIP-2612 typed data you may sign instead of the approve to send one payWithPermit transaction with the arguments of the pay step plus v, r, s) with split.receiverAmount to the receiver and split.fee to the Vurto fee wallet, and only that transaction settles it; analysis_offer_suspended (403) applies only to those. With another token, method \"swap_then_transfer\": plan is a swap into the PAYER's own wallet and next is this same call again, to build the split; on Solana method \"swap\" does both in one transaction. A receiver analysis (invoice_analysis_pay) only counts here if it was paid and reported first: open and unpaid, it does not hold this call, and the answer carries warning and receiverAnalysis. Paid and stale gets receiver_analysis_unpaid (409), and a rejected receiver gets receiver_blocked. With method \"swap\", pass invoiceId to prepare_signing so it points to the invoice report. Sign the transaction as returned: it is tied to this invoice and payer, so another invoice to the same recipient cannot claim it (tx_for_another_payment). A transfer built by hand, a native transfer and a ready-made route of a provider are not, and the first report the network confirms wins. If a transaction of yours ends as tx_for_another_payment, prove the wallet (destination_challenge with chargeId = the invoice id and chargeTxHash = the hash, then destination_authorize) and report it again. Then call invoice_report_payment with the hash (EVM) or signature (Solana). Errors: price_moved (the minimum fell below the request between quote and build — call again), no_route, native_sol_only (an invoice in SOL can only be paid in SOL), invoice_already_paid, private_invoice_vault_only (a private invoice: pay it on its page, through the Vurto Private Contract, never with this tool), private_invoice_paused (a private invoice created before 14/10/2026, which can no longer be paid). Both wallets are screened before the plan is built: the paying one (payer_blocked) and the receiving one (receiver_blocked). screening_unavailable (503) means the screening could not finish, try again in a few seconds.","inputSchema":{"type":"object","properties":{"id":{"type":"string","description":"INV-XXXX-XXXX or the 8-character id."},"payer":{"type":"string","description":"The wallet that will sign and pay, on the invoice network."},"tokenIn":{"type":"string","description":"Optional: address/mint or symbol of the token the payer pays with. Omit to pay in the invoice token."},"slippageBps":{"type":"integer","description":"Optional, default 50. The guaranteed minimum is computed after it, so a tighter slippage asks the payer for less."}},"required":["id","payer"],"additionalProperties":false},"annotations":{"title":"Build an invoice payment","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"definitionHash":"995574538055d6f749af2864247fd9022e4f59d717dc5c6e87515ba14391d725","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T02:46:21.504Z","metadataTrust":"untrusted"},{"serverName":"io.github.cryptoconspiracy/vurto-swap","endpointFingerprint":"6149b5dca9a74b2716d18ebca5e090f9e8b5310d02fd6bb7d6cfa81d47fd8605","name":"invoice_report_analysis_payment","title":null,"description":"Hand the analysis payment transaction to the server once it is mined. The server reads it on-chain: a direct USDC transfer (the USDC of the invoice network) from the invoice creator to the Vurto fee wallet, of at least analysis.amount, newer than the invoice, never used for another analysis or invoice. screening_blocked (403): the free screening rejects the receiving wallet or the creator, and the payment is not registered. analysis_payment_pending (409): not mined yet, call again in a few seconds. analysis_payment_rejected (400) with details.reason (charge_not_tied, wrong_token, wrong_destination, amount_too_low, sender_not_creator, not_a_transfer, tx_reverted, tx_before_invoice): that transaction does not pay this analysis. charge_not_tied means it is not the transaction we built: do not pay again, prove the wallet (destination_challenge with receiver = details.feeWallet, chargeId = this invoice and chargeTxHash = that hash, then destination_authorize) and report the same hash again. Repeating a hash already recorded returns the status, and the stored result only with the receipt the first record returned (receiverAnalysis.receipt, sent back as receipt) or a proven wallet. tx_already_used (409): the hash already paid something else. Once paid, analysis.status is paid and the invoice can be paid. When the payer bought the analysis of the receiving wallet, pass payer too (the charge of the creator needs only txHash): the transaction must be signed by that payer and only the fee wallet may gain USDC in it (the split payment of an invoice never pays it, usdc_to_other_wallet); once paid the receiver analysis runs right away and receiverAnalysis.result comes back (verdict and the paid tools, never the receiving wallet).","inputSchema":{"type":"object","properties":{"id":{"type":"string","description":"INV-XXXX-XXXX or the 8-character id."},"txHash":{"type":"string","description":"EVM transaction hash, or the Solana signature, of the analysis payment."},"payer":{"type":"string","description":"The paying wallet that bought the receiver analysis, required when it was bought with checks. Leave it out for the analysis the creator paid."}},"required":["id","txHash"],"additionalProperties":false},"annotations":{"title":"Report the paid-analysis payment","readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"definitionHash":"d8f3737ea3e7c4bd32632bccfabbb88edb6db4c960b4ef918afd80f6b1b0e108","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T02:46:21.504Z","metadataTrust":"untrusted"},{"serverName":"io.github.cryptoconspiracy/vurto-swap","endpointFingerprint":"6149b5dca9a74b2716d18ebca5e090f9e8b5310d02fd6bb7d6cfa81d47fd8605","name":"invoice_report_payment","title":null,"description":"Hand the payment transaction to the server, right after sending it. The server reads the transaction on-chain and measures what reached the receiver in the invoice token; the payer must be the signer and the transaction must be newer than the invoice. The payer is screened again here (payer_blocked: a sanctioned or issuer-frozen payer does not count as paid, and once the network confirms the transaction the refusal is kept in the 10-year analysis record). With a paid analysis on the invoice and no prior proof of the payer wallet, the transaction itself is the proof: until the network confirms it the call returns payment_pending (409) and records nothing, so call again once it is mined. Pending until mined; invoice_get re-checks. An invoice holds at most 5 pending and 30 unconfirmed payments; past that, too_many_pending (429) until the network confirms the transaction, and a confirmed one is always accepted, so call again once it is mined. A hash pays each receiver once (tx_already_used once it confirmed another invoice of the same receiver and token); different receivers in one transaction are a batch payout.","inputSchema":{"type":"object","properties":{"id":{"type":"string","description":"INV-XXXX-XXXX or the 8-character id."},"payer":{"type":"string","description":"The wallet that signed the payment."},"txHash":{"type":"string","description":"EVM transaction hash, or the Solana signature."},"method":{"type":"string","enum":["transfer","swap"],"description":"From invoice_pay.method."}},"required":["id","payer","txHash"],"additionalProperties":false},"annotations":{"title":"Report an invoice payment","readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"definitionHash":"1161dd44c13961f137a315e4e822d9bb92c7d016935083638b5663fa54b93faf","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T02:46:21.504Z","metadataTrust":"untrusted"},{"serverName":"io.github.cryptoconspiracy/vurto-swap","endpointFingerprint":"6149b5dca9a74b2716d18ebca5e090f9e8b5310d02fd6bb7d6cfa81d47fd8605","name":"kyc_proof","title":null,"description":"Hand here the signature of kyc_proof_challenge with its nonce and message, unchanged. The challenge is consumed once and it returns { walletProof (vkp_..., 30 minutes, secret), wallet, expiresAt }. Pass walletProof to invoice_create or payout_batch when they ask for \"crystal\" (API: header X-Wallet-Proof). It proves possession only: without an approved KYC on that wallet the call still answers kyc_required (403). A challenge of another kind is refused with kyc_proof_challenge_invalid.","inputSchema":{"type":"object","properties":{"wallet":{"type":"string","description":"The wallet proved."},"nonce":{"type":"string"},"message":{"type":"string","description":"From kyc_proof_challenge, unchanged."},"signature":{"type":"string","description":"EVM: the EIP-191 or EIP-712 signature. Solana: the ed25519 signature in base58."},"transaction":{"type":"string","description":"Solana: the signed proofTransaction (base64), never sent."}},"required":["wallet","nonce","message"],"additionalProperties":false},"annotations":{"title":"KYC proof: hand the signature, get walletProof","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"definitionHash":"f9bb4b7272515f668ca8fdc48576f9f07f3d5a83d14532abe605ad2454df1752","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T02:46:21.504Z","metadataTrust":"untrusted"},{"serverName":"io.github.cryptoconspiracy/vurto-swap","endpointFingerprint":"6149b5dca9a74b2716d18ebca5e090f9e8b5310d02fd6bb7d6cfa81d47fd8605","name":"kyc_proof_challenge","title":null,"description":"Step one of using Crystal from an agent (owner, 17/11/2026: the API, the MCP and the CLI need the KYC for Crystal too). Crystal runs only for a wallet whose identity check (KYC) is approved, and only when the caller proves it holds that wallet. This challenge of its own, scope kyc, says the wallet is yours so Vurto may use its KYC for the analyses that require it, valid 10 minutes to sign; it moves no funds, approves no payment and authorizes no destination. chainId is any network check_info lists (it picks the family; on EVM, the typed data domain). Returns { nonce, message, expiresAt, buildId (kyc-proof-<nonce>), typedData (EVM) | proofTransaction (Solana) }. Sign it with prepare_signing, then call kyc_proof. The KYC itself is done once by the person on the site; this only proves the wallet.","inputSchema":{"type":"object","properties":{"wallet":{"type":"string","description":"The wallet to prove: the receiver of the invoice, or the payer of the batch."},"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\")."}},"required":["wallet","chainId"],"additionalProperties":false},"annotations":{"title":"KYC proof: the text the wallet signs","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"definitionHash":"a279be414262ab02c85408b852a755180c9b2c033056fe4bb6ccfb0ed40b2795","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T02:46:21.504Z","metadataTrust":"untrusted"},{"serverName":"io.github.cryptoconspiracy/vurto-swap","endpointFingerprint":"6149b5dca9a74b2716d18ebca5e090f9e8b5310d02fd6bb7d6cfa81d47fd8605","name":"nn_build","title":null,"description":"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.","inputSchema":{"type":"object","properties":{"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\")."},"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."},"inputLegs":{"type":"array","minItems":1,"items":{"type":"object","required":["tokenIn"],"properties":{"tokenIn":{"type":"string","description":"Contract address, or symbol (case-insensitive)."},"amount":{"type":"string","description":"Human decimal amount, e.g. \"100\". Use this OR amountRaw, not both."},"amountRaw":{"type":"string","description":"Raw integer string in tokenIn's smallest unit."}},"additionalProperties":false}},"outputLegs":{"type":"array","minItems":1,"items":{"type":"object","required":["tokenOut","outputPercent"],"properties":{"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."},"receiver":{"type":"string","description":"Optional: deliver this leg's output to a different address than the signing wallet."}},"additionalProperties":false}},"slippageBps":{"type":"integer","description":"Optional, 5-500, applied to every leg. Default 50."}},"required":["chainId","wallet","inputLegs","outputLegs"],"additionalProperties":false},"annotations":{"title":"Build a basket plan","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"definitionHash":"085fa81392d927bb136a09bed0dc08fb40c5f5b4c1002caf40be2f1d88a9d05b","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T02:46:21.504Z","metadataTrust":"untrusted"},{"serverName":"io.github.cryptoconspiracy/vurto-swap","endpointFingerprint":"6149b5dca9a74b2716d18ebca5e090f9e8b5310d02fd6bb7d6cfa81d47fd8605","name":"nn_quote","title":null,"description":"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.","inputSchema":{"type":"object","properties":{"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."},"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."},"inputLegs":{"type":"array","minItems":1,"items":{"type":"object","required":["tokenIn"],"properties":{"tokenIn":{"type":"string","description":"Contract address, or symbol (case-insensitive)."},"amount":{"type":"string","description":"Human decimal amount, e.g. \"100\". Use this OR amountRaw, not both."},"amountRaw":{"type":"string","description":"Raw integer string in tokenIn's smallest unit."}},"additionalProperties":false}},"outputLegs":{"type":"array","minItems":1,"items":{"type":"object","required":["tokenOut","outputPercent"],"properties":{"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."},"receiver":{"type":"string","description":"Optional: deliver this leg's output to a different address than the signing wallet."}},"additionalProperties":false}},"slippageBps":{"type":"integer","description":"Optional, 5-500, applied to every leg. Default 50."}},"required":["chainId","inputLegs","outputLegs"],"additionalProperties":false},"annotations":{"title":"Compare basket routes","readOnlyHint":true,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"definitionHash":"856fc1530681d393eb8b3dab15e60bdabb5d33118e389e41ab98d1d263cbb1e8","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T02:46:21.504Z","metadataTrust":"untrusted"},{"serverName":"io.github.cryptoconspiracy/vurto-swap","endpointFingerprint":"6149b5dca9a74b2716d18ebca5e090f9e8b5310d02fd6bb7d6cfa81d47fd8605","name":"payout_batch","title":null,"description":"Payroll and supplier payouts to many wallets in one batch, on Solana and on the nine EVM chains (those with loteSplit true in GET /v1/chains). EVM: up to 50 wallets, in a verified USD stablecoin (USDC, USDT, PYUSD, USDG, USD1) — the batch is ONE transaction through the Vurto IBBs split contract, and the payer pays the exact amounts PLUS a 0.1% Vurto fee on the total. Solana: up to 50 wallets, in any token the payer holds (no swap, no fee), packed into one or a few transactions. The paying wallet and every receiving wallet are screened first (OFAC SDN list and, on Solana, the issuer freeze of six stablecoins); a blocked payer refuses with payer_blocked (403), and one blocked recipient refuses the whole batch with receiver_blocked (403) and details.index of that row, before anything is created. Each recipient becomes a regular invoice (history, on-chain verification). EVM returns { invoices[], evm: { split, invoiceIds[], base, fee, batchRef, deadline, steps[] } }: sign steps IN ORDER with prepare_signing (the approve step first, then the pay transaction step), send them, and call payout_report_payment with the PAY transaction hash and evm.invoiceIds. Solana returns { invoices[], transactions[] }: sign each transactions[i].transaction (prepare_signing, then POST to /v1/svm/execute) and call payout_report_payment with that signature and its invoiceIds. checks (stablecoin token, both families) adds a PAID analysis of every destination, turning the batch into two steps. Scorechain runs on every EVM chain and Solana; Merkle Science (Didit) does not cover Gnosis, Unichain or Avalanche, so a check the chain lacks refuses with check_not_available_on_chain. With checks the response carries no transactions[]: Solana returns { invoices[], charge: { buildId, transaction, loteId, total, token, tokenDecimals, feeWallet, recipients }, reused[] } (prepare_signing with buildId and step {transaction}, POST to /v1/svm/execute); EVM returns the same charge plus charge.step, a transaction step ready for prepare_signing. Sign the charge transaction exactly as returned: it carries the mark that ties the payment to this charge (16 bytes after the transfer arguments on EVM, a memo on Solana). A transfer you build yourself is refused with analysis_payment_rejected, reason charge_not_tied, after the money has left; do not pay again, prove the wallet (destination_challenge with wallet = payer, receiver = details.feeWallet, chargeId = this charge and chargeTxHash = that hash, then destination_authorize) and report the same hash again. A Solana transaction expires in about a minute: POST /v1/payouts/charge/transaction with loteId and payer returns the same charge fresh, without another batch; if it also returns reportedTxHash, send that hash to payout_charge instead of signing, or you may pay twice. To pay the fee with another token, swap_build with tokenOut = charge.token, receiver = charge.feeWallet and loteId, with a minimum between charge.total and 10% above it. Then call payout_charge with that loteId, the charge hash/signature and the payer to analyse every destination, drop the blocked and get the approved send: Solana as transactions[] to sign, EVM as evm (the IBBs approve + pay steps of ONLY the approved, with the 0.1% fee recomputed on the approved base, with buildId, chainId and invoiceIds; if evm.deadline passed, call payout_charge again for a fresh one). Not re-charging a wallet already analysed (reused[]) needs the payer's signed session, which the API does not carry, so via MCP every destination is charged and reused[] is empty. Errors: batch_not_available_on_chain (an EVM chain without the IBBs contract), stablecoin_required (a checks batch in a non-stablecoin token), check_not_available_on_chain (a paid check the chain lacks, e.g. Merkle on Gnosis/Unichain/Avalanche), batch_duplicate_recipient (add the amounts up in one row), batch_self_payment, too_many_recipients, token_not_listed, screening_unavailable (503, try again).","inputSchema":{"type":"object","properties":{"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\")."},"token":{"type":"string","description":"Mint or symbol of a verified token, e.g. \"USDC\". Every recipient is paid in it. On EVM it must be a USD stablecoin; with checks on Solana it must be a USD stablecoin too."},"payer":{"type":"string","description":"The wallet that signs and pays. EVM 0x address, or base58 on Solana."},"recipients":{"type":"array","minItems":1,"maxItems":50,"items":{"type":"object","required":["wallet","amount"],"properties":{"wallet":{"type":"string","description":"Receiving wallet (EVM 0x address, or base58 on Solana, case-sensitive), or a Vurto user as \"@handle\": the Vurto Profile picks one of that user's wallets marked for regular transfers (the batch transaction carries it). The payer cannot be one of them, and each wallet appears once (up to 50, on EVM and on Solana)."},"amount":{"type":"string","description":"Human amount, e.g. \"500\" or \"120.5\". Exactly this reaches the wallet."},"memo":{"type":"string","description":"Optional note, up to 80 characters."}},"additionalProperties":false}},"checks":{"type":"array","items":{"type":"string","enum":["scorechain","merkle-science","crystal"]},"description":"Optional, both families, stablecoin token: the paid analysis tools to run on every destination (\"crystal\" only for a payer with an approved KYC, proven by walletProof from kyc_proof: kyc_wallet_signature_required 401 without the proof, kyc_required 403 without the KYC; it adds its own price per destination). Turns the batch into the two-step charge flow above. Since 16/11/2026 charge.total is one consultation at the fixed price per destination (https://docs.vurto.cc/fees), the same with one tool or two, the reused ones included (their analysis comes from the history, the fee stays); a destination below the minimum goes without the paid analysis (free screening only), stays out of the charge and is listed in withoutAnalysis. payout_reuse with the amounts previews the total. A tool that already ran on that wallet for this payer up to 30 days ago, with no movement measured on the wallet since (on EVM: the same nonce, native balance and balance of every dollar stablecoin of the network, and no contract code; on Solana: no new confirmed signature and the same SOL and associated dollar stablecoin accounts; a read that fails, or any other token or NFT, is not seen, and then the provider is called), comes from the history instead of the provider; approved[].analyzedAt has, the day it ran."},"walletProof":{"type":"string","description":"Only with \"crystal\": the walletProof of THIS wallet (the receiver on invoice_create, the payer on payout_batch) from kyc_proof (vkp_..., 30 minutes). Secret. It proves the wallet is yours; the KYC itself is read from that wallet."}},"required":["chainId","token","payer","recipients"],"additionalProperties":false},"annotations":{"title":"Build a batch payout","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"definitionHash":"b9ce0a9e20e0c1bcb8291fc5b17f195fe858614cf771b4fa00ec1c10f7a6b381","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T02:46:21.504Z","metadataTrust":"untrusted"}],"endpoints":[{"endpointFingerprint":"6149b5dca9a74b2716d18ebca5e090f9e8b5310d02fd6bb7d6cfa81d47fd8605","protocol":"streamable-http","status":"indexed","toolCount":34,"observedAt":"2026-11-19T02:46:21.504Z"}],"authentication":"unknown"},"connectionConfigurations":{"status":"ready","authentication":"not embedded","clients":{"Claude Desktop":{"mcpServers":{"io.github.cryptoconspiracy/vurto-swap":{"url":"https://swap.vurto.cc/mcp"}}},"Cursor":{"mcpServers":{"io.github.cryptoconspiracy/vurto-swap":{"url":"https://swap.vurto.cc/mcp"}}},"VS Code":{"servers":{"io.github.cryptoconspiracy/vurto-swap":{"type":"http","url":"https://swap.vurto.cc/mcp"}}}}},"resourceType":"mcp-server","callable":true,"runtime":{"callable":true,"protocols":["mcp"]},"interfaces":[{"protocol":"mcp","transport":"streamable-http","url":"https://swap.vurto.cc/mcp"}],"profile":{"apiVersion":"1","schemaVersion":"1","id":"mcp-server:io.github.cryptoconspiracy%2Fvurto-swap","resourceType":"mcp-server","canonicalUrl":"https://www.agentsjunction.com/api/v1/servers/io.github.cryptoconspiracy%2Fvurto-swap","name":"io.github.cryptoconspiracy/vurto-swap","description":"Token swaps at the best net price on 9 EVM chains and Solana. No API key, non-custodial.","interfaces":[{"protocol":"mcp","transport":"streamable-http","url":"https://swap.vurto.cc/mcp"}],"capabilities":[],"identity":{"source":"official-registry","websiteUrl":"https://swap.vurto.cc/agent-api.md","repositoryUrl":null,"version":"1.0.0"},"verification":{"state":"official","confidence":100},"operations":{"resourceType":"mcp-server","name":"io.github.cryptoconspiracy/vurto-swap","status":"online","lastCheckedAt":"2026-11-20T09:18:01.719Z","lastSuccessfulCheck":"2026-11-20T09:18:01.719Z","latencyMs":323,"consecutiveFailures":0,"isStale":false,"checks":{"endpointReachable":true,"protocolValid":true,"agentCardValid":null,"mcpHandshakeValid":true},"lastSeen":null,"lastSuccessfulInteraction":null,"lastHealthCheck":"2026-11-20T09:18:01.719Z","source":{"type":"health-check","url":null},"observedAt":"2026-11-20T09:18:01.719Z"},"security":null,"timestamps":{"createdAt":"2026-09-24T19:34:05.331Z","updatedAt":"2026-09-24T19:34:05.331Z","observedAt":"2026-11-20T09:18:01.719Z"},"compatibility":{"serverVersion":"1.0.0","protocolVersions":[{"protocol":"mcp","version":null}]}}}}