@thryx/mcp-server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@@thryx/mcp-server What tokens are graduating right now on THRYX?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
@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()againsthttps://thryx.fun/api/*. No local signing, noethers.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.mdhas 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/launchis gasless when called withX-API-Key), thePRIVATE_KEYconfig variable (not needed),ethersdependency.
Related MCP server: MAIN MCP
Install
npm install -g @thryx/mcp-server
# Or use directly via npx — no install required:
npx -y @thryx/mcp-serverThat'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 |
| Protocol overview: Diamond address, agent surfaces, doc links. |
| Detailed token info — price, supply, fees, graduation status, V4-native flag. |
| Token health score (0–100). |
| Rug-risk indicators: deployer, fee tier, anti-sniper window state. |
| Newest launches. |
| Search by name / symbol / address. |
| Top trading activity in the last 6 hours. |
| Tokens closest to graduating to Uniswap V4. |
| Top traders + creators by volume / fees. |
| Featured token of the day. |
| Live paymaster ETH + THRYX balance, capacity. |
| Platform-wide stats. |
| Live protocol params (fee bps, graduation threshold, ETH rate). |
Account (X-API-Key required — auto-registered if absent)
Tool | What it does |
| Your wallet balance + recommended next-action. |
| Full holdings scan with live PnL. |
Write — gasless on-chain via paymaster
Tool | What it does |
| Launch a token (gasless). |
| Buy a token with ETH (gasless, slippage-protected). |
| Sell a token for ETH. |
| Claim accumulated creator fees. |
| Set a referrer wallet for your account. |
| Claim referral fees. |
How it works
Auto-register. On first run with no
THRYX_API_KEY, the package POSTs tohttps://thryx.fun/api/agent/registerand gets a fresh wallet + API key + pre-sponsored gas. Credentials are persisted at~/.thryx-mcp/credentials.json.Every tool call is an authenticated HTTPS request to
thryx.fun/api/*withX-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.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 configurableTHRYX_BASE_URLif 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 toolsthryx_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_searchB
Search tokens by name, symbol, or address.
Inputs: query (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.
thryx_trendingA
Tokens with the most trading activity in the last 6 hours. Top conviction signals.
Inputs: limit.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 21 tools
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.
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.
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.
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
Related MCP Connectors
MCP server for AI agents to discover campaigns by humans and donate USDC directly on Base.
OpenAI-compatible LLM MCP (7 tools); chat via balance key or x402 USDC on Base
15 paid AI agent primitives via x402 (USDC on Base). Pay-per-call MCP server.
Non-custodial USDC yield vaults on Base mainnet with 9 MCP tools for AI agent treasury.
Related MCP Servers
- AlicenseBqualityDmaintenanceDynamic 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.334 npmMIT
- AlicenseNot gradedqualityDmaintenanceMCP (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
- AlicenseAqualityCmaintenanceAn MCP server for AI agents to discover and trade new token launches on Base chain.517 npm1MIT
- AlicenseNot gradedqualityDmaintenanceMCP 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 npmMIT