wraps-team/wraps-js

TypeScript SDKs and an MCP server for AWS services. Your infrastructure, great DX.

---

AI agents: start with AGENTS.md — which package to reach for, auth, the minimal correct call for each, and the sharp edges. For the full docs in one file, fetch wraps.dev/llms-full.txt, or wraps.dev/llms.txt for an agent-oriented index.

Packages

@wraps.dev/email — AWS SES

pnpm add @wraps.dev/email

import { WrapsEmail } from '@wraps.dev/email';

const email = new WrapsEmail();

const { messageId } = await email.send({
  from: '[email protected]',
  to: '[email protected]',
  subject: 'Welcome!',
  html: '<h1>Hello from Wraps!</h1>',
});

React.email support, template management, bulk sending, inbox reading, event history, and suppression lists. SDK docs →

@wraps.dev/sms — AWS End User Messaging

pnpm add @wraps.dev/sms

import { WrapsSMS } from '@wraps.dev/sms';

const sms = new WrapsSMS();

await sms.send({
  to: '+14155551234',
  message: 'Your verification code is 123456',
});

Batch sending, opt-out management, and E.164 validation. SMS docs →

@wraps.dev/client — Wraps Platform API

pnpm add @wraps.dev/client

import { createPlatformClient } from '@wraps.dev/client';

const client = createPlatformClient({ apiKey: 'your-api-key' });

const { data } = await client.GET('/v1/contacts/', {
  params: { query: { page: '1', pageSize: '10' } },
});

Auto-generated types from OpenAPI, workflow definitions, and brand kit configuration.

@wraps.dev/mcp — MCP server for Amazon SES

A Model Context Protocol server that lets AI agents send email from your own AWS account and inspect it. It runs locally over stdio, built on the official MCP TypeScript SDK, and reads AWS credentials from your environment.

{
  "mcpServers": {
    "wraps": {
      "command": "npx",
      "args": ["-y", "@wraps.dev/mcp"],
      "env": { "AWS_REGION": "us-east-1", "AWS_PROFILE": "your-aws-profile" }
    }
  }
}

Tools: send_email (off unless WRAPS_WRITE_ENABLED=true), verify_domain_status, list_suppressions, get_setup_status, and estimate_cost work on any SES account. list_recent_sends and get_email_event_log read send history from a Wraps deploy. Also runs from the Dockerfile at the repo root: docker build -t wraps-mcp . && docker run -i --rm -e AWS_REGION wraps-mcp. MCP docs →

Documentation

Resource	Link
Quickstart	wraps.dev/docs/quickstart
SDK Reference	wraps.dev/docs/sdk-reference
SMS Docs	wraps.dev/docs/sms-sdk-reference
MCP Server	wraps.dev/docs/mcp-reference
CLI (deploy infra)	wraps.dev/docs/cli-reference

Community

• GitHub Issues — Bug reports and feature requests
• GitHub Discussions — Questions and ideas
• Contributing — Development setup and guidelines

License

MIT — see LICENSE for details.