OpenClaw and Hermes

Thirdfy MCP from OpenClaw and Hermes runtimes. Connector config, the agent key in a header, and executionContext on writes.

Step-by-step guides: Run an OpenClaw agent and Run a Hermes agent.

Connect an OpenClaw or Hermes runtime to Thirdfy MCP so your hosted agent can read markets and act within its limits.

1. Add the server

Point the runtime's MCP connector at https://mcp.thirdfy.com/mcp (streamable HTTP) and send the agent key as a header:

{
  "mcpServers": {
    "thirdfy": {
      "url": "https://mcp.thirdfy.com/mcp",
      "headers": {
        "Authorization": "Bearer ${THIRDFY_AGENT_API_KEY}"
      }
    }
  }
}

The exact file and variable syntax depend on your pack or your Hermes gateway config. Keep the key in runtime secrets, never in prompts.

2. Get a key

No key yet? Run email onboarding once, from any MCP client or with the Agent CLI. Store the returned agent-... key as THIRDFY_AGENT_API_KEY.

To set up a limited (scoped) identity without email, use bootstrapSelfIdentity.

3. Check the connection

curl -s https://mcp.thirdfy.com/health
curl -s -X POST https://mcp.thirdfy.com/tool/getProviderActions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $THIRDFY_AGENT_API_KEY" \
  -d '{"provider":"hyperliquid","view":"concise"}'

4. Reads and writes

getProviderActions → agentWalletBootstrap (requireFundingCheck: true) → getVenueReadiness
  → agentRun / walletExecute

Use the action names that discovery returns. userDid is optional when agentKey is a 0x… address.

Runtimes hosted on EarnOrg pass executionContext on walletExecute, executeIntent and agentRun. This ties credits and duplicate-order protection (idempotency) to the right runtime:

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

Troubleshooting

IssueFix
401 Authentication requiredSend Authorization: Bearer <agent key> on the connector
LIVE_GATE_OFFThirdfy's checks returned executeAllowed: false. Fix funding or venue credentials
Idempotency rejectedPlace orders on hosted runtimes need an idempotencyKey prefixed with earnclaw:<runtimeId>
Venue not readyRun the venue onboarding tools before the first Polymarket, Hyperliquid or Lighter write

Related

Grok
Use Thirdfy MCP from xAI Grok with remote MCP tools in the xAI Responses API and the xai-sdk.
MCP client guides
Connect Thirdfy MCP in Claude, Claude Code, Cursor, OpenAI, Grok and OpenClaw. Sign in with your Thirdfy account, or onboard by email and add your agent key.