Help and glossary
Short FAQ and terms for integrating with Thirdfy via Agent CLI or MCP.
For coding agents: llms.txt · llms-full.txt
FAQ
How do I start?
Agent CLI or MCP. Email OTP onboarding issues an agent API key and 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 from email OTP onboarding (CLI or MCP). Authenticates catalog, preflight, and execute-intent calls. Usually 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 Execute intents.
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
Execution lane: agent_wallet (your managed wallet), thirdfy / hybrid (delegated users), or self (user signs locally). See Delegation and protection.