MCP Server

The repo ships an MCP server under mcp/ — a Node/TypeScript server that speaks the Model Context Protocol over stdio. It exposes the useSend REST API as a set of tools so an AI agent can send transactional email, manage sending domains, maintain contact books, run campaigns, and read analytics against the EverJust instance at https://mail.everjust.app.

It is a thin wrapper over the REST API: every tool maps to one endpoint, authenticates with a us_ Bearer key, and returns the raw JSON envelope. Anything the API can do, the agent can do.

Build and run

The server has no runtime config file — it reads two environment variables and talks stdio. Build it once, then point your MCP client at the compiled entrypoint.

cd mcp
npm install
npm run build

node dist/index.js

Client configuration

Register the server with your MCP client by pointing command/args at the built entrypoint and passing credentials via env. Use an absolute path to dist/index.js — the client sets no working directory.

{
  "mcpServers": {
    "usesend": {
      "command": "node",
      "args": ["/abs/path/usesend-email/mcp/dist/index.js"],
      "env": {
        "USESEND_API_KEY": "us_...",
        "USESEND_BASE_URL": "https://mail.everjust.app/api/v1"
      }
    }
  }
}

{
  "mcpServers": {
    "usesend": {
      "command": "node",
      "args": ["/abs/path/usesend-email/mcp/dist/index.js"],
      "env": {
        "USESEND_API_KEY": "us_...",
        "USESEND_BASE_URL": "https://mail.everjust.app/api/v1"
      }
    }
  }
}

Replace /abs/path/usesend-email with the real checkout location and us_... with the key for that product's Team. Restart the client after editing so it re-spawns the server.

Tools

Every tool corresponds to one REST endpoint. Fields, enums, and response shapes match the API reference exactly — the server neither adds nor renames fields.

Emails

Domains

Domain path IDs are numbers.

Contact books and contacts

Campaigns

Campaigns are the "Broadcasts" feature — bulk sends to a contact book.

Analytics

Example agent prompt

With the server registered, an agent can act in natural language and the tools resolve to API calls:

Send a receipt to success@simulator.amazonses.com from EverJust <hello@send.everjust.app> with subject "Your receipt" and an HTML body listing one line item, $19.00. Then show me its delivery status.

The agent calls send_email, then get_email with the returned emailId to read the emailEvents history. Because SES is in sandbox, use a verified address or the simulator (as above) as the recipient until production access is granted.

Next steps