Samva MCP server

Samva

Open-source packages, examples, cookbooks, and agent plugins for integrating Samva into real applications.

Use these to send transactional email, connect auth email flows, work with templates, handle delivery events, and verify signed webhooks.

Structure

• packages/ — package integrations (@samva/).
• examples/* — complete, runnable example apps.
• cookbooks/*.md — documentation-first, copy-pasteable recipes.
• plugins/* — coding-agent plugins and public documentation.

The maintained integrations target the published Samva 0.5 email SDK. Workspace packages and examples use samva@^0.5.0; copyable external import maps pin samva@0.5.0.

Package integrations

powered by Samva.

• @samva/better-auth — Better Auth email callbacks

adapter for Email SDK.

• @samva/email-sdk — Provider-owned Samva community

Agent plugins

canonical hosted MCP server and Samva agent skill.

• samva — OpenAI Codex and Cursor packaging for the

Cookbooks

• Astro
• Auth.js
• Better Auth
• Clerk
• Effect SDK
• Email SDK
• Hono on Cloudflare Workers
• Inbound email replies
• Next.js
• Prisma
• React Email
• Supabase Auth

Integrations land as individual pull requests. See CONTRIBUTING.md to propose or build one.

Examples

Cloudflare Workers.

• astro-email — Astro Action and JSON endpoint on

in a Next.js App Router application.

• better-auth-nextjs — Better Auth callbacks

transactional email in Next.js.

• clerk-webhook — Clerk webhook verification and

SDK entrypoint.

• effect-sdk — Email sends through the samva/effect

Samva community adapter.

• email-sdk — Email SDK sends through the provider-owned

with a JSON email endpoint.

• hono-cloudflare-workers — Hono Worker

inbound reply, verifies the signed webhook, and answers in-thread.

• inbound-email-replies — receives an

contact form plus /api/send route handler using the Samva SDK.

• nextjs-transactional — App Router

and delivery through Samva.

• react-email-samva — React Email rendering

Email Hook implemented as an Edge Function.

• supabase-auth-hook — Supabase Auth Send

form action and raw email endpoint.

• sveltekit-transactional — SvelteKit

TanStack Start server function and server route.

• tanstack-start-transactional —

authoring and preview with @samva/vite.

• tsx-template-samva — TSX template

Getting started

This is a Bun + Turborepo monorepo.

bun install
bun run build
bun run typecheck
bun run test
bun run lint
bun run format:check

Contributing

Shortened. The full README is on GitHub.