Quick start

Thirdfy lets your AI agent trade, earn and move money onchain, with limits and safety checks on every action. Pick the way you want to start: hand setup to your AI agent, connect over MCP, use the command line, or use Console with no code.

Pick your path

Read https://docs.thirdfy.com/agents.md and set up Thirdfy for me.

1. Add https://mcp.thirdfy.com/mcp/public to your agent host.
2. Ask: "Use Thirdfy to onboard me with you@example.com."
   Save the agent-... key it returns.
3. Switch the URL to https://mcp.thirdfy.com/mcp and either
   sign in (claude.ai, ChatGPT, Cursor) or add the header:
   Authorization: Bearer agent-...
4. Ask: "Using Thirdfy, read the latest BTC funding on Hyperliquid."

npm install -g @thirdfy/agent-cli
thirdfy-agent login email you@example.com --json
thirdfy-agent login email you@example.com --code "<otp>" --accept-terms --json
thirdfy-agent run --action get_openmarket_btc_funding --provider openmarket --json

No code: open https://thirdfy.com/console, sign in with email,
and ask Command for balances, quotes or a trade.

Before your first trade, check that the venue is ready (MCP getVenueReadiness, CLI thirdfy-agent venue readiness <venue>) and fund the execution wallet. See Run & status.

Simplest dev path (agent wallet + email)

Start here if you build your own agent and want its trades to run from your agent's execution wallet. You fund that wallet after you log in with email.

One email sign-up registers you as the owner, creates an agent API key, and sets up managed execution wallets.

This path uses runMode=agent_wallet. You don't sign an EIP-712 delegation grant in MetaMask.

Machine-readable steps: thirdfy-agent help onboarding --json or MCP describeOnboardingPath.

Would you rather not run your own agent? Deploy a hosted one on EarnOrg.

Details: CLI authentication · MCP onboarding · Delegation: agent_wallet lane

Use Gator / ERC-7710 instead when a user's own external wallet must give your agent limited, scoped authority. That path adds a signing step in MetaMask (EIP-712). See Delegation and protection.

Sandbox (~10 minutes)

Try the action catalog and MCP tools without mainnet wallets or delegation.

1. Public catalog (no auth):

curl "https://api-test.thirdfy.com/api/v1/agent/actions/catalog"

2. MCP tool list:

curl -s https://mcp.thirdfy.com/tools
curl -s -X POST https://mcp.thirdfy.com/tool/getActionsCatalog \
  -H "Content-Type: application/json" -d '{}'

3. Testnet surfaces:

The sandbox only shows that you can connect. It does not replace delegation, wallet funding or venue setup for live execution.

Path 1 — Integrate rails (CLI and MCP)

Credits: Credits for users · x402 API

Package: @thirdfy/agent-cli on npm

Path 1b — Deploy on EarnOrg

These docs cover how Thirdfy runs your agent's actions, not EarnOrg's deploy screens. After you open EarnOrg:

1. What is EarnOrg
2. Create your first agent
3. Build with Thirdfy (how Thirdfy fits under the hood)

Path 2 — Operators (no terminal)

Use Thirdfy with no terminal. Buy credits and learn how delegation works before agents act for you.

• Operate with Console
• Credits
• Execute intents
• Delegation and protection

Which path fits

Thirdfy checks and runs the financial actions your agents ask for. Choose to integrate rails (CLI, MCP or API) or deploy on EarnOrg (a separate hosted platform).

flowchart TD
  A["Where do you want to start?"] --> B{"Your goal"}
  B -->|"Smoke test, no wallets"| S["Sandbox ~10 min"]
  B -->|"Build your own agent"| C{"Whose wallet executes trades?"}
  B -->|"Hosted templates, no runtime build"| E["EarnOrg deploy ~a few minutes"]
  B -->|"Use thirdfy.com only"| O["Operators: credits + delegate"]
  C -->|"Your agent execution wallet"| AW["agent_wallet + email ~30–60 min"]
  C -->|"Wallets others delegate to your agent"| G["Gator / execute-intent ~1–2 h"]
  S --> T["testnet API + MCP catalog"]
  AW --> L["Simplest dev path above"]
  G --> D["Delegation and protection"]
  E --> EC["earnorg.com"]
  O --> U["For users + credits"]

Related

• Hosted agents (EarnOrg)
• Help