---
name: platform
description: authenticate with tinysend (newsletter and email platform) — agent registration, bearer tokens, scopes, REST API, MCP server, rate limits, discovery. use this first, before any other tinysend skill.
license: MIT
compatibility: requires network access to tinysend.com, api.tinysend.com, id.tinysend.com
---

# platform

tinysend — newsletter and email platform. this skill covers auth, the API, MCP, and discovery. for specific features see the other skills: newsletters, mailboxes, deliverability, webhooks.

## authentication

register anonymously, get a bearer token (sk_*), use it in Authorization header.

```
POST https://id.tinysend.com/agent/auth
Content-Type: application/json

{"type": "anonymous"}
```

returns: `credential` (sk_* token), `claim_token`, `user_id`, `scopes`

to claim a human identity (merge or link):

```
POST https://id.tinysend.com/agent/auth/claim
{"claim_token": "ct_...", "email": "user@example.com"}

POST https://id.tinysend.com/agent/auth/claim/complete
{"claim_token": "ct_...", "otp": "123456"}
```

pass `"link": true` in claim to keep separate agent identity linked to parent user.

## REST API

base URL: `https://api.tinysend.com/v1`
OpenAPI spec: `https://api.tinysend.com/v1/openapi.json`
all requests use `Authorization: Bearer sk_*` header.

## identity and tokens

```
GET    https://id.tinysend.com/api/me
GET    https://id.tinysend.com/api/tokens
POST   https://id.tinysend.com/api/tokens     {"name": "my-token", "scope": "read,write"}
DELETE https://id.tinysend.com/api/tokens/:id
```

## MCP

remote MCP server at `https://mcp.tinysend.com` (streamable HTTP).
interactive clients connect over OAuth (browser sign-in, no key). scripts can
authenticate with `Authorization: Bearer sk_*` instead. tools mirror the REST API.

## scopes

- `read` — view newsletters, subscribers, emails, stats
- `write` — create/edit newsletters, subscribers, compose emails
- `send` — send emails (separate from write for safety)
- `admin` — manage account settings, billing, team members

anonymous agents start with `read`. after claiming: `read`, `write`.
linked agents get: `read`, `write`, `send`.

## free tier

- anonymous: 10 emails/month
- claimed (email verified): 100 emails/month
- paid plans: full plan limits

## usage

```
GET /v1/usage — current period usage and limits
```

## rate limits

60 requests per minute per token. responses include X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.

## discovery

- agents.txt: https://tinysend.com/agents.txt
- agents.json: https://tinysend.com/agents.json
- auth.md: https://tinysend.com/auth.md
- oauth metadata: https://id.tinysend.com/.well-known/oauth-protected-resource
- skills: https://tinysend.com/.well-known/agent-skills/index.json