ThryxProtocol MCP Server

@thryx/mcp-server

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

Launch ERC-20 tokens, trade on bonding curves or graduated Uniswap V4 pools, claim creator + referral fees, scan portfolios, and discover trending / graduating / safety-scored tokens — through 21 native MCP tools.

v3.1 Diamond live on Base mainnet · 880+ tokens launched · V4-native default with anti-sniper hook · Gasless · Server-managed wallets · No private keys, no API bills.

---

What's new in v1.5.0 (2026-05-05)

• Pure HTTP wrapper. Every tool is one fetch() against https://thryx.fun/api/*. No local signing, no ethers.js, no toolkit-script dependency. Drop-in installable.
• Auto-registers a wallet on first run if you don't set THRYX_API_KEY. Registration is one HTTP call, returns a fresh wallet + key + pre-sponsored gas in ~200ms. Saved to ~/.thryx-mcp/credentials.json (mode 0600 on POSIX).
• 21 tools all wired and verified against the live launchpad. The smoke test runs real JSON-RPC frames over stdio and asserts specific fields per response — SMOKE_TEST_REPORT.md has the matrix.
• v3.1 facts — V4-native by default since 2026-05-04, anti-sniper hook (80% → 1% over 60s), Token/THRYX pair so every trade pumps the reserve currency.
• Dropped: thryx_meta_launch (redundant — /api/launch is gasless when called with X-API-Key), the PRIVATE_KEY config variable (not needed), ethers dependency.

---

Install

npm install -g @thryx/mcp-server
# Or use directly via npx — no install required:
npx -y @thryx/mcp-server

That's it. On first run with no THRYX_API_KEY set, the package auto-registers a fresh wallet and saves the credentials. No signup form, no email, no captcha.

---

Claude Desktop / Cursor / Windsurf

Drop this into your MCP client config:

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

Or with an explicit key:

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

Restart your client and ask:

• "What tokens are graduating right now on THRYX?"
• "Launch a token called Lab Notebook with symbol LABN. Use this image URL."
• "What's the safety score on 0xb319FE7314ba1634B75dD831abC8f3cb8aeE87A3?"

---

Tools (21)

Discovery (no key required)

Tool	What it does
thryx_about	Protocol overview: Diamond address, agent surfaces, doc links.
thryx_info	Detailed token info — price, supply, fees, graduation status, V4-native flag.
thryx_safety_score	Token health score (0–100).
thryx_rug_check	Rug-risk indicators: deployer, fee tier, anti-sniper window state.
thryx_recent_tokens	Newest launches.
thryx_search	Search by name / symbol / address.
thryx_trending	Top trading activity in the last 6 hours.
thryx_graduating	Tokens closest to graduating to Uniswap V4.
thryx_leaderboard	Top traders + creators by volume / fees.
thryx_token_of_day	Featured token of the day.
thryx_paymaster_stats	Live paymaster ETH + THRYX balance, capacity.
thryx_stats_v2	Platform-wide stats.
thryx_protocol_params	Live protocol params (fee bps, graduation threshold, ETH rate).

Account (X-API-Key required — auto-registered if absent)

Tool	What it does
thryx_balance	Your wallet balance + recommended next-action.
thryx_portfolio	Full holdings scan with live PnL.

Write — gasless on-chain via paymaster

Tool	What it does
thryx_launch	Launch a token (gasless).
thryx_buy	Buy a token with ETH (gasless, slippage-protected).
thryx_sell	Sell a token for ETH.
thryx_claim	Claim accumulated creator fees.
thryx_set_referrer	Set a referrer wallet for your account.
thryx_claim_referral	Claim referral fees.

---

How it works

1. Auto-register. On first run with no THRYX_API_KEY, the package POSTs to https://thryx.fun/api/agent/register and gets a fresh wallet + API key + pre-sponsored gas. Credentials are persisted at ~/.thryx-mcp/credentials.json.
2. Every tool call is an authenticated HTTPS request to thryx.fun/api/* with X-API-Key. The launchpad signs and submits the on-chain transactions on your behalf via its paymaster — you never see a private key, and you never pay gas.
3. Read tools work even without a key (they hit public endpoints).

---

Security

• The API key is yours — store it like any other API token.
• The auto-registered wallet is server-managed. The launchpad holds the encrypted keystore; you never touch the private key. To take custody, withdraw via thryx_balance → POST /api/agent/withdraw (separate flow, not yet a tool).
• All requests are HTTPS to thryx.fun. The package never makes calls to any other host except the configurable THRYX_BASE_URL if you set it.

---

Programmatic use (HTTP API directly)

You don't need MCP at all if you'd rather skip it:

# Register
curl -X POST https://thryx.fun/api/agent/register -H 'Content-Type: application/json' -d '{"name":"my-bot"}'

# Use the returned apiKey on every subsequent call
curl https://thryx.fun/api/agent/home -H "X-API-Key: thryx_..."
curl -X POST https://thryx.fun/api/launch -H "X-API-Key: thryx_..." -H 'Content-Type: application/json' -d '{"name":"Test","symbol":"TST","image":"https://..."}'

The MCP package wraps this for clients that prefer a tool-call interface.

---

Repo + issues

Source: https://github.com/lordbasilaiassistant-sudo/thryx-mcp-server
Issues: https://github.com/lordbasilaiassistant-sudo/thryx-launchpad/issues
Diamond proxy on Base: 0x2F77b40c124645d25782CfBdfB1f54C1d76f2cCe
Launchpad: https://thryx.fun

---

License

MIT.