Tutorial: Launch Your First AI Agent Token

Clone. Open Claude Code. Follow the steps. Your agent token is live in 10 minutes.

Live URLs

The toolkit defaults to the dev environment. All links and API calls use these URLs:

Service	URL
Frontend	https://launchpad-frontend-dev-1056182620041.us-central1.run.app
Backend API	https://launchpad-backend-dev-1056182620041.us-central1.run.app
Agentverse	https://agentverse.ai

Production URLs (agent-launch.ai) will be used when AGENT_LAUNCH_ENV=production is set.

Prerequisites

Claude Code installed (claude.ai/code)
Node.js 18+ installed
Agentverse API key — get one free at agentverse.ai/profile/api-keys
BSC wallet with ~125 FET — needed only at the final deploy step (MetaMask, Rainbow, etc.)

Step 1: Clone and Setup

git clone https://github.com/tonyoconnell/agent-launch-toolkit.git
cd agent-launch-toolkit
npm install
cp .env.example .env

Open .env and paste your Agentverse API key:

AGENTVERSE_API_KEY=av-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

# Default environment is dev — these URLs are used automatically:
# Frontend: https://launchpad-frontend-dev-1056182620041.us-central1.run.app
# Backend:  https://launchpad-backend-dev-1056182620041.us-central1.run.app

Step 2: Open Claude Code

claude

Claude Code automatically loads:

CLAUDE.md — project context and platform constants
.claude/rules/ — coding patterns for AgentLaunch, Agentverse, and uAgents
.claude/skills/ — slash commands (/build-agent, /deploy, /tokenize, /market, /status)
.claude/settings.json — MCP server with 13+ tools pre-configured

You're ready. No additional setup needed.

Step 3: Build Your Agent (Option A — One Command)

Type this in Claude Code:

/build-agent

Claude will walk you through:

What does your agent do?
Pick a template (research, price-monitor, trading-bot, data-analyzer, gifter, custom)
Review the generated Python code
Deploy to Agentverse
Create the token record
Get your handoff link

That's it. Skip to Step 7.

Step 3: Build Your Agent (Option B — Step by Step)

If you prefer more control, follow steps 4-6 below.

Step 4: Scaffold Agent Code

Tell Claude what you want:

Scaffold a price monitoring agent called "FET Tracker" that watches FET/USD
and alerts when price moves more than 5%

Or use the CLI directly:

npx agentlaunch scaffold FETTracker --template price-monitor

This creates agent.py with the Agentverse Chat Protocol boilerplate. Review and customize it.

Step 5: Deploy to Agentverse

Ask Claude:

Deploy my agent to Agentverse

Or use the CLI:

npx agentlaunch deploy agent.py --name "FET Tracker"

Claude uses the deploy_to_agentverse MCP tool. It will:

Create the agent record on Agentverse
Upload your code (handles the double-encoded JSON requirement)
Start the agent
Wait for compilation (~30s)
Return the agent address: agent1q...

Step 6: Tokenize Your Agent

Ask Claude:

Tokenize my agent as $FTRK on BSC testnet

Or use the CLI:

npx agentlaunch tokenize agent1q... --name "FET Tracker" --ticker FTRK --chain 97

Claude calls create_token_record and returns:

Token ID: 42
Handoff link: https://launchpad-frontend-dev-1056182620041.us-central1.run.app/deploy/42

Step 7: Deploy On-Chain

This is the only step that requires a human with a wallet.

Open the handoff link in your browser
Connect your wallet (MetaMask, Rainbow, WalletConnect)
Approve 120 FET spending
Click Deploy
Wait ~30 seconds

Your token is now live on the bonding curve. Anyone can buy and sell immediately.

Step 8: Check Your Token

Ask Claude:

/status

Or:

What's the current price and holder count for my FET Tracker token?

Claude uses MCP tools to show:

Current price
Market cap
Progress toward graduation (30,000 FET)
Number of holders
Recent trades

Step 9: Share Trade Links

Generate pre-filled buy/sell links for your community:

Generate a buy link for 100 FET of my FET Tracker token

Returns: https://launchpad-frontend-dev-1056182620041.us-central1.run.app/trade/0x...?action=buy&amount=100

Step 10: Monitor and Iterate

/market

Browse all tokens, check trending, compare prices. Your agent keeps running on Agentverse autonomously.

What Just Happened?

You (in Claude Code)          Agentverse              AgentLaunch            Blockchain
        |                          |                       |                      |
  /build-agent                     |                       |                      |
        |---scaffold agent-------->|                       |                      |
        |---deploy code----------->|                       |                      |
        |<--agent1q... address-----|                       |                      |
        |---create token record--->|------------------>    |                      |
        |<--handoff link-----------|                       |                      |
        |                          |                       |                      |
  Click handoff link ------------->|---connect wallet----->|---deploy tx--------->|
        |                          |                       |<--token live----------|
        |                          |                       |                      |
  /status ----------------------->|                       |---read chain--------->|
        |<--price, holders---------|                       |                      |

Alternative Workflows

Pure CLI (No Claude Code)

# Full interactive wizard
npx agentlaunch create

# Or step by step
npx agentlaunch scaffold MyAgent --template research
npx agentlaunch deploy agent.py --name "My Agent"
npx agentlaunch tokenize agent1q... --name "My Agent" --ticker MAGNT
npx agentlaunch list
npx agentlaunch status 0x...
npx agentlaunch holders 0x...

Pure SDK (TypeScript)

import { AgentLaunch } from 'agentlaunch-sdk';

const al = new AgentLaunch({ apiKey: process.env.AGENTVERSE_API_KEY });

// Tokenize
const result = await al.tokens.tokenize({
  agentAddress: 'agent1q...',
  name: 'My Agent',
  symbol: 'MAGNT',
  chainId: 97,
});

console.log('Handoff link:', result.data.handoff_link);

// Market data
const price = await al.market.getPrice('0x...');
const holders = await al.market.getHolders('0x...');

Headless API (curl)

# Create token record
curl -X POST https://launchpad-backend-dev-1056182620041.us-central1.run.app/agents/tokenize \
  -H "Content-Type: application/json" \
  -H "X-API-Key: av-xxx" \
  -d '{"name":"My Agent","symbol":"MAGNT","description":"...","chainId":97}'

# List tokens
curl https://launchpad-backend-dev-1056182620041.us-central1.run.app/agents/tokens

# Get token details
curl https://launchpad-backend-dev-1056182620041.us-central1.run.app/agents/token/0x...

Slash Commands Reference

Command	What It Does
`/build-agent`	Full guided flow: scaffold, deploy, tokenize
`/deploy`	Deploy agent.py to Agentverse
`/tokenize`	Create token for an existing agent
`/market`	Browse tokens, check prices, see trending
`/status`	Check agent/token status and progress

MCP Tools Available

All tools are auto-loaded when you open Claude Code in this repo.

Tool	Description
`list_tokens`	Browse tokens with filters
`get_token`	Token details by address or ID
`get_platform_stats`	Platform-wide statistics
`calculate_buy`	Preview buy (tokens received, fee)
`calculate_sell`	Preview sell (FET received, fee)
`create_token_record`	Create token, get handoff link
`create_and_tokenize`	Full lifecycle in one call
`get_deploy_instructions`	Deployment steps for a token
`get_trade_link`	Generate pre-filled trade URL
`deploy_to_agentverse`	Deploy Python agent to Agentverse
`scaffold_agent`	Generate agent from template
`get_agent_templates`	List available templates
`get_comments`	Read token comments
`post_comment`	Post a comment

Templates

Template	Best For
`custom`	Start from scratch
`price-monitor`	Watch token prices, send alerts
`trading-bot`	Buy/sell signal generation
`data-analyzer`	On-chain data analysis
`research`	Deep dives and reports
`gifter`	Treasury wallet, reward distribution

Platform Constants

Property	Value
Deploy Fee	120 FET (paid by deploying wallet)
Graduation	30,000 FET raised triggers auto DEX listing
Trading Fee	2% on every trade, 100% to protocol treasury
Token Supply	800,000,000 per token
Default Chain	BSC Testnet (97) / BSC Mainnet (56)

Troubleshooting

"API key not set" — Make sure .env has AGENTVERSE_API_KEY=av-... and you restarted Claude Code after editing.

"Agent compilation failed" — Check your agent.py follows the Chat Protocol pattern. Use /build-agent for a working template.

"Token not found" — The token exists in the database but hasn't been deployed on-chain yet. Use the handoff link first.

Deploy transaction fails — Ensure your wallet has 120+ FET and a small amount of BNB for gas (~0.002 BNB).

"Cannot read getRemainingAmount" — The token has already graduated (listed on DEX). Check listed status first.

Next Steps

Read the SDK Reference for all TypeScript methods
Read the CLI Reference for all commands and flags
Read the MCP Tools Reference for all tool schemas
Browse the Architecture for package dependency diagrams
Visit the dev platform to see live tokens
Production: agent-launch.ai (when DNS is ready)

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Tutorial: Launch Your First AI Agent Token

Live URLs

Prerequisites

Step 1: Clone and Setup

Step 2: Open Claude Code

Step 3: Build Your Agent (Option A — One Command)

Step 3: Build Your Agent (Option B — Step by Step)

Step 4: Scaffold Agent Code

Step 5: Deploy to Agentverse

Step 6: Tokenize Your Agent

Step 7: Deploy On-Chain

Step 8: Check Your Token

Step 9: Share Trade Links

Step 10: Monitor and Iterate

What Just Happened?

Alternative Workflows

Pure CLI (No Claude Code)

Pure SDK (TypeScript)

Headless API (curl)

Slash Commands Reference

MCP Tools Available

Templates

Platform Constants

Troubleshooting

Next Steps

FilesExpand file tree

TUTORIAL.md

Latest commit

History

TUTORIAL.md

File metadata and controls

Tutorial: Launch Your First AI Agent Token

Live URLs

Prerequisites

Step 1: Clone and Setup

Step 2: Open Claude Code

Step 3: Build Your Agent (Option A — One Command)

Step 3: Build Your Agent (Option B — Step by Step)

Step 4: Scaffold Agent Code

Step 5: Deploy to Agentverse

Step 6: Tokenize Your Agent

Step 7: Deploy On-Chain

Step 8: Check Your Token

Step 9: Share Trade Links

Step 10: Monitor and Iterate

What Just Happened?

Alternative Workflows

Pure CLI (No Claude Code)

Pure SDK (TypeScript)

Headless API (curl)

Slash Commands Reference

MCP Tools Available

Templates

Platform Constants

Troubleshooting

Next Steps