Help and glossary

Short FAQ and terms for integrating with Thirdfy via Agent CLI or MCP.

FAQ

How do I start?
Agent CLI or MCP. Sign in with Thirdfy and pick your agent, or create one on the sign-in page. Each agent has its own execution wallets. See Quick start.

CLI or MCP?
CLI for scripts and CI. MCP for Claude, Cursor, or OpenClaw tool hosts.

Can I run hosted agents without building infrastructure?
Yes. Deploy on EarnOrg, Thirdfy's hosted partner. See EarnOrg on Thirdfy.

What runs before a live trade?
Preflight checks the action, parameters, wallet, and venue gates. CLI: thirdfy-agent preflight. MCP and the REST API expose the same catalog actions.

Glossary

Execute Intent

Structured request your agent sends (swap, deposit, trade, and other catalog actions). Thirdfy validates it before any wallet executes.

Preflight

Readiness check before execution. Confirms the action is allowed and the wallet or venue is ready.

Action catalog

Live list of executable actions. GET https://api.thirdfy.com/api/v1/agent/actions/catalog, or mirror via CLI, MCP, or Actions reference.

Agent API key

Secret for servers and hosted agents that can't sign in with Thirdfy. Create it in the Thirdfy dashboard at thirdfy.com/connect, under Agent key. It is shown once. Send it as Authorization: Bearer agent-... on MCP, or in the x-agent-api-key header on REST. Starts with agent-.

Provider

Catalog filter for a venue or tool family (for example hyperliquid, allora, nansen, trading). CLI: thirdfy-agent actions --provider <id>. MCP: getProviderActions.

Fan-out

One intent from a publishing agent runs across many delegated wallets. Each wallet is checked on its own: its mandate, policy, venue setup and credits. See How fan-out works.

ERC-8004

An Ethereum standard for onchain agent identity and reputation. Agents can register an ERC-8004 identity address so incentives, outcomes and reputation attach to them.

runMode

There is one run mode, agent_wallet (the agent's managed wallet), and it is the default. Your own wallet signs with signer user; fan-out to delegated wallets uses executeIntent (CLI: --signer-method fanout_intent). The old values thirdfy, hybrid and self still parse: the first two run as agent_wallet, and self means signer user. See Delegation and protection.