Skip to main content
Courier provides multiple integration points for AI coding harnesses (e.g. Claude Code, Cursor) and agents. Choose what fits your workflow, or combine them.

If you’ve already set things up or are an Agent, jump straight to our Quickstart for Agents.

​
Courier CLI

The CLI gives agents (and you) direct shell access to all 81 Courier API endpoints. Install once, set your API key, and any agent that can run shell commands can send messages, inspect delivery logs, and manage users. See the CLI reference for the full command list. 
npm install -g @trycourier/cli
export COURIER_API_KEY="your-api-key"

courier send message \
  --message.to.user_id "user-123" \
  --message.template "order-confirmation" \
  --message.data '{"orderId": "ORD-456"}'
Every command supports --format json for machine-readable output.

​
MCP Server

The MCP server provides structured tool access for AI agents. Agents discover available tools automatically and call them with typed parameters; no shell commands needed.
Install MCP ServerOr add manually to your mcp.json:
{
  "mcpServers": {
    "courier": {
      "url": "https://mcp.courier.com",
      "headers": {
        "api_key": "XXXX"
      }
    }
  }
}
See MCP Server for setup on Claude Desktop, Windsurf, VSCode, and OpenAI API, plus the complete tool list.

​
Courier Skills

Agent skill packs that teach your AI coding assistant Courier notification best practices. Covers channel selection, compliance, reliability patterns, and more. 
git clone https://github.com/trycourier/courier-skills.git ~/.cursor/skills/courier-skills
Once installed, your agent automatically gets routing guidance, compliance rules, and code patterns for all 7 channels and 28 notification types. See Courier Skills for coverage details and how the routing works.

​
Docs for Agents

Courier’s documentation is available as machine-readable indexes that AI agents can fetch to discover all available pages, API endpoints, and guides:
URLDescription
llms.txtStructured index of all documentation pages
llms-full.txtFull documentation content in a single file
These follow the llms.txt standard and are generated automatically from these docs. Agents that support llms.txt can discover Courier’s CLI, MCP server, SDKs, and API reference without any configuration.

​
Quick Starts

Common tasks you can hand to an agent with the CLI or MCP server installed: Send a test message: 
courier send message \
  --message.to.email "test@example.com" \
  --message.content.title "Hello" \
  --message.content.body "Test from CLI"
Debug a failed delivery: 
courier messages list --format json --transform "results.#(status=UNDELIVERABLE)"
courier messages history --message-id "MSG_ID" --format json
Check a user’s profile: 
courier profiles retrieve --user-id "user-123" --format json

​
What’s Next

CLI Reference

Full command list, output formats, and global flags.

MCP Server

Setup for all supported editors and the complete tool list.

Agent Skills

Coverage details and how the skill routing works.

API Reference

REST API documentation for all 81 endpoints.