io.github.avagenesisdev/ava-genesis

Official9 tools

Deploy ERC-20 tokens on Ethereum, Base, BNB, Polygon via MCP. One call = deployed contract.

Deploys ERC-20 tokens on multiple blockchains with a single call.

Captured live from the server via tools/list.

ava_deploy_token

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.

Parameters (11)

apiKeystringrequired
Your Ava Genesis API key (ava_live_...)
chainstringrequired
Only 'sepolia' is allowed. Mainnet requires ava_create_token_intent.
namestringrequired
Token name, e.g. 'My Protocol Token'
symbolstringrequired
Token symbol, e.g. 'MPT' (max 16 chars, uppercase)
supplystringrequired
Initial supply as a number string, e.g. '1000000'
decimalsnumber
Decimals (default: 18)
ownerAddressstring
Wallet address that will receive the tokens and own the contract. If omitted, tokens remain with the platform deployer.
templatestring
Optional preset configuration
featuresobject
Optional feature flags (override template)
callbackUrlstring
Webhook URL for status events (optional)
idempotencyKeystring
Unique key to prevent duplicate deploys on retry (optional)

ava_get_gas_prices

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.

No parameters.

ava_list_templates

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.

No parameters.

ava_simulate_token

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.

Parameters (8)

apiKeystringrequired
Your Ava Genesis API key (ava_live_...)
chainstringrequired
Target chain for fee estimate. Base and BNB Chain have lowest gas fees.
namestringrequired
Token name, e.g. 'My Protocol Token'
symbolstringrequired
Token ticker symbol, e.g. 'MPT' (max 16 chars, uppercase recommended)
supplystringrequired
Initial token supply as a number string, e.g. '1000000'. Avoid scientific notation.
decimalsnumber
Token decimal places (default: 18). Use 6 for stablecoin-like tokens, 18 for standard ERC-20.
templatestring
Optional preset that pre-fills feature flags. Use ava_list_templates to see each preset's config.
featuresobject
Optional feature overrides. Any premium feature (mintable, pausable, blacklist, transferTax, antiWhale) triggers the $50 tier. Burnable alone is $20 Basic tier.

ava_get_deployment_status

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.

Parameters (2)

apiKeystringrequired
Your Ava Genesis API key (ava_live_...) used when the deployment was created
intentIdstringrequired
The intentId returned by ava_deploy_token, ava_create_token_intent, or ava_confirm_deployment

ava_list_my_tokens

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.

Parameters (4)

apiKeystringrequired
Your Ava Genesis API key (ava_live_...)
statusstring
Filter by deployment status. Omit to return all statuses.
chainstring
Filter by chain. Omit to return tokens across all chains.
limitnumber
Number of results to return (default: 50, max: 200)

ava_create_api_key

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.

Parameters (2)

namestring
Human-readable label for this key, e.g. 'Treasury Agent v1'. Helps identify the key in your dashboard.
monthlyLimitnumber
Maximum number of mainnet deployments allowed per calendar month (default: 100). Does not limit Sepolia testnet deployments.

ava_create_token_intent

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.

Parameters (10)

apiKeystringrequired
Your Ava Genesis API key (ava_live_...)
chainstringrequired
Target chain. Base and BNB Chain have the lowest gas fees and are recommended for most agent deployments.
namestringrequired
Token name, e.g. 'Agent Treasury Token'
symbolstringrequired
Token ticker symbol, e.g. 'ATT' (max 16 chars, uppercase recommended)
supplystringrequired
Initial token supply as a number string, e.g. '1000000'. Avoid scientific notation.
decimalsnumber
Token decimal places (default: 18)
templatestring
Optional preset that pre-fills feature flags. Use ava_list_templates to see each preset's config.
featuresobject
Optional feature flags. Premium features (mintable, pausable, blacklist, transferTax, antiWhale) trigger $50 tier. Burnable alone is $20 tier.
callbackUrlstring
Optional HTTPS webhook URL to receive status updates (deploying, deployed, failed). Signed with HMAC-SHA256.
idempotencyKeystring
Optional unique string to prevent duplicate deployments on retry. Same key returns the original intent instead of creating a new one.

ava_confirm_deployment

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.

Parameters (3)

apiKeystringrequired
Your Ava Genesis API key (ava_live_...) used when the intent was created
intentIdstringrequired
The intentId returned by ava_create_token_intent
txHashstringrequired
0x-prefixed 32-byte transaction hash from your signed and broadcast transaction

Install

claude_desktop_config.json

{
  "mcpServers": {
    "ava-genesis": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://avagenesis.com/api/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.