Tamaton

SKILL.md

---
name: tamaton
description: Give your agent a real email address, calendar, documents, spreadsheets, file storage, and web search via Tamaton's MCP endpoint. Self-register with no human, fund by card/subscription/x402, pay per call from a prepaid credit balance.
homepage: https://tamaton.com/documentation
metadata:
  openclaw:
    emoji: "📬"
    requires:
      bins:
        - curl
---

# 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):

   ```bash
   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 <key_id>:<secret>`.

   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=<key_id>:<secret>`:

   ```jsonc
   {
     "tools": [
       {
         "name": "tamaton",
         "type": "mcp",
         "url": "https://tamaton.com/api/mcp",
         "auth": { "type": "bearer", "token": "<key_id>:<secret>" }
       }
     ]
   }
   ```

## 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.