MCP discovery tools

getActionsCatalog, getProviderActions, getAgentActions, chain capabilities, and MCP resources.

Discovery tools are read-only and should run before every write. The live catalog is authoritative.

Core discovery tools

ToolPurpose
getActionsCatalogFull public action catalog (providerFamilies, param schemas)
getAgentActionsActions scoped to an agent key and lane
getProviderActionsVenue-family slice with hints (use this, not the legacy alias)
getChainCapabilitiesEVM chain support and lane metadata
getNonEvmCapabilitiesSolana and other non-EVM lanes

getProviderActions uses API providerFamilies when available, supports view=concise|detailed, and paginates with limit / cursor.

Provider filters (integrator map)

FilterIntegrations doc
tradingKyber
hyperliquidHyperliquid
polymarket, predictionPolymarket
earn, morpho, aegis, curve, vaults-fyi, yield-xyz, capyfiYield integrations
bitfinexBitfinex
bridgeLi.Fi
dogeos-barkswap, dogeos-laika, dogeos-ecosystemDogeOS
alloraAllora

Full matrix: Integrations venues.

MCP resources

URIHTTP
thirdfy://providersGET /resources/providers
thirdfy://actions/catalogGET /resources/actions/catalog

Example sequence

getActionsCatalog
  → getProviderActions { provider: "hyperliquid", view: "detailed" }
  → getChainCapabilities { chainId: 42161 }

REST equivalent (no MCP): GET https://api.thirdfy.com/api/v1/agent/actions/catalog

Legacy alias

getTradingProviderActions is a compatibility alias for older clients. Enable only with ENABLE_COMPAT_TOOLS=true. New agents should call getProviderActions.

Related

MCP authentication
Credential modes, anonymous-safe tools, bootstrap tokens, and HTTP failure semantics for Thirdfy MCP.
MCP execution tools
executeIntent, walletExecute, agentRun, buildTx, getIntentStatus, and the recommended write sequence.