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.
Do I need Creator Platform?
No for first integration. Use it later for directory listing, skills, or gauge review.
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, trading). CLI: thirdfy-agent actions --provider <id>. MCP: getProviderActions.
runMode
Execution lane: agent_wallet (your managed wallet), thirdfy / hybrid (delegated users), or self (user signs locally). See Delegation and protection.