{"name":"ava-genesis","description":"Ava Genesis Agent API - ERC-20 token deployment for AI agents. One MCP call deploys a live token on Ethereum, Base, BNB Chain, or Polygon.","version":"2.0.0","protocol":"mcp/2024-11-05","endpoint":"https://avagenesis.com/api/mcp","pricing":{"testnet":"Free - unlimited Sepolia testnet deployments, no wallet required","mainnet":"$10 flat fee per deployment (ETH or USDC) + gas","freeTier":true},"chains":["ethereum","base","bnb","polygon","sepolia"],"auth":"API key (ava_live_...) - obtain free via ava_create_api_key tool or POST /api/agents/keys","quickstart":"1) Call ava_create_api_key to get your key. 2) Call ava_deploy_token with chain=sepolia to test free. 3) Call ava_create_token_intent for mainnet with your own wallet.","docs":"https://avagenesis.com/docs/agents","tools":[{"name":"ava_deploy_token","description":"Deploy an ERC-20 token on Sepolia testnet with no wallet required — TESTNET ONLY, always free. The platform wallet signs and broadcasts the transaction on your behalf. Use for integration testing before mainnet. Blocks until deployed (polls up to 3 minutes) and returns the final contract address in one call. Returns: { ok, status, contractAddress, tokenName, tokenSymbol, chain, chainId, txHash, explorerUrl, tokenUrl, intentId }. On timeout returns status='timeout' with a status_url to poll manually via ava_get_deployment_status. On failure returns ok=false with errorMessage. For mainnet deployments use ava_create_token_intent — your agent signs with its own wallet and pays gas + $10 fee directly."},{"name":"ava_get_gas_prices","description":"Get real-time gas prices and total deployment cost estimates across all supported chains. Use this before deploying to pick the cheapest chain and avoid gas spikes. No API key required. Returns: gasPrice (gwei), estimatedDeployGas, totalCostEth, totalCostUsd, and platformFeeUsd for each chain. Data is fetched live from each chain's RPC — prices reflect current mempool conditions. Cache TTL: 15 seconds. If a chain RPC is unreachable, that chain is omitted from the response. Base and BNB Chain consistently have the lowest fees; Ethereum mainnet the highest."},{"name":"ava_list_templates","description":"List all available token templates with their pre-configured feature flags. Call this before ava_simulate_token or ava_deploy_token to choose a template that matches your use case. Templates: utility (basic transferable token), governance (voting rights), reward (distributor-controlled), treasury (mintable reserve), community (burnable social token), meme (no restrictions, max supply). Returns: template name, description, and the exact feature flags each preset applies. Templates are read-only presets — individual flags can be overridden via the features parameter."},{"name":"ava_simulate_token","description":"Validate a token configuration and get a fee estimate without spending gas or deploying anything. Use this before ava_deploy_token or ava_create_token_intent to confirm the config is valid and see the exact ETH cost. Returns: estimated fee in ETH and USD, resolved feature flags, tier (Starter/Basic/Premium), and any validation errors. Does not create an intent or charge any fee."},{"name":"ava_get_deployment_status","description":"Poll the current status of a token deployment by its intentId. Use this after ava_deploy_token times out, or to check progress of an ava_create_token_intent flow. Returns: status ('deploying' | 'deployed' | 'failed'), contractAddress and explorer links when deployed, errorMessage on failure. Poll every 5-10 seconds. Most deployments complete within 60 seconds. Possible errors: insufficient fee sent, gas spike, RPC timeout — check errorMessage field."},{"name":"ava_list_my_tokens","description":"List all ERC-20 tokens deployed via your API key, newest first. Use to audit past deployments, find a contract address, or check deployment history. Supports filtering by status and chain. Returns up to 50 results by default (max 200). Does not return tokens deployed by other API keys even on the same account."},{"name":"ava_create_api_key","description":"Create a new Ava Genesis API key. Use this once to obtain your ava_live_... key before calling any other tool. The raw key is returned only once in the response — store it securely, it cannot be retrieved again. Each key tracks its own deployment history and rate limits independently. This tool requires no existing API key — it is the bootstrap step for new agents."},{"name":"ava_create_token_intent","description":"Deploy an ERC-20 token on mainnet or testnet using your agent's own wallet. Returns encoded calldata (to, value, data) — your agent signs and broadcasts the transaction, paying gas + $10 fee directly from its wallet. Same contract and fee flow as human users on the website. Your agent owns the deployed contract from the moment of deploy. Works on Ethereum, Base, BNB Chain, Polygon, and Sepolia testnet. After broadcasting the tx, call ava_confirm_deployment with the txHash to resolve the contract address. Use ava_simulate_token first to validate config and estimate fees without spending gas."},{"name":"ava_confirm_deployment","description":"After signing and broadcasting the transaction returned by ava_create_token_intent, submit the txHash here to resolve the deployed contract address. The server monitors the chain for the transaction receipt and updates the intent status. Returns: status ('deploying' | 'deployed' | 'failed'), contractAddress when confirmed, explorerUrl, and tokenUrl. If status is still 'deploying', poll ava_get_deployment_status every 5-10 seconds until resolved. Possible failures: tx reverted (insufficient fee or gas), wrong chain, txHash already used."}]}