Skip to main content
Glama

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


Related MCP server: MAIN MCP

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.

Available Tools

21 tools
thryx_aboutA

Protocol overview: Diamond address, chain, agent surfaces, doc links. Always available, no key required. Start here when an agent first connects.

Inputs: no named parameters.

thryx_balanceA

Your wallet balance — ETH, THRYX, total value, and a recommended next-action. Requires THRYX_API_KEY. Equivalent to GET /api/agent/home.

Inputs: no named parameters.

thryx_buyA

Buy a token with ETH. Gasless via paymaster. Slippage protected. Requires THRYX_API_KEY and enough ETH in your wallet to cover the trade value (gas is sponsored separately).

Inputs: token (required), amount (required), comment.

thryx_claimA

Claim accumulated creator fees for a token you launched (70% of every swap fee accrues to the creator). Returns claimed amount + txHash. Requires THRYX_API_KEY and creator status.

Inputs: tokenAddress (required).

thryx_claim_referralA

Claim accumulated referral fees (5% of protocol fees on trades made by accounts you referred). No body required.

Inputs: no named parameters.

thryx_graduatingB

Tokens closest to graduation (250M THRYX raised → migrates to Uniswap V4). High-conviction late-stage curve plays.

Inputs: limit.

thryx_infoA

Detailed info for a single token: price, supply, raised, fees, graduation status, V4-native flag, healthScore. No key required.

Inputs: token (required).

thryx_launchA

Launch a new token on Base (gasless). The platform pays gas via paymaster. Returns tokenAddress + txHash. Requires THRYX_API_KEY. Image required (public URL or data: URL).

Inputs: name (required), image (required), symbol (required), article, +4 more.

thryx_leaderboardB

Top traders by volume + top creators by fees earned. Range: 24h | 7d | 30d.

Inputs: range.

thryx_paymaster_statsA

Live paymaster state — sponsored ETH balance, THRYX reserves, capacity. Pulled from /api/status.

Inputs: no named parameters.

thryx_portfolioA

Full portfolio scan for your wallet — every token holding with live prices and PnL. Requires THRYX_API_KEY. Heavier than thryx_balance; call when you need per-token detail.

Inputs: no named parameters.

thryx_protocol_paramsA

Live protocol params: fee in basis points, creator fee split, graduation threshold, ETH/THRYX exchange rate, total launched, total graduated. Pulled from /api/protocol-params.

Inputs: no named parameters.

thryx_recent_tokensA

Most recently launched tokens. No key required. Sorted newest-first.

Inputs: limit.

thryx_rug_checkA

Rug-risk indicators for a token: deployer address, graduated status, trade count, anti-sniper window, fee tier. Uses the same token detail endpoint as thryx_info, surfacing the fields a rug check cares about.

Inputs: token (required).

thryx_safety_scoreB

Token safety score (0–100, higher is safer). Computed by the launchpad from on-chain liquidity, holder distribution, deployer history, and trading patterns. Reads the healthScore field from the token detail endpoint.

Inputs: token (required).

thryx_sellA

Sell a token for ETH. Gasless via paymaster. Routes through bonding curve OR V4 pool depending on graduation/V4-native status. Slippage protected.

Inputs: token (required), amount (required), comment.

thryx_set_referrerB

Set a referrer wallet for your account. The referrer earns 5% of the protocol fee share on every trade you make.

Inputs: referrer (required).

thryx_stats_v2A

Platform-wide stats: total tokens, users, trades, ETH/THRYX prices, reserves, lifetime fees, reward pool. Pulled from /api/stats.

Inputs: no named parameters.

thryx_token_of_dayC

The currently-featured token of the day, picked by the platform algorithm.

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 21 tools

    Disambiguation4/5

    Most tools have clear, distinct purposes, but thryx_info, thryx_safety_score, and thryx_rug_check all draw from the same token detail endpoint and could be confused. Similarly, thryx_balance and thryx_portfolio overlap somewhat. However, the descriptions are explicit enough that an agent can usually select the right tool.

    Naming Consistency4/5

    All tools share a consistent 'thryx_' prefix and use snake_case, making the set predictable. The second part mixes nouns (info, balance) and verbs (buy, sell) rather than a strict verb_noun pattern, but this is a minor deviation given the strong prefix consistency.

    Tool Count3/5

    With 21 tools, the set is in the 'heavy' range. Each tool does cover a distinct aspect (discovery, analysis, trading, referral, stats), but there is some redundancy among the stats and token-detail tools that could be consolidated without much loss.

    Completeness4/5

    The tool surface covers the core workflow: token discovery, analysis, trading, launching, claiming fees, and referral management. Obvious gaps like transaction history or a list of a creator's launched tokens are missing, but these are workaround-able and do not create dead ends.

    Maintenance

    ActivityNo data
    ResponsivenessSyncing

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Dynamic MCP server — 30+ tools across fact verification, agent memory, Indian NLP, contract risk, security threat modelling, sales call intelligence and more. x402/USDC micropayments on Base.
      33
      4 npm
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP (Model Context Protocol) server for the MAIN DEX on Base. Provides AI agents (Claude, Cursor, etc.) with tools to interact with the protocol: swap tokens, manage liquidity, enter/exit ALM strategies(10% APY), and more.
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server that provides AI agents with pay-per-call access to a suite of tools (honeypot check, token market, DeFi yields, etc.) via USDC on Base using the x402 protocol.
      11 npm
      MIT