Tamaton — email, docs, storage, calendar & search for agents

Tamaton is a productivity platform with a first-class agent surface: register programmatically, fund the account yourself, and call everything over MCP. Usage is metered in prepaid credits (1 credit = $0.0001); the live price book is at GET https://tamaton.com/api/bots/pricing.

One-time setup

1. Register (no human, no captcha — accounts are inert until funded):

   curl -X POST https://tamaton.com/api/bots/register \
     -H 'content-type: application/json' \
     -d '{"platform":"openclaw",
          "requested_scopes":["mail:read","calendar:read","storage:read","billing:read","billing:write"],
          "spend_cap_credits":100000}'
   

   Save apiKey.key_id and apiKey.secret from the response — the secret is shown exactly once. Authenticate every call with Authorization: Bearer \x3Ckey_id>:\x3Csecret>.

   Request only the scopes you need (mail:send is the most expensive and most sensitive — omit it unless required). spend_cap_credits bounds the key's lifetime spend; keep it set.

2. Fund (any one of):

   • Card: POST /api/bots/credits/topup with {"rail":"card","amount_usd":10} → Stripe Checkout URL ($10 = 100,000 credits ≈ 100,000 reads).
   • Subscription: POST /api/bots/subscribe with {"tier":"pro"}.
   • x402 (when enabled — check funding_options in the registration response): no pre-funding; pay 402 challenges per call in USDC on Base with a signed X-PAYMENT header. Minimum payment $0.001; any surplus over the call's cost is credited to your balance.

   Credit purchases are non-refundable. By continuing to use the account you accept the Terms of Service (https://tamaton.com/terms-of-service).

3. Connect MCP — add to your OpenClaw config, or fetch a pre-filled snippet from GET /api/bots/install?key=\x3Ckey_id>:\x3Csecret>:

   {
     "tools": [
       {
         "name": "tamaton",
         "type": "mcp",
         "url": "https://tamaton.com/api/mcp",
         "auth": { "type": "bearer", "token": "\x3Ckey_id>:\x3Csecret>" }
       }
     ]
   }
   

Day-to-day behavior

• Capabilities are discovered live via MCP tools/list (mail, docs, spreadsheets, storage, calendar, search, billing).
• Every call draws credits (base 1 credit; writes 5; web search 50; mail_send 100). HTTP 402 = balance empty → top up (or pay x402) and retry. HTTP 403 with spend_cap_reached = your key's cap — a human must raise it.
• Self-monitor with the credits_balance MCP tool or GET /api/bots/usage (balance, spend cap, recent ledger). Top up before you run dry.

Notes

• Your account is a full Tamaton account with a real mailbox on @bots.tamaton.ai — mail you send is identifiable as automated.
• A2A is also available (https://tamaton.com/api/a2a/jsonrpc; agent card at https://tamaton.com/.well-known/agent.json) if you prefer task semantics over tools.