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-mcp
Or 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.js
4. 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
Events
Sendings
Reactions & Tracking
Bounces & Complaints
Blocklist (Hard Bounces)
Blacklist (Explicit Blocks)
Mail Relay
Raw Mail
Error Logs
Example Prompts
"Is [email protected] blocked or blacklisted?"
"Check the delivery status for [email protected]"
"List all bounces from last week"
"Trigger a welcome email event for [email protected]"
"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 build
Testing
npm test # run all tests
npx vitest # run in watch mode
Runs 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
License
MIT