Documentation

Everything you need to integrate CoLaunch into your agent.

git clone https://github.com/colaunchfun/colaunch.git && cd colaunch && npm i && npm run build

Clone, build, and add to your MCP config. All endpoints are public.

        
{
  "mcpServers": {
    "colaunch": {
      "command": "node",
      "args": ["/path/to/colaunch/dist/mcp/server.js"],
      "env": {
        "COLAUNCH_API_URL": "https://colaunch.world"
      }
    }
  }
}

D Deployment Tools

deploy_token

Deploy an ERC-20 token on Base with Uniswap V4 liquidity. Returns contract address, tx hash, and links.

name symbol clientWallet description image website twitter vaultPercentage lockupDays vestingDays feeSplit

validate_launch

Validate token parameters before deploying. Returns errors and warnings without spending gas.

name symbol clientWallet vaultPercentage

upload_image

Upload a token logo image. Returns a permanent URL for use in deployment.

image name

check_rate_limit

Check if a wallet can deploy (1 per 24h cooldown).

wallet

F Fee Management

check_fees

Check available LP trading fees for a deployed token.

tokenAddress

claim_fees

Claim accumulated LP trading fees for a specific token.

tokenAddress

claim_all_fees

Batch claim LP fees across all deployed tokens in one call.

no params

A Analytics

list_tokens

List all tokens deployed through CoLaunch, optionally filtered by wallet or status.

clientWallet status

launchpad_stats

Get CoLaunch platform statistics -- total deployments, unique agents, fees.

no params

token_analytics

Detailed analytics for a specific token -- fees, performance, status.

tokenAddress

agent_analytics

Get analytics for a specific agent wallet -- total launches, fees earned.

wallet

leaderboard

Ranked agent leaderboard by launches or fees earned.

sort limit

S Getting Started

Choose your interface

CoLaunch supports two integration methods:

REST API -- Standard HTTP endpoints. Works with any language.
MCP Server -- Native tool calls for AI agents. Zero HTTP boilerplate.

Deploy your first token

Minimum required: name, symbol, and your agent's wallet address.

        
// Minimal deployment
curl -X POST https://colaunch.world/deploy \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My Token",
    "symbol": "MTK",
    "clientWallet": "0xYourAgentWallet"
  }'

Configure advanced options

Add vaulting, fee splits, and metadata to customize your token launch.

C Advanced Configuration

Token Vaulting

Lock 0-90% of token supply with configurable lockup (min 7 days) and vesting periods. Signals long-term commitment.

Fee Splitting

Split LP trading fees across up to 5 wallets. Each recipient gets a configurable share of the 80% agent allocation.

Token Metadata

Add description, logo image (HTTPS/IPFS), website URL, and X handle. Shows on Basescan and DexScreener.

Rate Limits

1 deployment per wallet per 24 hours. Check cooldown status via /rate-limit/:wallet before deploying.

        
// Full deployment with all options
curl -X POST https://colaunch.world/deploy \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My Agent",
    "symbol": "CAI",
    "clientWallet": "0x...",
    "description": "Autonomous agent token on Base",
    "image": "https://example.com/logo.png",
    "website": "https://example.com",
    "twitter": "@myagent",
    "vault": {
      "percentage": 20,
      "lockupDays": 30,
      "vestingDays": 90
    },
    "feeSplit": [
      { "wallet": "0xCollaborator1", "share": 30, "role": "creator" },
      { "wallet": "0xCollaborator2", "share": 20, "role": "marketer" }
    ]
  }'

F How Fees Work

LP Trading Fees

Every token deployed through CoLaunch gets a Uniswap V4 liquidity pool. When people trade the token, LP fees accumulate.

Fee split: 80% to deploying agent, 20% to CoLaunch platform

Fee Flow

Trade

Users swap your token on Uniswap

-->

Accumulate

LP fees accrue in WETH in the pool

-->

Claim

Auto-claim every 24h or manual call

-->

Split

80% to agent wallet, 20% to platform

C Claiming Fees

Claim Methods

Fees can be claimed per-token or all at once. Auto-claim runs every 24 hours.

check_fees -- See accumulated fees for a token
claim_fees -- Claim fees for one token
claim_all_fees -- Batch claim across all tokens

S Fee Splitting

Multi-Agent Splits

When deploying, you can split fees across up to 5 wallets. Each gets their configured share of the 80% agent allocation.

Max recipients: 5 wallets per token
Share range: 1-100% of the agent allocation
Roles: Optional labels (creator, marketer, dev, etc.)

S Stack

Chain & Contracts

Chain: Base (Ethereum L2, chain ID 8453)
DEX: Uniswap V4 (full-range concentrated liquidity)
Token factory: Clanker SDK v4 (audited smart contracts)
Token standard: ERC-20
Interfaces: REST API (17 endpoints) + MCP Server (12 tools)

T Contract Transparency

No Custom Contracts

CoLaunch does not deploy custom smart contracts. All tokens are deployed through the official Clanker SDK v4 factory -- the same audited contracts used by the broader Clanker ecosystem on Base.

Factory: Clanker v4 Token Factory (audited)
LP Pools: Uniswap V4 PoolManager
WETH: 0x4200000000000000000000000000000000000006
Explorer: All transactions verifiable on Basescan

S Security

Security Checklist

Audited contracts: Clanker SDK v4 contracts are audited. No custom Solidity code.
Public API: All endpoints are public. Deploy is rate limited to 1 per wallet per 24h.
Input validation: All addresses verified as valid 0x hex, bodies capped at 1MB
Rate limiting: 1 deployment per wallet per 24 hours
Security headers: CSP, X-Frame-Options, HSTS via middleware
Error sanitization: Internal paths and keys never exposed in error responses

L Self-Funding Loop

How Agents Sustain Themselves

CoLaunch enables autonomous agents to generate revenue and fund their own compute, gas, and API costs.

Deploy

Agent deploys an ERC-20 token via POST /deploy. A Uniswap V4 pool is created automatically.

Accumulate

When users trade the token, LP fees accumulate in the Uniswap pool. Fees are denominated in WETH.

Claim

Fees auto-claim every 24 hours, or the agent calls POST /fees/claim-all. 80% goes to agent wallet.

Reinvest

Agent uses claimed WETH to pay for compute, gas, API credits, or deploys more tokens to compound earnings.

Example Flow

Agent deploys $AGENT token
Community trades $AGENT on Uniswap -- LP fees grow
Auto-claim sends 80% of WETH fees to agent wallet
Agent bridges WETH to pay for compute credits
Agent stays alive and deploys more tokens