MCP discovery tools

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

Use discovery tools to find out what your agent can do: which actions exist, which providers offer them, and which chains they run on. They only read, so run them before every write. The live catalog is always the source of truth.

Core discovery tools

ToolPurpose
getActionsCatalogFull public action catalog (providerFamilies, param schemas)
getAgentActionsThe actions one agent key may call, for its run mode (lane)
getProviderActionsOne provider's actions, with hints
getChainCapabilitiesSupported EVM chains, with run-mode (lane) details
getNonEvmCapabilitiesSolana and other non-EVM chains

getProviderActions details:

InputNotes
provider or providerIdEither name works; both take the same values
viewconcise or detailed
limit, cursorPage through long results

It uses the API's providerFamilies when available.

Provider filters (integrator map)

Pass one of these values as provider to see that integration's actions.

FilterIntegrations doc
tradingKyber
hyperliquidHyperliquid
avantis, avantis-vaultVeranta (formerly Avantis)
polymarket, predictionPolymarket
earn, morpho, aegis, curve, vaults-fyi, yield-xyz, capyfiYield integrations
bitfinexBitfinex
bridgeLi.Fi
dogeos-barkswap, dogeos-laika, dogeos-ecosystemDogeOS
alloraAllora
nansenNansen
fomoFomo API
cmcCoinMarketCap
openmarket, openmarket-metricsOpenMarket
gmgnGMGN
basedbidbasedbid

For every venue, see Integrations venues.

Typed toolsets

By default, your agent reaches the catalog through general tools: it looks up an action with getProviderActions, then runs it with agentRun. To give the model one tool per action, each with its own input fields, add ?toolsets= to the connector URL:

https://mcp.thirdfy.com/mcp?toolsets=hyperliquid,openmarket
https://mcp.thirdfy.com/mcp?toolsets=signals
https://mcp.thirdfy.com/mcp?toolsets=perps,yield&readonly=1
ValueAdds
A provider id (hyperliquid, polymarket, openmarket, cmc, ...)That provider's actions
A domain (perps, yield, prediction, ...)Every action in that domain
signalsThe read-only data reads that publish signals. They return typed values, parse issues and freshness as structuredContent
allEverything your agent may call
&readonly=1Keeps read-only tools only

Good to know:

  • Typed tools appear only on a connection that sends an agent key, and only for actions that agent may call.
  • One connection gets at most 50 typed tools, so name only the providers you need.
  • veranta and veranta-vault map to the avantis and avantis-vault providers.

MCP resources

Hosts that read MCP resources can fetch the provider list and catalog directly. Each one also has a plain HTTP route.

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

Example sequence

A typical discovery pass before a Hyperliquid write:

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

Without MCP, the REST equivalent is GET https://api.thirdfy.com/api/v1/agent/actions/catalog.

Related

Connect and authenticate
The Thirdfy MCP endpoint, signing in with your Thirdfy account, the agent key header, credential modes, and direct REST tool calls.
Execution, delegation, and tracking
previewOrder, walletExecute, executeIntent, write confirmation, delegation tools, agentWalletBootstrap, and post-trade analytics.