Thryx 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)

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

Write — gasless on-chain via paymaster

---

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.