How do I install Samva MCP?

Copy the http config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Samva MCP need an API key?

No required environment variable is listed on this record.

What transport does Samva MCP use?

Samva MCP is reached over HTTP.

When was Samva MCP last checked?

Last checked 2026-11-08. Authenticated Samva email tools, including public documentation and template discovery.

Samva MCP server

Power your agent

Add this server

The publisher's own URL. Not a PlugMCP endpoint.

Add to Cursor Add in Claude Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Server URL

https://mcp.samva.dev

The Claude button above opens Claude with the name and URL filled in. You still confirm it there.

shClaude Code

1claude mcp add --transport http dev.samva-mcp https://mcp.samva.dev

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "dev.samva-mcp": {4      "command": "npx",5      "args": [6        "-y",7        "mcp-remote",8        "https://mcp.samva.dev"9      ]10    }11  }12}

claude_desktop_config.json

Remote · HTTPPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Remote

Transport: http
Version: 1.0.0
Last checked

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

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. Ask questions about the code on DeepWiki.

Structure

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

While Samva is 0.x, the maintained integrations support only the current SDK minor: 0.23. Workspace packages require samva@^0.23.0 as a peer and test against 0.23.0. Examples use samva@^0.23.0; copyable external import maps pin [email protected].

Package integrations

@samva/better-auth — Better Auth email callbacks powered by Samva.
@samva/email-sdk — Provider-owned Samva community adapter for Email SDK.

Agent plugins

samva — OpenAI Codex and Cursor packaging for the canonical hosted MCP server and Samva agent skill.
Samva in ChatGPT — the published ChatGPT plugin is a separate listing from the Codex and Cursor package; the guide covers connecting one organization and a read-only first check.

Cookbooks

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

Examples

astro-email — Astro Action and JSON endpoint on Cloudflare Workers.
better-auth-nextjs — Better Auth callbacks in a Next.js App Router application.
clerk-webhook — Clerk webhook verification and transactional email in Next.js.
effect-sdk — Email sends through the samva/effect SDK entrypoint.
email-sdk — Email SDK sends through the provider-owned Samva community adapter.
hono-cloudflare-workers — Hono Worker with a JSON email endpoint.
inbound-email-replies — receives an inbound reply, verifies the signed webhook, and answers in-thread.
mailbox-agent — an agent that follows a mailbox event stream and replies in approval mode, plus the same behavior as an @samva/mailbox webhook extension.
nextjs-transactional — App Router contact form plus /api/send route handler using the Samva SDK.
react-email-samva — React Email rendering and delivery through Samva.
supabase-auth-hook — Supabase Auth Send Email Hook implemented as an Edge Function.
sveltekit-transactional — SvelteKit form action and raw email endpoint.
tanstack-start-transactional — TanStack Start server function and server route.

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

Related open source

SML — the markup, Vite plugin, and editor behind Samva's TSX templates.
DomainKit — Samva sets up customer domains with DomainKit. See how it works.

Contributing

Contributions are welcome — see CONTRIBUTING.md for local setup, package conventions, and how to propose a new integration. Maintainers use the Tegami release flow for package versions, changelogs, npm publication, tags, and GitHub Releases. GitHub Actions publishes; merging the Version Packages pull request is the human gate.

Security

To report a vulnerability, see SECURITY.md. Please do not file public issues for security reports.

Samva MCP

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Samva MCP?

Does Samva MCP need an API key?

What transport does Samva MCP use?

When was Samva MCP last checked?

Documentation

Samva

Structure

Package integrations

Agent plugins

Cookbooks

Examples

Getting started

Related open source

Contributing

Security

License