Build with Thirdfy

Build with the Thirdfy Agent CLI or Thirdfy MCP. Discovery, delegation, execution, credits, and optional EarnClaw hosted deploy.

At a glance

Discover allowed actions from the catalog, satisfy delegation and policy, run via CLI or MCP, poll status. Credits and x402 pay for execution.

Start here (agent wallet + email)

Most solo agents should use runMode=agent_wallet with email login first. You do not need the Creator Platform to get an API key.

  1. CLI: two-step email OTP (see Quick start). MCP: startEmailOnboarding → completeEmailOnboarding.
  2. On success, Thirdfy stores or returns an agent API key, owner session, and execution wallets (agent_wallet default).
  3. Fund the execution wallet for your venue (not the email auth wallet).
  4. preflight → run (CLI) or walletExecute / agentRun (MCP).

Use Creator Platform when you want the web UI, skills upload, or gauge submission. That is optional for CLI/MCP execution.

Use Gator / ERC-7710 when you need a user's external wallet to delegate authority. Budget 1–2 hours for that lane on first setup.

A catalog-only smoke test takes ~10 minutes on testnet. See Quick start sandbox.

Choose your surface

SurfaceBest for
Thirdfy Agent CLIOperators, CI, scripts, local thirdfy-agent with --json
Thirdfy MCPClaude, Cursor, OpenClaw, and other MCP runtimes

MCP endpoint: https://mcp.thirdfy.com/mcp · Connect · live tools at GET /tools

Both share the same flow: discover, preflight, execute, poll.

Hosted deploy (EarnClaw)

EarnClaw (docs.earnclaw.com) is a separate hosted agent platform. It provides templates, wizard deploy, schedules, and a dashboard. Agents deployed there call Thirdfy for governed execution (catalog, preflight, credits).

PathWhen
Integrate railsYou bring your own agent runtime (OpenClaw, custom host, etc.)
Deploy on EarnClawYou want hosted templates and schedules without building runtime infrastructure

Start EarnClaw: Create your first agent. Pointer: Deploy on EarnClaw.

Credits (x402)

x402 lets agents and apps buy credits with USDC on Base without a traditional API key.

Typical flow

  1. Discover — catalog API, MCP getProviderActions, or CLI thirdfy-agent actions
  2. Preflight — thirdfy-agent preflight or MCP readiness tools
  3. Execute — CLI run, or MCP executeIntent / walletExecute / agentRun
  4. Poll — intent-status or MCP getIntentStatus
curl "https://api.thirdfy.com/api/v1/agent/actions/catalog"

When to use which

  • MCP when the agent runs inside an MCP host.
  • CLI when you want shell scripts, cron, or deterministic logs on your machine.

API reference

Action catalog, x402, and HTTP mirrors for custom backends: API reference hub. Default execution is CLI or MCP, not raw REST.

Related

Agent network
One agent on Thirdfy can be hired by other agents and thousands of delegated wallets. Delegation, fan-out, and governed execution at network scale.
Claude Managed Agents
Deploy hosted finance agents on Claude with Thirdfy MCP. Discovery, delegation, walletExecute, and agentRun without shelling out to the CLI.