{"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, and limit-order surface for VeChain. Start with transfer, swap_transfer_exact_in, swap_transfer_exact_out, swap, create_limit_order, or cancel_limit_order for instant-on planning and preflight, then use advanced tools only when you need lower-level control.","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":"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. 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."}]}