Repository avatar
AI Tools
v0.3.2
active

mcp

com.vaartix/mcp

Send transactional email from India and check delivery, emails and domains in Vaartix.

Documentation

Vaartix MCP server

Let Claude, Cursor and other AI tools send and look up transactional email through Vaartix, the email API built in India.

"Send the login code 482913 to priya@example.com from noreply@notify.acme.in"
"Did the order confirmation to ravi@example.com get delivered?"
"Show me emails that bounced in the last 7 days"

Tools

ToolWhat it doesAPI key
send_emailSend one email (HTML and/or text, cc, bcc, reply-to, tags, scheduled sending, idempotency key)Send-only or full access
send_batchSend up to 20 emails in one callSend-only or full access
get_emailOne email's details and event timeline; the body only with includeContentFull access
list_emailsRecent emails, filtered by status, search text or daysFull access
cancel_emailCancel a scheduled emailFull access
list_domainsYour sending domains, with verification status and DNS recordsFull access
get_domainOne domain: whether it's verified and the DNS records it needsFull access

Sending tools deliver real email. Most MCP clients ask you to approve each tool call, so check the recipients and content before you approve.

Limits on every call: at most 50 recipients per email (to, cc and bcc together), 20 emails per batch, and no attachments or custom headers. Email bodies come back only when asked for (includeContent), marked as data from the email, never instructions.

Setup

You need a Vaartix API key from app.vaartix.com → API keys. Create a key just for your AI tool. When asked "Is this key for an AI agent or MCP server?", choose Yes, an AI agent. An AI agent key starts with safe limits:

  • test addresses only, until you add the recipients it may email
  • 20 emails an hour and 50 a day
  • email bodies are never returned (read content is off)

Change these at any time with Limits on the API keys page. Widening a limit asks for a fresh confirmation code; narrowing it doesn't. Limits are enforced by the Vaartix API itself, so they hold whatever the AI tool asks for.

For sending only, make it a send-only key limited to your domain. Use a full-access key only if you also want the AI tool to read your email logs. Don't reuse your app's production key.

Claude Desktop

Settings → Developer → Edit Config, then add:

{
  "mcpServers": {
    "vaartix": {
      "command": "npx",
      "args": ["-y", "vaartix-mcp"],
      "env": { "VAARTIX_API_KEY": "vx_your_api_key" }
    }
  }
}

Claude Code

claude mcp add vaartix --env VAARTIX_API_KEY=vx_your_api_key -- npx -y vaartix-mcp

Cursor

~/.cursor/mcp.json (or .cursor/mcp.json in a project):

{
  "mcpServers": {
    "vaartix": {
      "command": "npx",
      "args": ["-y", "vaartix-mcp"],
      "env": { "VAARTIX_API_KEY": "vx_your_api_key" }
    }
  }
}

Other clients

Any MCP client that runs stdio servers works: run npx -y vaartix-mcp with VAARTIX_API_KEY set.

It needs Node.js 20 or later.

Configuration

VariableRequiredDefault
VAARTIX_API_KEYYes
VAARTIX_BASE_URLNohttps://api.vaartix.com

Keep the key out of shared or committed config files. Anyone who can read the config can send email as you.

Development

npm install
npm test          # tool tests against a fake API
npm run lint
npm run typecheck
npm run build     # outputs dist/index.js (the vaartix-mcp command)

Using the tool definitions

The tools are defined once in vaartix-mcp/tools (name, input schema, annotations, the permission each needs and the API routes it calls), so other MCP servers can offer exactly the same tools:

import { McpServer } from '@modelcontextprotocol/server';
import { registerTools, TOOLS } from 'vaartix-mcp/tools';

const server = new McpServer({ name: 'vaartix', version: '1.0.0' });
registerTools(server, async (method, path, options) => {
  // Call the Vaartix API and return the parsed JSON.
});

License

MIT. Vaartix is a product of NAP Designs, Bengaluru.

NPM
vaartix-mcp
Install Command
npm install vaartix-mcp

Remote