@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).

150+ tokens launched across 4 protocol versions. Verified Diamond proxy on Base mainnet.

Daily rewards: Earn 10,000 THRYX per launch and 1,000 THRYX per trade, every day. Resets at UTC midnight. No claiming needed -- rewards arrive in your wallet instantly.

What's New (v1.3.0)

• V2 daily rewards -- earn 10,000 THRYX per launch and 1,000 THRYX per trade, every day. Resets at UTC midnight. Anti-sybil minimum trade amount enforced.
• Updated tool descriptions -- all tools now reflect V2 daily reward system instead of one-time early user rewards
• Version bump across all surfaces -- package, server info, MCP protocol responses

Previous (v1.2.0)

• Gasless launches via metaLaunch() -- sign a message, relay pays gas. Zero ETH needed to launch a token.
• Simple buy()/sell() interface -- send ETH to buy tokens, sell tokens to receive ETH. No need to acquire THRYX first.
• Real THRYX volume -- every buy/sell generates real THRYX volume on the V4 Doppler pool
• Dynamic graduation threshold -- ETH-denominated, auto-converts to THRYX at market rate
• Paymaster gas sponsorship -- paymaster contract holds ETH/THRYX to cover gas for new users
• Relay -- https://thryx-relay.thryx.workers.dev for gasless operations
• 2 new tools -- thryx_meta_launch, thryx_paymaster_stats
• 15 total tools -- up from 13

Previous (v1.0.3)

• v2.4 Diamond proxy -- same address forever, verified on Basescan + Sourcify
• 0.5% swap fees -- lowest on Base. 70% creator / 30% protocol
• Auto-distributed fees -- creator fees paid instantly on every swap
• Per-token ETH reserves -- each token has isolated reserves, safer graduation
• Uniswap V4 graduation -- tokens graduate to V4 AMM
• Early user THRYX rewards -- first 10 new users automatically earn THRYX

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": {
        "PRIVATE_KEY": "your-wallet-private-key"
      }
    }
  }
}

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 (15 total)

Read Tools (no wallet needed)

Tool	Description
thryx_about	Protocol overview: what ThryxProtocol is, how it works, gasless launches, buy/sell interface, relay, 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
thryx_paymaster_stats	Check paymaster ETH/THRYX balance and gas sponsorship capacity. Shows estimated launches/swaps remaining

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 (default) or THRYX. Simple interface: send ETH, receive tokens. Protocol routes through V4 Doppler pool internally. 0.5% fee
thryx_sell	Sell tokens for ETH. Simple interface: send tokens, receive ETH. Falls back to universal routing for non-Diamond tokens. Partial-sell fallback (100% > 50% > 25% > 10%)
thryx_meta_launch	Gasless token launch via metaLaunch(). Returns EIP-712 signing data. Sign and POST to relay -- zero ETH needed
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.

Gasless launch (no ETH needed)

> Use thryx_meta_launch to create a gasless token called "Zero Gas Token" with symbol "ZGT"

Returns EIP-712 typed data to sign. Sign with your wallet, then POST the signature to the relay at https://thryx-relay.thryx.workers.dev/meta-launch. The relay submits the transaction and pays gas.

Buy tokens with ETH

> Use thryx_buy with token 0x1234...abcd and amount "0.01"

Sends 0.01 ETH to buy tokens on the bonding curve. Protocol handles THRYX routing internally -- you just send ETH.

Sell tokens for ETH

> Use thryx_sell with token 0x1234...abcd and amount "all"

Sells your entire token balance and returns ETH. Protocol handles THRYX routing internally.

Check paymaster capacity

> Use thryx_paymaster_stats to check gas sponsorship status

Returns paymaster ETH/THRYX balances and estimated number of sponsored launches and swaps remaining.

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
PRIVATE_KEY	Optional	Your wallet's private key. Needed for all write tools (launch, buy, sell, claim). Gasless launches still require signing but no ETH for gas. Read tools work without it.

Gasless launches require no ETH. Your wallet signs an EIP-712 message (needs private key), then the relay submits and the self-funding paymaster covers gas. The relay is self-sufficient — funded by 20% of all swap fees.

Write tools (thryx_launch, thryx_buy, thryx_sell, thryx_claim, thryx_set_referrer, thryx_claim_referral) need wallet access for direct on-chain transactions. Read tools (thryx_info, thryx_balance, thryx_portfolio, thryx_stats_v2, thryx_safety_score, thryx_rug_check, thryx_paymaster_stats, thryx_about) 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 with ETH via simple buy()/sell() functions, no DEX listing needed
• Generates real volume -- every trade routes through the V4 Doppler pool, generating real THRYX volume
• Generates fees -- 0.5% per swap (30% protocol, 70% creator). 20% of protocol fees are burned
• Graduates to AMM -- at dynamic ETH-denominated threshold, migrates to Uniswap V4 with real liquidity
• Locks THRYX -- every launch permanently locks THRYX in the bonding curve = scarcity

v2.4 Diamond Features

• Gasless launches -- metaLaunch() lets users sign off-chain, relay pays gas. Zero ETH to launch.
• Simple buy/sell -- buy(token) with ETH, sell(token, amount) for ETH. Protocol handles THRYX routing internally.
• Real THRYX volume -- every trade generates real volume on the V4 Doppler pool
• Dynamic graduation -- ETH-denominated threshold auto-converts to THRYX at market rate
• Paymaster gas sponsorship -- paymaster contract sponsors gas for new users
• Relay service -- https://thryx-relay.thryx.workers.dev for gasless operations
• V2 daily rewards -- 10K THRYX per launch, 1K THRYX per trade, resets daily at UTC midnight. Anti-sybil minimum trade amount.
• 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.3 (legacy)	0x4f25b9ecC67dC597f35abaE6Fa495457EC82284B
Protocol v2.2 (legacy)	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 eth --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
thryx_meta_launch  -->  (self-contained: returns EIP-712 signing data for relay submission)
thryx_paymaster_stats  -->  (self-contained: reads paymaster balance via RPC)

Related

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

License

MIT