How do I install Inxmail?

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

Does Inxmail need an API key?

No required environment variable is listed on this record.

What transport does Inxmail use?

Inxmail runs locally over stdio.

When was Inxmail last checked?

Last checked 2026-10-28. MCP server for the Inxmail Commerce transactional API — events, sendings, bounces, blocklist, blacklist, reactions, and delivery tracking from Claude.

Servidor MCP Inxmail

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

Tool	Description
`check_email_delivery`	Check delivery status for an email — sendings, bounces, reactions, and block status
`check_email_blocked`	Check if an email is blocked (blocklist hard bounces + blacklist explicit blocks)
`get_server_info`	Get API entry point with links to all available resources

Events

Tool	Description
`trigger_event`	Trigger a transactional email event
`get_event_state`	Get the state/result of a triggered event by transaction ID
`list_event_types`	List all configured event types
`get_event_type`	Get a single event type by ID

Sendings

Tool	Description
`list_sendings`	List sent transaction emails with filters
`get_sending`	Get details of a specific sending by ID

Reactions & Tracking

Tool	Description
`list_reactions`	List recipient reactions (opens and clicks)
`list_deliveries`	List delivery status information

Bounces & Complaints

Tool	Description
`list_bounces`	List bounced transaction emails
`list_complaints`	List feedback loop complaints

Blocklist (Hard Bounces)

Tool	Description
`list_blocklist`	List hard-bounce blocked email addresses
`get_blocklist_entry`	Check if a specific email is on the blocklist
`remove_from_blocklist`	Remove an email from the blocklist

Blacklist (Explicit Blocks)

Tool	Description
`list_blacklist`	List explicitly blacklisted email addresses
`get_blacklist_entry`	Check if a specific email is on the blacklist
`add_to_blacklist`	Add an email address to the blacklist
`remove_from_blacklist`	Remove an email from the blacklist

Mail Relay

Tool	Description
`list_relay_sendings`	List mail relay sendings
`get_relay_sending`	Get details of a specific mail relay sending
`list_relay_reactions`	List mail relay reactions (opens, clicks)
`list_relay_bounces`	List mail relay bounces
`list_relay_complaints`	List mail relay complaints

Raw Mail

Tool	Description
`send_raw_mail`	Send a complete RFC 5322 email (Base64-encoded)

Error Logs

Tool	Description
`list_error_logs`	List error log entries
`get_error_log`	Get a single error log entry by ID
`mark_error_log_read`	Mark an error log entry as read

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

Variable	Required	Description
`INXMAIL_INSTANCE`	Yes	Instance subdomain (e.g. `your-instance`)
`INXMAIL_API_KEY_ID`	Yes	API Key ID
`INXMAIL_API_SECRET`	Yes	API Secret

License

MIT

Inxmail

Añadir este servidor

Host a copy with our keys and logs.

Server facts

Tools

Questions