# Wraps

> Deploy email, SMS, and CDN infrastructure to your AWS account with one command.
> Modern DX. AWS economics. Full ownership.

Wraps is a CLI and TypeScript SDK that deploys production-ready AWS infrastructure (SES, Lambda, DynamoDB, EventBridge, CloudFront) to your account. Zero credentials stored. OIDC authentication. You own everything.

## Quick Start

```bash
npx @wraps.dev/cli email init  # Deploy email infrastructure (~2 min)
npx @wraps.dev/cli sms init    # Deploy SMS infrastructure
npx @wraps.dev/cli cdn init    # Deploy CDN (S3 + CloudFront)
```

```bash
npm install @wraps.dev/email
```

```typescript
import { WrapsEmail } from '@wraps.dev/email';
const email = new WrapsEmail();
await email.send({
  from: 'hello@yourdomain.com',
  to: 'user@example.com',
  subject: 'Welcome!',
  html: '<h1>Hello!</h1>',
});
```

## Pricing

Wraps charges for the platform. You pay AWS directly for sending — $0.10/1,000 emails on SES à la carte, $0.16/1,000 on the Essentials plan AWS assigns to new accounts by default. Full pricing, SES plan detail, and a cost estimator API: https://wraps.dev/pricing.md

| Plan | Price | Tracked Events/mo | AWS Accounts |
|------|-------|-------------------|--------------|
| Free | $0 | 5,000 | 1 |
| Starter | $19/mo | 50,000 | 1 |
| Growth | $79/mo | 250,000 (+$0.50/1K) | 3 |
| Scale | $199/mo | 1,000,000 (+$0.15/1K) | Unlimited |

Annual plans available (save ~16%). All paid plans: unlimited contacts, unlimited team members.

## Start Without an Account

- `npx @wraps.dev/cli email init` deploys into your own AWS account with your own AWS credentials. No Wraps account is involved.
- Free tier: $0/month, 5,000 tracked events, 1 AWS account. Sign up at https://app.wraps.dev/sign-up.
- API keys are self-serve in the dashboard under Settings → API Keys. Headless clients use the OAuth 2.0 Device Authorization Grant via `wraps auth login`.
- Test environment: new AWS SES accounts start in the SES sandbox — sending is limited to verified addresses and the SES mailbox simulator (`success@simulator.amazonses.com`, `bounce@simulator.amazonses.com`, `complaint@simulator.amazonses.com`). `wraps doctor` reports sandbox state.
- Nothing here requires talking to a salesperson.

## MCP Servers

- Hosted, no auth: `https://wraps.dev/mcp` (Streamable HTTP) — `search_docs`, `get_doc`, `list_docs`, `estimate_cost`.
- Local, your AWS: `npx -y @wraps.dev/mcp` (stdio) — send history, delivery events, domain status, suppressions, guarded sending.
- Manifest: https://wraps.dev/.well-known/mcp.json

## Zero-Auth Endpoints

| Endpoint | What it returns |
|----------|-----------------|
| `https://wraps.dev/mcp` | MCP over Streamable HTTP |
| `https://wraps.dev/api/pricing/estimate` | Itemized Wraps + AWS cost estimate as JSON or markdown |
| `https://wraps.dev/llms.txt` | Index of every page on the site |
| `https://wraps.dev/llms-full.txt` | The whole documentation corpus |
| `https://wraps.dev/.well-known/agent.json` | Agent card: capabilities, packages, onboarding |
| `https://api.wraps.dev/swagger/json` | OpenAPI 3.0.3 specification |

## Key Pages

- [Email Quickstart](https://wraps.dev/docs/quickstart/email)
- [SMS Quickstart](https://wraps.dev/docs/quickstart/sms)
- [CDN Quickstart](https://wraps.dev/docs/quickstart/cdn)
- [Platform Quickstart](https://wraps.dev/docs/quickstart/platform)
- [Agent Email Quickstart](https://wraps.dev/docs/quickstart/email/agents)
- [Email SDK Reference](https://wraps.dev/docs/sdk-reference)
- [SMS SDK Reference](https://wraps.dev/docs/sms-sdk-reference)
- [CLI Reference](https://wraps.dev/docs/cli-reference)