convez.ai
MCP ServerIntegração & APIsIntermediário
shahabazdev

Inxmail Commerce MCP Server

shahabazdev/inxmail-mcp

Integre email transacional Inxmail ao Claude com eventos, bounces e tracking

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que integra a API transacional do Inxmail Commerce ao Claude, permitindo gerenciar eventos de email, entregas, bounces, listas de bloqueio e rastreamento de reações. Acesse dados de transactionais, sendings, delivery tracking e status de bloqueio diretamente via Claude.

Instalação

$npx convez-ai shahabazdev/inxmail-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
4
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 7 meses
Versão
—
Issues abertas
1
Contribuidores
1

Casos de uso

  • Monitorar status de entrega e bounces de emails transacionais
  • Gerenciar listas de bloqueio e verificar emails bloqueados
  • Rastrear reações (aberturas, cliques) e métricas de entrega
  • Disparar eventos transacionais e verificar seu estado

Veredito

Integração sólida e bem documentada para plataformas Inxmail Commerce. Ideal para times que precisam automatizar monitoramento de emails transacionais via Claude, com bom conjunto de ferramentas cobrindo eventos, delivery tracking e gestão de bloqueios.

README

A tradução para o português deste README ainda está na fila.

inxmail-mcp

CI npm version npm downloads License: MIT MCP Node.js Glama Awesome MCP Servers

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

ToolDescription
check_email_deliveryCheck delivery status for an email — sendings, bounces, reactions, and block status
check_email_blockedCheck if an email is blocked (blocklist hard bounces + blacklist explicit blocks)
get_server_infoGet API entry point with links to all available resources

Events

ToolDescription
trigger_eventTrigger a transactional email event
get_event_stateGet the state/result of a triggered event by transaction ID
list_event_typesList all configured event types
get_event_typeGet a single event type by ID

Sendings

ToolDescription
list_sendingsList sent transaction emails with filters
get_sendingGet details of a specific sending by ID

Reactions & Tracking

ToolDescription
list_reactionsList recipient reactions (opens and clicks)
list_deliveriesList delivery status information

Bounces & Complaints

ToolDescription
list_bouncesList bounced transaction emails
list_complaintsList feedback loop complaints

Blocklist (Hard Bounces)

ToolDescription
list_blocklistList hard-bounce blocked email addresses
get_blocklist_entryCheck if a specific email is on the blocklist
remove_from_blocklistRemove an email from the blocklist

Blacklist (Explicit Blocks)

ToolDescription
list_blacklistList explicitly blacklisted email addresses
get_blacklist_entryCheck if a specific email is on the blacklist
add_to_blacklistAdd an email address to the blacklist
remove_from_blacklistRemove an email from the blacklist

Mail Relay

ToolDescription
list_relay_sendingsList mail relay sendings
get_relay_sendingGet details of a specific mail relay sending
list_relay_reactionsList mail relay reactions (opens, clicks)
list_relay_bouncesList mail relay bounces
list_relay_complaintsList mail relay complaints

Raw Mail

ToolDescription
send_raw_mailSend a complete RFC 5322 email (Base64-encoded)

Error Logs

ToolDescription
list_error_logsList error log entries
get_error_logGet a single error log entry by ID
mark_error_log_readMark 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 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

VariableRequiredDescription
INXMAIL_INSTANCEYesInstance subdomain (e.g. your-instance)
INXMAIL_API_KEY_IDYesAPI Key ID
INXMAIL_API_SECRETYesAPI Secret

License

MIT

Ver o original no GitHub

Bom para

Relacionados