@thryx/portfolio-mcp-server

MCP server for the THRYX onchain contract portfolio. Read-only tools that any AI agent can install in 30 seconds and immediately query 14 deployed contracts on Base mainnet.

The THRYX treasury has shipped 14 contracts on Base mainnet so far:

• DeadManSwitch — on-chain inheritance switch with bounty triggers
• KeeperBountyLab (6) — ManualFloorOracle, VestingAutoClaim, EnsAutoRenewer, DaoProposalExecutor, NftCancelOnFloorDrop, CurveGraduationPusher
• OnchainPrimitives Lab (7) — StealthAddressRegistry (EIP-5564 + EIP-6538), SlashablePromiseVault, ConditionalTokenDrop, TimeCapsule, AddressTaggingMarket, GroupBountyPool, AtomicSwapHTLC
• 4 Clanker-V4 tokens — Aletheia (ALETH), Mnemosyne (MNEM), Huginn (HUGIN), Custos (CUSTOS)

Canonical machine-readable index: https://lordbasilaiassistant-sudo.github.io/thryx-deployments/addresses.json.

This MCP server wraps that index plus per-contract view-function helpers so any AI agent (Claude, Cursor, Cline, Continue, etc.) can:

• Discover what's deployed without scraping web pages
• Read DeadManSwitch state by switch ID
• Look up address attestations from the AddressTaggingMarket
• Resolve EIP-5564 stealth meta-addresses for any registrant
• Check TimeCapsule unlock state
• Query ERC-20 supplies and balances for THRYX-launched tokens
• Call any whitelisted view function via a generic thryx_call_contract tool

Read-only by design. Nothing in this server can sign or submit a transaction.

Install — 30 seconds

Add to your MCP client config (Claude Desktop, Cursor, Cline, Continue, etc.):

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

Restart your client. The server pulls the live address index on first use and caches it for 60 seconds.

Optional: custom Base RPC

Default is the public Base RPC (https://mainnet.base.org). For higher rate limits, set BASE_RPC_URL:

{
  "mcpServers": {
    "thryx-portfolio": {
      "command": "npx",
      "args": ["-y", "@thryx/portfolio-mcp-server"],
      "env": { "BASE_RPC_URL": "https://base-mainnet.g.alchemy.com/v2/YOUR_KEY" }
    }
  }
}

Tools

Portfolio (no RPC required)

| Tool | What it returns | |---|---| | thryx_portfolio_summary | High-level summary: contract count, token count, treasury, chain, links | | thryx_list_contracts | Every contract; optional category filter | | thryx_get_contract | Single contract by name or address — incl. curated read-only ABI | | thryx_list_tokens | Every Clanker-V4 token in the portfolio | | thryx_get_token | Single token by symbol/name/address |

On-chain reads (Base mainnet)

| Tool | Reads | |---|---| | thryx_dms_get_switch | DeadManSwitch by ID — depositor, beneficiary, deadline, isAlive | | thryx_dms_total_switches | Count of all DeadManSwitch positions | | thryx_dms_switches_by | Switch IDs by depositor or beneficiary address | | thryx_attestations_for | AddressTaggingMarket attestations + top label for an address | | thryx_attestations_total | Total attestations ever made | | thryx_stealth_meta_address | EIP-5564 stealth meta-address for a registrant + scheme ID | | thryx_capsule_status | TimeCapsule unlock check + creator/recipient lookups | | thryx_token_supply | ERC-20 read for THRYX tokens or any Base ERC-20 | | thryx_call_contract | Generic ABI-gated view-fn caller for any portfolio contract |

Why MCP?

Model Context Protocol is the open standard for connecting AI assistants to real tools. Instead of asking an agent to describe a contract, this server lets the agent read it. Lower hallucination risk, real on-chain state, no custom client integration needed.

The THRYX deployments index is also consumable directly — just GET the JSON URL above. The MCP server adds typed tool surfaces and live chain reads on top.

Sibling packages

Anthony Snider also publishes:

• @thryx/contract-scanner-mcp-server — Solidity security scanner
• @thryx/multi-wallet-mcp-server — multi-wallet treasury ops
• @thryx/defi-orchestrator-mcp-server — multi-step DeFi strategies
• @thryx/gas-paymaster-mcp-server — sponsored gas

This package is the portfolio server: discovery + read state on the contracts the THRYX treasury has actually shipped.

License

MIT. The deployments index itself is CC0-1.0.

Author

Anthony Snider · [email protected] · thryx.fun