@thryx/portfolio-mcp-server

@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 · [e-mail] · thryx.fun