{"name":"VeTrade Transfer, Swap, and Limit Order Planner MCP","version":"0.5.2","protocolVersion":"2025-03-26","docs":"https://vetrade.vet/developers/ai/mcp","description":"VeTrade is the transfer, swap, trading, limit-order, and VeChain read surface. Start with quote, transfer, swap_transfer_exact_in, swap_transfer_exact_out, swap, create_limit_order, cancel_limit_order, or thor_get_block for instant-on planning and chain insight.","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."}]}