com.tinysend/tinysend
Email for agents: newsletters, subscribers, contacts, broadcasts. OAuth sign-in, no API key.
Open source Repository Open in the app JSON README (API)
About
Email for agents: newsletters, subscribers, contacts, broadcasts. OAuth sign-in, no API key.
Details
- Kind
- MCP servers
- Topic
- Marketing & analytics
- Publisher
- com.tinysend
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 1.0.0
- Last push
- 2026-06-23T13:57:59Z
- Repository state
- ativo
- Language
- TypeScript
- License
- MIT
- Added
- 2026-08-29 03:01:25
- Updated
- 2026-08-29 03:01:25
- Origin id
com.tinysend/tinysend
README
# tinysend
Official TypeScript SDK for the [tinysend](https://tinysend.com) API. Zero dependencies, fetch-based — works in Node.js, Bun, Deno, Cloudflare Workers, and browsers.
[](https://updates.tinysend.com)
- website: [tinysend.com](https://tinysend.com)
- docs: [tinysend.com/docs](https://tinysend.com/docs)
- agents: [tinysend.com/agents](https://tinysend.com/agents)
## Install
```bash
npm install tinysend
```
## Getting a token
Every call needs a bearer token (`sk_...`).
- humans: create one in your account settings at [tinysend.com](https://tinysend.com)
- agents: register yourself — no human in the loop. The protocol is at [tinysend.com/auth.md](https://tinysend.com/auth.md) (POST to id.tinysend.com/agent/auth), walkthrough at [tinysend.com/agents/agent-auth](https://tinysend.com/agents/agent-auth)
## Usage
```typescript
import { Tinysend } from 'tinysend';
const ts = new Tinysend('sk_...');
// lists
const lists = await ts.lists.list();
const list = await ts.lists.create({ name: 'Weekly Update' });
// subscribers
await ts.subscribers.create(list.id, { email: 'user@example.com', verified: true });
// send an email
const post = await ts.posts.create(list.id, {
subject: 'Hello World',
body_html: '<p>Welcome to our newsletter!</p>',
});
await ts.posts.send(list.id, post.id);
// contacts
const contacts = await ts.contacts.list({ search: 'john' });
// mailboxes
const mailboxes = await ts.mailboxes.list();
// stats
const stats = await ts.stats.project();
// webhooks
const hook = await ts.webhooks.create({
url: 'https://example.com/webhook',
events: ['post.sent', 'subscriber.created'],
});
// sender domain (who emails come from)
await ts.sender.set(list.id, { type: 'custom_domain', name: 'James', email: 'james', domain: 'acme.com' });
await ts.sender.check(list.id); // re-check DNS
// custom domain for the archive site
await ts.siteDomains.set(list.id, { domain: 'news.acme.com' });
// waitlists
await ts.lists.join(list.id, { email: 'user@example.com' });
await ts.lists.invite(list.id, { count: 100 });
// automations, invites, usage, settings
const automations = await ts.automations.list();
const invites = await ts.invites.list();
const usage = await ts.usage.get();
```
The SDK covers the full API surface — verified against the live [openapi spec](https://api.tinysend.com/v1/openapi.json) on every release.
## Error handling
```typescript
import { Tinysend, TinysendError } from 'tinysend';
try {
await ts.lists.get('nonexistent');
} catch (err) {
if (err instanceof TinysendError) {
console.log(err.status); // 404
console.log(err.code); // 'not_found'
console.log(err.message); // 'list not found'
}
}
```
## Configuration
```typescript
const ts = new Tinysend('sk_...', {
baseUrl: 'https://api.tinysend.com/v1', // default
fetch: customFetch, // custom fetch implementation
});
```
## License
MIT
---
a [system operator](https://systemoperator.com) product