MCP Overview

The Transactional MCP Server allows AI assistants like Claude to interact with your Transactional account directly. Send emails, manage templates, check statistics, and more through natural language.

What is MCP?

Model Context Protocol (MCP) is a standard for connecting AI assistants to external tools and data sources. When you add Transactional as an MCP server, your AI assistant gains the ability to:

Send transactional emails on your behalf
Manage email templates
Check delivery statistics
Manage domains and senders
View organization information
And more

Supported AI Assistants

Assistant	Support
Claude Desktop (Pro/Max/Team/Enterprise)	Native OAuth support
Claude Desktop (Free)	Via mcp-remote
Claude Code	Full OAuth support
Other MCP clients	Compatible (OAuth 2.1)

Authentication

Transactional MCP uses OAuth 2.1 for secure authentication:

No tokens in config files - Your credentials are never stored in plain text
Browser-based login - Authenticate securely through your browser
Automatic token refresh - Claude handles token management
Scoped access - Tokens are scoped to your user permissions

When you first use a Transactional tool, Claude will prompt you to authorize access through your browser.

Quick Setup

Claude Desktop (Pro/Max/Team/Enterprise)

Go to Settings → Integrations → Add Custom Integration
Enter: https://mcp.usetransactional.com
Authorize when prompted

Claude Desktop (Free) or Claude Code

# Install Transactional CLI
npm install -g @usetransactional/cli
 
# Install MCP config
transactional mcp install

See Setup Guide for detailed instructions.

Available Tools

Once connected, your AI assistant can use these tools:

Email Operations

Tool	Description
`transactional_email_send`	Send a single email
`transactional_email_batch`	Send multiple emails
`transactional_email_stats`	Get email statistics

Templates

Tool	Description
`transactional_templates_list`	List all templates
`transactional_templates_get`	Get template details
`transactional_templates_create`	Create a new template

Domains & Senders

Tool	Description
`transactional_domains_list`	List configured domains
`transactional_domains_add`	Add a new domain
`transactional_senders_list`	List email senders
`transactional_suppressions_list`	List suppressed emails

Organization

Tool	Description
`transactional_whoami`	Current user info
`transactional_orgs_list`	List organizations
`transactional_orgs_switch`	Switch organization
`transactional_api_keys_list`	List API keys
`transactional_members_list`	List team members

Billing

Tool	Description
`transactional_billing_usage`	Get current usage
`transactional_billing_invoices`	List invoices
`transactional_billing_plan`	Get plan details

Example Conversations

Once MCP is configured, you can interact naturally:

You: "Send a welcome email to john@example.com from hello@mycompany.com"

Claude: "I'll send a welcome email for you." Uses transactional_email_send tool "Done! The welcome email has been sent to john@example.com. Message ID: msg_abc123"

You: "What are my email stats for this week?"

Claude: "Let me check your email statistics." Uses transactional_email_stats tool "Here are your stats for this week:

Sent: 1,234 emails
Delivered: 1,220 (98.9% delivery rate)
Opened: 856 (70.2% open rate)
Clicked: 234 (19.2% click rate)"

Security

OAuth 2.1 with PKCE - Industry-standard secure authorization
No stored credentials - Tokens managed by Claude, not in config files
90-day token expiry - Automatic refresh handled by Claude
Audit trail - All operations logged in your Transactional dashboard
Revoke anytime - Revoke access from your account settings

MCP Server URL

https://mcp.usetransactional.com

Next Steps

Setup Guide - Detailed installation instructions
Available Tools - Complete tool reference
Troubleshooting - Common issues and solutions
Claude Code Guide - Claude Code specific features