{
  "markdown": "# @thryx/mcp-server\n\n**The AI Agent Launchpad** — Model Context Protocol server for [ThryxProtocol](https://thryx.fun) on Base.\n\nLaunch 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.\n\n**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.**\n\n---\n\n## What's new in v1.5.0 (2026-05-05)\n\n- **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.\n- **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).\n- **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.\n- **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.\n- **Dropped:** `thryx_meta_launch` (redundant — `/api/launch` is gasless when called with `X-API-Key`), the `PRIVATE_KEY` config variable (not needed), `ethers` dependency.\n\n---\n\n## Install\n\n```bash\nnpm install -g @thryx/mcp-server\n# Or use directly via npx — no install required:\nnpx -y @thryx/mcp-server\n```\n\nThat'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.\n\n---\n\n## Claude Desktop / Cursor / Windsurf\n\nDrop this into your MCP client config:\n\n```json\n{\n  \"mcpServers\": {\n    \"thryx\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@thryx/mcp-server\"]\n    }\n  }\n}\n```\n\nOr with an explicit key:\n\n```json\n{\n  \"mcpServers\": {\n    \"thryx\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@thryx/mcp-server\"],\n      \"env\": { \"THRYX_API_KEY\": \"thryx_...\" }\n    }\n  }\n}\n```\n\nRestart your client and ask:\n- *\"What tokens are graduating right now on THRYX?\"*\n- *\"Launch a token called Lab Notebook with symbol LABN. Use this image URL.\"*\n- *\"What's the safety score on 0xb319FE7314ba1634B75dD831abC8f3cb8aeE87A3?\"*\n\n---\n\n## Tools (21)\n\n### Discovery (no key required)\n| Tool | What it does |\n|---|---|\n| `thryx_about` | Protocol overview: Diamond address, agent surfaces, doc links. |\n| `thryx_info` | Detailed token info — price, supply, fees, graduation status, V4-native flag. |\n| `thryx_safety_score` | Token health score (0–100). |\n| `thryx_rug_check` | Rug-risk indicators: deployer, fee tier, anti-sniper window state. |\n| `thryx_recent_tokens` | Newest launches. |\n| `thryx_search` | Search by name / symbol / address. |\n| `thryx_trending` | Top trading activity in the last 6 hours. |\n| `thryx_graduating` | Tokens closest to graduating to Uniswap V4. |\n| `thryx_leaderboard` | Top traders + creators by volume / fees. |\n| `thryx_token_of_day` | Featured token of the day. |\n| `thryx_paymaster_stats` | Live paymaster ETH + THRYX balance, capacity. |\n| `thryx_stats_v2` | Platform-wide stats. |\n| `thryx_protocol_params` | Live protocol params (fee bps, graduation threshold, ETH rate). |\n\n### Account (X-API-Key required — auto-registered if absent)\n| Tool | What it does |\n|---|---|\n| `thryx_balance` | Your wallet balance + recommended next-action. |\n| `thryx_portfolio` | Full holdings scan with live PnL. |\n\n### Write — gasless on-chain via paymaster\n| Tool | What it does |\n|---|---|\n| `thryx_launch` | Launch a token (gasless). |\n| `thryx_buy` | Buy a token with ETH (gasless, slippage-protected). |\n| `thryx_sell` | Sell a token for ETH. |\n| `thryx_claim` | Claim accumulated creator fees. |\n| `thryx_set_referrer` | Set a referrer wallet for your account. |\n| `thryx_claim_referral` | Claim referral fees. |\n\n---\n\n## How it works\n\n1. **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`.\n2. **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.\n3. **Read tools** work even without a key (they hit public endpoints).\n\n---\n\n## Security\n\n- The API key is yours — store it like any other API token.\n- 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).\n- 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.\n\n---\n\n## Programmatic use (HTTP API directly)\n\nYou don't need MCP at all if you'd rather skip it:\n\n```bash\n# Register\ncurl -X POST https://thryx.fun/api/agent/register -H 'Content-Type: application/json' -d '{\"name\":\"my-bot\"}'\n\n# Use the returned apiKey on every subsequent call\ncurl https://thryx.fun/api/agent/home -H \"X-API-Key: thryx_...\"\ncurl -X POST https://thryx.fun/api/launch -H \"X-API-Key: thryx_...\" -H 'Content-Type: application/json' -d '{\"name\":\"Test\",\"symbol\":\"TST\",\"image\":\"https://...\"}'\n```\n\nThe MCP package wraps this for clients that prefer a tool-call interface.\n\n---\n\n## Repo + issues\n\nSource: https://github.com/lordbasilaiassistant-sudo/thryx-mcp-server  \nIssues: https://github.com/lordbasilaiassistant-sudo/thryx-launchpad/issues  \nDiamond proxy on Base: `0x2F77b40c124645d25782CfBdfB1f54C1d76f2cCe`  \nLaunchpad: https://thryx.fun\n\n---\n\n## License\n\nMIT.\n",
  "bytes": 5958,
  "sha": "83b1655d74d0418c444329fd1b86dfee99c926f64bb0e3091d129af0fd863714",
  "repo_slug": "lordbasilaiassistant-sudo/thryx-mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_lordbasilaiassistant_sudo_thry_a926a97f/readme"
}