Quick start

Sandbox on testnet in about 10 minutes. Full integration typically takes 1–2 hours. CLI, MCP, or EarnClaw hosted deploy.

For coding agents: Use llms.txt for a curated URL map, or llms-full.txt for the full API snapshot in one file.

At a glance

Thirdfy validates and executes finance agent intents. Pick integrate rails (CLI/MCP/API) or deploy on EarnClaw (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["EarnClaw 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 below"]
  G --> D["Delegation and protection"]
  E --> EC["earnclaw.com"]
  O --> U["For users + credits"]

Path	Typical time	Best for
Sandbox (testnet)	~10 minutes	Catalog smoke, MCP tools, no wallet setup
Agent wallet + email login	~30–60 minutes first time	Solo agents you build and run (simplest production path)
User wallet delegation (Gator)	~1–2 hours first time	External wallet authority, mandates, fan-out publishers
EarnClaw deploy	~a few minutes	Hosted wizard and schedules without building your own runtime

Simplest dev path (agent wallet + email)

Start here if you are building your own agent and trades run from your agent execution wallet (you fund that wallet after email login).

You do not need the Creator Platform first. Email onboarding registers the owner, bootstraps an agent API key, and provisions managed execution wallets in one flow. Use the Creator Platform later if you want the web UI, skills upload, or gauge submission.

This lane uses runMode=agent_wallet. No EIP-712 delegation grant in MetaMask.

Step	CLI	MCP
1. Email OTP	`thirdfy-agent login email you@example.com --json` then `login email … --code "<otp>" --accept-terms --key-name "My Agent" --json`	`startEmailOnboarding` → `completeEmailOnboarding` (`acceptTerms: true`)
2. Confirm credentials	`thirdfy-agent whoami --json` (stores `agentApiKey`, owner session, `executionWallets`)	Response may include agent credentials; then `getWalletProfile`
3. Execution wallet	Use `executionWallets` from step 1 (or `agentWalletBootstrap` if you need a refresh)	`agentWalletBootstrap` when collateral checks require it
4. Discover + preflight	`thirdfy-agent actions` → `preflight`	`getProviderActions` → preflight tools
5. Execute	`thirdfy-agent run --run-mode agent_wallet`	`walletExecute` or `agentRun`

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

Optional: agentRegister (MCP) or Creator Platform for directory profile, skills packages, and emissions review. Not required to run your first preflight and write.

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

Use Gator / ERC-7710 when a user's external wallet must delegate scoped authority to your agent. That path adds a MetaMask EIP-712 sign step. See Delegation and protection.

Sandbox (~10 minutes)

Try discovery and MCP 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:

Surface	URL
Testnet API	`https://api-test.thirdfy.com`
Testnet app (Base Sepolia)	testnet.thirdfy.com
DogeOS Chikyu demo chain	See DogeOS integrations

This sandbox proves connectivity. It does not replace delegation, wallet funding, or venue setup for live execution.

Path 1 — Integrate rails (CLI and MCP)

Step	What to read
1	Build with Thirdfy
2	Simplest path: Agent wallet + email
3	Agent CLI or MCP (`https://mcp.thirdfy.com/mcp`)
4	Integrations for venue setup
5	Delegation and protection when you add user wallet delegation