@thryx/mcp-server

@thryx/mcp-server

The AI Agent Launchpad -- Model Context Protocol server for ThryxProtocol on Base.

Any AI agent (Claude, GPT, custom agents) can launch tokens, trade on bonding curves, claim fees, scan portfolios, and check token safety -- all through native MCP tools. Zero cost per launch (gas only, ~$0.01 on Base).

110+ tokens launched. Battle-tested on Base mainnet.

Quick Start

npx (no install)

npx @thryx/mcp-server

Global install

npm install -g @thryx/mcp-server
thryx-mcp

Integration

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "thryx-protocol": {
      "command": "npx",
      "args": ["-y", "@thryx/mcp-server"],
      "env": {
        "THRYXTREASURY_PRIVATE_KEY": "your-private-key-here"
      }
    }
  }
}

Claude Code

Add to ~/.claude/settings.json or project .mcp.json:

{
  "mcpServers": {
    "thryx": {
      "command": "npx",
      "args": ["-y", "@thryx/mcp-server"]
    }
  }
}

HTTP Mode (remote agents)

npx @thryx/mcp-server --http 3100

Endpoints:

• POST /mcp -- MCP protocol endpoint (Streamable HTTP)
• GET /health -- Health check

Tools (13 total)

Read Tools (no wallet needed)

Tool	Description
thryx_about	Protocol overview: what ThryxProtocol is, how it works, key addresses, available tools
thryx_info	Token details: bonding curve state, price, graduation progress, fees, vesting. Or protocol overview if no token specified
thryx_balance	Quick ETH + THRYX balance check for any wallet address
thryx_portfolio	Full portfolio scan across all wallets: token holdings, ETH balances, USD values via Blockscout + Multicall3 + DexScreener
thryx_stats_v2	Protocol-wide stats: total THRYX burned, graduation treasury collected
thryx_safety_score	Rate any ThryxProtocol token 0-100 on safety (vesting, liquidity, distribution, activity). Can score all deployed tokens at once
thryx_rug_check	Check ANY ERC20 on Base for rug signals: verification, honeypot, dangerous functions, ownership, liquidity, tax

Write Tools (wallet key required)

Tool	Description
thryx_launch	Deploy a new token on the bonding curve. 1B supply, 80% curve / 15% graduation LP / 5% creator vested 90 days. Gas only (~$0.01)
thryx_buy	Buy tokens with ETH or THRYX. Auto-handles approval. 0.5% fee (30% protocol, 70% creator)
thryx_sell	Sell tokens via universal routing: ThryxProtocol v2 > Legacy Factory > Odos > Kyberswap. Partial-sell fallback (100% > 50% > 25% > 10%)
thryx_claim	Claim accumulated creator or protocol fees from a token. Auto-detects v2.4 Diamond vs legacy factory
thryx_set_referrer	Set a referrer address for a token. Referrer earns 5% of protocol fee share
thryx_claim_referral	Claim accumulated referral fees (THRYX)

Example Usage

Launch a token

> Use thryx_launch to create a token called "Autonomous Agent Token" with symbol "AAT"

The agent calls thryx_launch with name: "Autonomous Agent Token" and symbol: "AAT". Returns the token address, tx hash, and bonding curve details.

Check token safety

> Use thryx_rug_check to analyze 0x1234...abcd

Returns risk level (LOW/MEDIUM/HIGH/CRITICAL) with detailed analysis of contract verification, dangerous functions, ownership, liquidity, and honeypot indicators.

Scan portfolio

> Use thryx_portfolio to scan all wallets

Discovers tokens via Blockscout, reads balances via Multicall3, prices via DexScreener. Returns a full breakdown by wallet.

Environment Variables

Variable	Required	Description
THRYXTREASURY_PRIVATE_KEY	For write tools	Private key for the default wallet. Read tools work without it.

Write tools (thryx_launch, thryx_buy, thryx_sell, thryx_claim, thryx_set_referrer, thryx_claim_referral) need wallet access. Read tools query Base mainnet RPC directly and require no configuration.

How It Works

Every token launched through ThryxProtocol:

• Creates a bonding curve -- virtual x*y=k curve paired with THRYX as the quote token
• Tradeable immediately -- buy/sell via the swap() function, no DEX listing needed
• Generates fees -- 0.5% per swap (30% protocol, 70% creator). 20% of protocol fees are burned
• Graduates to AMM -- at 500M THRYX raised, migrates to Aerodrome V2 with real liquidity
• Locks THRYX -- every launch permanently locks THRYX in the bonding curve = scarcity

v2.4 Diamond Features

• Auto-distribute creator fees in every swap (no claiming needed)
• 0.5% swap fees -- lowest on Base
• Per-token ETH reserves for safer graduation
• Per-token fee overrides for premium tokens
• Bonding curve hardening (minimum reserve floor, overflow protection)
• Same contract address forever via Diamond proxy (EIP-2535)
• Referral system: referrers earn 5% of protocol fee share
• 90-day linear vesting for creator tokens
• Mandatory 10% slippage floor
• 20% fee burn for deflationary THRYX pressure
• Loyalty rebates for ecosystem holders

Network

Chain	Base mainnet (Chain ID 8453)
Protocol v2.4 Diamond	0x2F77b40c124645d25782CfBdfB1f54C1d76f2cCe
Protocol v2.2	0xcDC734c1AFC2822E0d7E332DC914c0a7311633bF
THRYX Token	0xc07E889e1816De2708BF718683e52150C20F3BA3
RPC	https://mainnet.base.org
Explorer	basescan.org

Architecture

The MCP server wraps the ThryxProtocol CLI toolkit (scripts/toolkit/), spawning each script as a child process with --json --execute flags. This means the server inherits all routing logic, safety checks, and fallback behavior:

• NEVER_SELL guards for protected tokens
• Partial-sell fallback (100% > 50% > 25% > 10%)
• Multi-DEX aggregator routing (Odos, Kyberswap)
• Rate limiting and RPC rotation
• NonceManager for transaction safety

thryx_launch  -->  launch.js "Name" SYMBOL --wallet main --json --execute
thryx_buy     -->  buy.js <token> <amount> --with thryx --wallet main --json --execute
thryx_sell    -->  swap-sell.js <token> all --wallet main --json --execute
thryx_claim   -->  claim.js <token> --wallet main --json --execute
thryx_info    -->  info.js [token] --json

Related

• npx thryx -- standalone CLI for one-command token deploys
• ThryxProtocol -- the launchpad protocol
• THRYX on DexScreener -- live THRYX token chart

License

MIT