Documentation

Claude Code MCP

agent-launch-mcp
v2.3.5

Launch and trade tokens from your terminal using natural language. The MCP server connects Claude Code directly to agent-launch.ai — no browser tab needed until it is time to sign.

How it works

The MCP server runs locally via npx. It calls the agent-launch.ai API on your behalf and returns handoff links for any action that requires a blockchain signature. No private keys ever leave your wallet.

Installation

Add the following to your ~/.claude/claude_desktop_config.json file. Create the file if it does not exist.

json
{
  "mcpServers": {
    "agent-launch": {
      "command": "npx",
      "args": ["-y", "agent-launch-mcp@latest"],
      "env": {
        "AGENTLAUNCH_API_KEY": "your_agentverse_api_key"
      }
    }
  }
}

Then restart Claude Code. The MCP server will start automatically via npx on the next session — no separate install step required.

Configuration

API Key

Get your API key from agentverse.ai/profile/api-keys. The key is required only for write operations (creating tokens). All read operations work without one.

Environment variables

AGENTLAUNCH_API_KEYRequired for write operations (create token). Get from Agentverse.
AGENTLAUNCH_BASE_URLAPI base URL. Defaults to https://agent-launch.ai/api
AGENTLAUNCH_CHAIN_IDDefault chain: 97 (BSC testnet) or 56 (BSC mainnet). Default: 97

Full configuration example

json
{
  "mcpServers": {
    "agent-launch": {
      "command": "npx",
      "args": ["-y", "agent-launch-mcp@latest"],
      "env": {
        "AGENTLAUNCH_API_KEY": "your_agentverse_api_key",
        "AGENTLAUNCH_BASE_URL": "https://agent-launch.ai/api",
        "AGENTLAUNCH_CHAIN_ID": "56"
      }
    }
  }
}

Available Tools (19+)

Click a tool to expand its input/output schema. Tools marked

Public
require no API key.
API Key
tools require AGENTLAUNCH_API_KEY.

Discovery — read platform data
Calculate — bonding curve previews
Write — create records (API key required)
Handoff — generate links for human execution
Generate — create agent projects from templatesv2.0
Agentverse — deploy agentsv2.0

Example Conversation

Once the MCP is configured, you interact with agent-launch.ai entirely through natural language in your Claude Code session. Here is an end-to-end token creation workflow:

> You: I want to create a token for my trading bot called TradingBot, ticker TBOT

Claude uses create_token_record →
  { name: "TradingBot", symbol: "TBOT", description: "...", category: "Trading" }

Claude: Done! Your token record is ready.

Here's your deployment link:
https://agent-launch.ai/deploy/42

To deploy:
1. Click the link above
2. Connect your wallet (needs 120 FET + small BNB for gas)
3. Click "Approve FET" and confirm in your wallet
4. Click "Deploy Token" and confirm again
5. Wait ~30 seconds — your token will be live

Want me to calculate how many TBOT tokens you'd receive if you also
buy 50 FET worth at launch?

> You: Yes, and give me a shareable buy link for my community

Claude uses calculate_buy →
  { address: "...", fetAmount: "50" }

Claude: At current bonding curve pricing, 50 FET would give you
approximately 1,234,567 TBOT tokens.

Here's a pre-filled buy link for your community:
https://agent-launch.ai/trade/0x...?action=buy&amount=50

When someone clicks it, the amount is pre-filled — they just connect
their wallet and confirm.

Claude calls MCP tools automatically — you never need to invoke them manually.

Security Model

The MCP never

  • ×Stores or accesses private keys
  • ×Signs blockchain transactions
  • ×Holds or moves user funds
  • ×Exposes your API key to the API response

The MCP only

  • ✓Queries public platform data
  • ✓Calculates bonding curve amounts
  • ✓Creates off-chain token records (with your API key)
  • ✓Returns handoff links for human signing

All on-chain actions are completed by you in the browser at agent-launch.ai/deploy/{id}. Your wallet never interacts with the MCP directly.

Troubleshooting

MCP server does not appear in Claude Code

Ensure the config file is at the correct path (~/.claude/claude_desktop_config.json on Mac/Linux, %APPDATA%\Claude\claude_desktop_config.json on Windows) and that the JSON is valid. Restart Claude Code after saving.

npx download is slow or fails on first use

The first invocation downloads the package from npm. Subsequent runs use a local cache. If npm is unavailable or behind a firewall, install globally: npm install -g agent-launch-mcp and replace the "command" field with "agent-launch-mcp".

create_token_record fails with 401 Unauthorized

Check that AGENTLAUNCH_API_KEY is set correctly in the env section of your config. The key must be a valid Agentverse API key from agentverse.ai/profile/api-keys.

calculate_buy or calculate_sell returns an error

These endpoints are not yet live — they depend on backend work described in the MCP roadmap. Use get_token to read the current price from the bondingCurve field in the meantime.

The handoff link opens but my wallet shows the wrong network

The deploy page will prompt you to switch to BSC. Accept the network-switch request in your wallet, then proceed. If your wallet does not support auto-switch, manually select BSC Testnet (chain ID 97) or BSC Mainnet (chain ID 56).

Related Documentation

Agent-Human Handoff ProtocolREST API DocumentationDeploy to AgentverseToken Economics

Build your first AI agent in 5 minutes

Create, deploy, and tokenize — all from your terminal.