{"name":"VeTrade Trading and App MCP","version":"0.6.0","protocolVersion":"2025-03-26","docs":"https://vetrade.vet/developers/ai/mcp","description":"VeTrade provides swap, transfer, limit-order, recurring-buy and VET conversion planning, wallet and VeChain reads, market history and current app guides. Start with list_app_guides for feature discovery or tools/list for available operations. Hosted tools never sign or submit.","tools":[{"name":"transfer","title":"Transfer","description":"Use this when you need the following behavior: Build a signer-bound VeTrade transfer execution package from human-friendly inputs. Recipient may be a VeChain address or a .vet name. Do not use this to sign or broadcast a transaction."},{"name":"swap_transfer_exact_in","title":"Swap Transfer Exact In","description":"Use this when you need the following behavior: Build a signer-bound VeTrade exact-input swap-transfer execution package from human-friendly inputs. Recipient may be a VeChain address or a .vet name. Do not use this to sign or broadcast a transaction."},{"name":"swap_transfer_exact_out","title":"Swap Transfer Exact Out","description":"Use this when you need the following behavior: Build a signer-bound VeTrade exact-output swap-transfer execution package from human-friendly inputs. Recipient may be a VeChain address or a .vet name. Do not use this to sign or broadcast a transaction."},{"name":"quote","title":"Quote","description":"Use this when you need the following behavior: Read a VeTrade swap quote from human-friendly inputs. Use this by default for market price, current price, quote, and rate requests. Do not use this to sign or broadcast a transaction."},{"name":"swap","title":"Swap","description":"Use this when you need the following behavior: Build a signer-bound VeTrade swap execution package from human-friendly inputs. This is the default instant-on MCP entry point for swaps. Do not use this to sign or broadcast a transaction."},{"name":"create_limit_order","title":"Create Limit Order","description":"Use this when you need the following behavior: Build a signer-bound VeTrade limit-order execution package from human-friendly inputs. This is the default instant-on MCP entry point for creating limit orders. Do not use this to sign or broadcast a transaction."},{"name":"cancel_limit_order","title":"Cancel Limit Order","description":"Use this when you need the following behavior: Build a signer-bound VeTrade cancellation execution package. This is the default instant-on MCP entry point for limit-order cancellations. Do not use this to sign or broadcast a transaction."},{"name":"quote_swap","title":"Quote Swap","description":"Use this when you need the following behavior: Create a quote-only VeChain swap or trade plan through VeTrade. Use this advanced tool when you want routing, min output, and warnings without an execution package. Do not use this to sign or broadcast a transaction."},{"name":"prepare_swap_bundle","title":"Prepare Swap Bundle","description":"Use this when you need the following behavior: Create a wallet-bound VeChain swap or trade bundle through VeTrade with raw clauses, decoded calls, and optional simulation. Use this advanced tool when you need lower-level control than swap. Do not use this to sign or broadcast a transaction."},{"name":"inspect_swap_readiness","title":"Inspect Swap Readiness","description":"Use this when you need the following behavior: Prepare a wallet-bound swap bundle, validate it, run a compact readiness preflight, and return an agent-friendly summary without the full bundle payload. Use this advanced tool for low-level readiness inspection. Do not use this to sign or broadcast a transaction."},{"name":"validate_swap_bundle","title":"Validate Swap Bundle","description":"Use this when you need the following behavior: Simulate a previously prepared VeChain swap or trade bundle against the current VeChain node before execution. Do not use this to sign or broadcast a transaction."},{"name":"list_supported_tokens","title":"List Supported Tokens","description":"Use this when you need the following behavior: Return the public token registry that VeTrade uses for VeChain swap, trading, and limit-order references. Do not use this to sign or broadcast a transaction."},{"name":"list_supported_token_refs","title":"List Supported Token References","description":"Use this when you need the following behavior: Return a compact supported-token list with symbol, name, address, and decimals. Use this when you want lighter token resolution before calling get_token_details or planning tools. Do not use this to sign or broadcast a transaction."},{"name":"get_token_details","title":"Get Token Details","description":"Use this when you need the following behavior: Return the full VeTrade token-registry metadata for one supported token. Provide symbol, address, or both from a prior token-list response. Do not use this to sign or broadcast a transaction."},{"name":"resolve_supported_tokens","title":"Resolve Supported Tokens","description":"Use this when you need the following behavior: Resolve one or more token symbols or addresses into full VeTrade token metadata. Use this when a prompt names tokens like VTHO and VET and you want the exact metadata list before planning. Do not use this to sign or broadcast a transaction."},{"name":"get_wallet_balances","title":"Get Wallet Balances","description":"Use this when you need the following behavior: Read VET, VTHO, and optional supported-token balances for one wallet address or .vet name. Use this before execution when you want to confirm balances without signing anything. Do not use this to sign or broadcast a transaction."},{"name":"get_token_allowances","title":"Get Token Allowances","description":"Use this when you need the following behavior: Read ERC20 allowance amounts for one owner and spender across supported tokens. Native VET and VTHO are skipped because they do not use ERC20 allowance approvals. Do not use this to sign or broadcast a transaction."},{"name":"get_execution_readiness","title":"Get Execution Readiness","description":"Use this when you need the following behavior: Run a read-only preflight for a prepared VeTrade bundle: estimate gas cost from clause inspection, confirm VTHO or VET sufficiency, inspect ERC20 balances and allowance shortfalls, and report whether the prepared bundle looks ready for local submission. Do not use this to sign or broadcast a transaction."},{"name":"prepare_limit_order","title":"Prepare Limit Order","description":"Use this when you need the following behavior: Prepare a VeTrade limit-order creation bundle on VeChain. Use this when you need raw clauses for a new limit order, but keep signing and submission local. Do not use this to sign or broadcast a transaction."},{"name":"inspect_limit_order_creation_readiness","title":"Inspect Limit Order Creation Readiness","description":"Use this when you need the following behavior: Prepare a new VeTrade limit-order bundle, validate it, run a compact readiness preflight, and return an agent-friendly summary without the full bundle payload. Do not use this to sign or broadcast a transaction."},{"name":"list_limit_orders","title":"List Limit Orders","description":"Use this when you need the following behavior: List a maker address limit orders through VeTrade. Active unfiltered orders prefer on-chain reads, while filtered or historical queries use the indexed API fallback. Do not use this to sign or broadcast a transaction."},{"name":"prepare_limit_order_cancellation","title":"Prepare Limit Order Cancellation","description":"Use this when you need the following behavior: Prepare a VeTrade limit-order cancellation bundle on VeChain, including optional vVET unwrap behavior when the order was created from native VET. Do not use this to sign or broadcast a transaction."},{"name":"inspect_limit_order_cancellation_readiness","title":"Inspect Limit Order Cancellation Readiness","description":"Use this when you need the following behavior: Prepare a VeTrade limit-order cancellation bundle, validate it, run a compact readiness preflight, and return an agent-friendly summary without the full bundle payload. Do not use this to sign or broadcast a transaction."},{"name":"get_limit_order_status","title":"Get Limit Order Status","description":"Use this when you need the following behavior: Read the on-chain status for a VeTrade limit order, including amount remaining, fill records, and unwrap options. Do not use this to sign or broadcast a transaction."},{"name":"thor_get_block","title":"Thor Get Block","description":"Use this when you need the following behavior: Read a VeChainThor block by revision, block number, or block id. Use best for the current head block and block number. Do not use this to sign or broadcast a transaction."},{"name":"thor_get_transaction","title":"Thor Get Transaction","description":"Use this when you need the following behavior: Read a VeChainThor transaction by tx id and include its receipt when available. Do not use this to sign or broadcast a transaction."},{"name":"thor_get_account","title":"Thor Get Account","description":"Use this when you need the following behavior: Read a VeChainThor account, contract, or .vet name state, including VET, VTHO, code presence, and optional bytecode preview. Do not use this to sign or broadcast a transaction."},{"name":"thor_get_events","title":"Thor Get Events","description":"Use this when you need the following behavior: Read VeChainThor event logs from the configured node using address/topic filters. Do not use this to sign or broadcast a transaction."},{"name":"thor_decode_event","title":"Thor Decode Event","description":"Use this when you need the following behavior: Lookup and decode a VeChainThor event log using topic0, topics, data, and the vechain.energy signature API. Do not use this to sign or broadcast a transaction."},{"name":"thor_lookup_signature","title":"Thor Lookup Signature","description":"Use this when you need the following behavior: Lookup a function method id or event topic hash through sig.api.vechain.energy. Do not use this to sign or broadcast a transaction."},{"name":"list_app_guides","title":"Discover VeTrade features","description":"Use this when you need the following behavior: Use this to discover current VeTrade product guides, including recurring buys, liquidity, Automatic Optimization, Auto Compound, Liquidity Boost, bridges, wallet history, approvals, alerts and Telegram. Returns documentation, not live service availability or wallet data. Use read_app_guide for steps and supported actions. Do not use this to sign or broadcast a transaction."},{"name":"read_app_guide","title":"Read a VeTrade feature guide","description":"Use this when you need the following behavior: Use this to read an exact guide from list_app_guides, including current feature limits, costs and wallet review steps. Content is generated from the same source as the app help. Static documentation is not a quote, wallet read, transaction authorization or execution evidence. Do not use this to sign or broadcast a transaction."},{"name":"get_recurring_order","title":"Inspect a recurring buy at best block","description":"Use this when you need the following behavior: Use this to inspect one owner-bound recurring order, funding and allowance directly at canonical best-chain state, without relying on the order index. Due is eligibility, not guaranteed execution. Amounts are raw token units. Do not use this to sign or broadcast a transaction."},{"name":"prepare_recurring_order","title":"Prepare a recurring-buy schedule","description":"Use this when you need the following behavior: Use this to prepare unsigned recurring-buy creation and approval clauses from explicit raw-unit terms. Reuses the app contract helpers, verifies chain and contract version, reads allowance and simulates as the owner at best block. Never signs or submits. No live purchase quote or USD minimum check is performed: review current estimated input value (the app minimum is $1), spending cap, unlimited approval, balance and gas in the wallet before signing. Do not use this to sign or broadcast a transaction."},{"name":"prepare_recurring_order_action","title":"Prepare a recurring-buy change","description":"Use this when you need the following behavior: Use this to prepare unsigned pause, resume or cancel clauses for an existing recurring order. Refreshes owner, order state, funding and approval directly from the chain, then simulates. Cancellation is permanent only after local signing and confirmation. Pending purchases may complete first. Does not sign, submit or renew revoked approval. Do not use this to sign or broadcast a transaction."},{"name":"build_trade_link","title":"Open a VeTrade review","description":"Use this when you need the following behavior: Use this for a VeTrade review link: swap, limit order, recurring buy, VET conversion, dust, market, send, liquidity, pools, Boost, bridge, activity, approvals, alerts, rewards, order lists or volume. This does not quote, sign or execute. Recurring links prefill tokens and amount only. Wrap and other app entry links do not prefill fields; select settings in the app. Do not use this to sign or broadcast a transaction."},{"name":"list_recurring_orders","title":"Read recurring buys","description":"Use this when you need the following behavior: Use this to inspect one wallet's recurring buys, funding, approvals and pagination against canonical best-chain state. Due means eligible, not guaranteed execution. Missing or stale data is an error, not an empty wallet. This never creates, pauses, resumes or cancels orders. Do not use this to sign or broadcast a transaction."},{"name":"get_recurring_order_history","title":"Read recurring purchase history","description":"Use this when you need the following behavior: Use this for recorded purchases of a recurring order. Amounts are raw token units; use token decimals. An empty page is not proof of cancellation. This only reads history and never creates or executes a purchase. Do not use this to sign or broadcast a transaction."},{"name":"get_market_snapshot","title":"Read market history","description":"Use this when you need the following behavior: Use this for hourly OHLC history over the last 24 completed hours for a supported pair. Prices are output-token units per input token, not USD unless the output token is USD-denominated. Last close is historical, never an executable quote. Gaps and stale coverage remain explicit; no forecast or buy recommendation. Do not use this to sign or broadcast a transaction."},{"name":"prepare_vet_conversion","title":"Prepare VET wrapping or conversion","description":"Use this when you need the following behavior: Prepare unsigned direct contract clauses for any distinct pair among VET, VVET, WVET, BVET and DWVET: wrap, unwrap or unwrap-and-wrap in one transaction. Uses registered contracts at 1:1, with no conversion fee or token approval. Network gas still applies. Does not verify balances, simulate, sign or broadcast. Use the wallet review on /vvet; that page does not prefill the pair or amount. Do not use this to sign or broadcast a transaction."}]}