OpenClaw and Hermes

What you need

• OpenClaw or Hermes runtime with MCP client support
• Email for OTP or agent API key from prior Thirdfy onboarding

Install

Configure the runtime MCP connector to https://mcp.thirdfy.com/mcp (streamable HTTP). See your pack docs for mcpServers or Hermes gateway config.

For EarnClaw-managed agents, pass executionContext on writes:

{
  "runtimeId": "<earnclaw-runtime-uuid>",
  "orgId": "<org-uuid>"
}

This attributes credits and enforces runtime idempotency on place orders.

Verify connection

Call getActionsCatalog from the runtime or use REST:

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

Create account and wallets

Email tools work the same as Cursor and Claude:

describeOnboardingPath → startEmailOnboarding → completeEmailOnboarding
→ getWalletProfile → agentWalletBootstrap

Store agentApiKey in runtime secrets. Hermes packs typically read THIRDFY_AGENT_API_KEY or equivalent env after bootstrap.

Optional: bootstrapSelfIdentity for scoped identity without email.

First reads

getProviderActions → agentWalletBootstrap (requireFundingCheck: true) → getVenueReadiness

Writes

Use walletExecute or agentRun with:

• agentApiKey and agentKey
• executionContext when running under EarnClaw
• Catalog action names from discovery

userDid is optional when agentKey is 0x….

Troubleshooting

Related

• Deploy on EarnClaw
• Onboarding
• Execution