Inxmail MCP
The Inxmail MCP server provides programmatic access to Inxmail Commerce's transactional email API, enabling you to send, track, and manage emails directly from Claude.
Email Sending
Trigger transactional email events (e.g. order confirmations, password resets) using pre-configured templates
Send fully custom RFC 5322 (Base64-encoded) raw emails
Check event processing state by transaction ID
Delivery Diagnostics & Tracking
Get a full diagnostic report (sendings, bounces, reactions, block status) for any email address
List transactional and relay sendings with filters (recipient, event type, date range, pagination up to 500 items)
Track opens and clicks (reactions) for both transactional and mail relay emails
View delivery statuses, hard/soft bounces, and feedback loop spam complaints
Block & Blacklist Management
Blocklist (auto-blocked hard bounces): list, check, and remove entries
Blacklist (explicit manual blocks): list, check, add, and remove entries
Combined blocklist + blacklist lookup in a single call
Event & Template Management
List all configured event types and retrieve details of specific ones
Mail Relay
List relay sendings, reactions, bounces, and complaints
System Monitoring
View, retrieve, and mark as read system error log entries (API failures, rendering issues, etc.)
Get API server info to discover available endpoints and verify connectivity
Hosted on GitHub with CI/CD workflows, badges, and open-source collaboration for the Inxmail MCP server implementation.
Built as a Node.js application that serves as an MCP server for Inxmail Commerce, providing programmatic access to email management capabilities through the Inxmail API.
Distributed as an npm package that can be installed globally or used via npx to run the Inxmail MCP server, providing email management tools to Claude.
Utilizes Shields.io badges in the README to display build status, version information, download counts, license, and compatibility badges for the MCP server.
Uses Vitest for unit testing the MCP server implementation, covering API client functionality, tool registration, and error handling.
inxmail-mcp
MCP server for the Inxmail Commerce Transactional API. Manage events, sendings, bounces, blocklist, blacklist, reactions, and delivery tracking — directly from Claude.
Quick Start
1. Install
npm install -g inxmail-mcp
# or use npx (no install needed)2. Get API Credentials
In your Inxmail Commerce admin panel, create an API key under API Login Data. You'll get:
API Key ID (username)
API Secret (password)
Your instance name is the subdomain from your Inxmail Commerce API URL:
https://your-instance.api.inxmail-commerce.com/-> instance =your-instance
3. Configure for Claude Code
claude mcp add inxmail-mcp -e INXMAIL_INSTANCE=your-instance -e INXMAIL_API_KEY_ID=your-key-id -e INXMAIL_API_SECRET=your-secret -- npx -y inxmail-mcpOr from source:
claude mcp add inxmail-mcp -e INXMAIL_INSTANCE=your-instance -e INXMAIL_API_KEY_ID=your-key-id -e INXMAIL_API_SECRET=your-secret -- node /path/to/inxmail-mcp/build/index.js4. Configure for Claude Desktop
Add to claude_desktop_config.json:
{
"mcpServers": {
"inxmail": {
"command": "npx",
"args": ["-y", "inxmail-mcp"],
"env": {
"INXMAIL_INSTANCE": "your-instance",
"INXMAIL_API_KEY_ID": "your-key-id",
"INXMAIL_API_SECRET": "your-secret"
}
}
}
}Available Tools
Core Use Cases
Tool | Description |
| Check delivery status for an email — sendings, bounces, reactions, and block status |
| Check if an email is blocked (blocklist hard bounces + blacklist explicit blocks) |
| Get API entry point with links to all available resources |
Events
Tool | Description |
| Trigger a transactional email event |
| Get the state/result of a triggered event by transaction ID |
| List all configured event types |
| Get a single event type by ID |
Sendings
Tool | Description |
| List sent transaction emails with filters |
| Get details of a specific sending by ID |
Reactions & Tracking
Tool | Description |
| List recipient reactions (opens and clicks) |
| List delivery status information |
Bounces & Complaints
Tool | Description |
| List bounced transaction emails |
| List feedback loop complaints |
Blocklist (Hard Bounces)
Tool | Description |
| List hard-bounce blocked email addresses |
| Check if a specific email is on the blocklist |
| Remove an email from the blocklist |
Blacklist (Explicit Blocks)
Tool | Description |
| List explicitly blacklisted email addresses |
| Check if a specific email is on the blacklist |
| Add an email address to the blacklist |
| Remove an email from the blacklist |
Mail Relay
Tool | Description |
| List mail relay sendings |
| Get details of a specific mail relay sending |
| List mail relay reactions (opens, clicks) |
| List mail relay bounces |
| List mail relay complaints |
Raw Mail
Tool | Description |
| Send a complete RFC 5322 email (Base64-encoded) |
Error Logs
Tool | Description |
| List error log entries |
| Get a single error log entry by ID |
| Mark an error log entry as read |
Example Prompts
"Is test@example.com blocked or blacklisted?"
"Check the delivery status for user@example.com"
"List all bounces from last week"
"Trigger a welcome email event for new-user@example.com"
"Show me all event types configured in the system"
"List recent complaints from the last 30 days"Development
git clone https://github.com/shahabazdev/inxmail-mcp.git
cd inxmail-mcp
npm install
npm run buildTesting
npm test # run all tests
npx vitest # run in watch modeRuns unit tests with Vitest covering:
API client (auth, request methods, query params, pagination, error handling)
Tool registration (all 29 tools registered, no duplicates)
Environment Variables
Variable | Required | Description |
| Yes | Instance subdomain (e.g. |
| Yes | API Key ID |
| Yes | API Secret |
License
MIT
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/shahabazdev/inxmail-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server