@Alexandrebouchez/Batch

Open-source MCP server for Batch.com — full coverage of the Customer Engagement Platform (CEP v2.x) and Mobile Engagement Platform (MEP v1.1) REST APIs, exposed to LLM agents over stdio and HTTP.

License: AGPL-3.0 MCP

What it does

Lets any MCP-compatible agent (Claude Desktop, Claude Code, Cursor, Continue, the Anthropic API, ChatGPT, etc.) operate a Batch.com account: update profiles, manage audiences, send transactional pushes, orchestrate omnichannel campaigns, request data exports, and more — through a curated set of typed tools.

Every Batch endpoint that ships in their public docs is exposed as a tool. Destructive operations require an explicit confirm: true. Async 202 operations return the indexing token so the agent can poll completion explicitly.

Status

🚧 Pre-release. Setup phase — tools coming online progressively. Track progress in the plan or open issues.

Install (stdio)

npx -y @alexandrebouchez/batch-mcp

Configure your client (Claude Desktop example, ~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "batch": {
      "command": "npx",
      "args": ["-y", "@alexandrebouchez/batch-mcp"],
      "env": {
        "BATCH_REST_KEY": "your_rest_key",
        "BATCH_PROJECT_KEY": "your_project_key",
        "BATCH_IOS_LIVE_KEY": "...",
        "BATCH_ANDROID_LIVE_KEY": "..."
      }
    }
  }
}

See .env.example for the full env var list.

Install (HTTP, self-hosted on Vercel)

Deploy with Vercel

Once deployed, point your MCP client at https://<your-deploy>.vercel.app/api/mcp.

Development

pnpm install
pnpm dev          # starts both packages in watch mode
pnpm test
pnpm typecheck
pnpm lint

Monorepo layout:

packages/server   — @alexandrebouchez/batch-mcp (npm)
apps/web          — Next.js landing + /api/mcp endpoint (Vercel)

License

AGPL-3.0-only. If you run a modified version of this server as a service, you must publish your source under AGPL-3.0. See LICENSE.

This is intentional: it lets the community fork and improve the server freely, while preventing closed-source SaaS providers (including Batch.com itself) from absorbing the code without contributing back.

Disclaimer

This project is not affiliated with, endorsed by, or sponsored by Batch SAS. "Batch" is a trademark of its respective owner. This is an independent open-source integration built against the public Batch.com REST API.