Build with AI - Courier

Whether your agent calls tools, runs shell commands, or just needs context, you’ve got options:

MCP Server: structured tool calls inside an agent session.
Courier CLI: shell access for scripting and CI/CD.
Courier Skills: best-practice packs that guide your assistant.
Docs for Agents: machine-readable indexes agents can fetch.

Every method needs a Courier API key. Create one in your Courier dashboard, then replace YOUR_API_KEY in the examples below.

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.

Claude Code
Cursor
Codex
VS Code
Windsurf

claude mcp add --transport http courier https://mcp.courier.com --header api_key:YOUR_API_KEY

Run /mcp to confirm courier is connected.

Or add it manually:

mcp.json

{
  "mcpServers": {
    "courier": {
      "url": "https://mcp.courier.com",
      "headers": {
        "api_key": "YOUR_API_KEY"
      }
    }
  }
}

~/.codex/config.toml

[mcp_servers.courier]
url = "https://mcp.courier.com"
http_headers = { api_key = "YOUR_API_KEY" }

Restart Codex, then run /mcp to confirm courier is connected.

.vscode/mcp.json

{
  "servers": {
    "courier": {
      "type": "http",
      "url": "https://mcp.courier.com",
      "headers": {
        "api_key": "YOUR_API_KEY"
      }
    }
  }
}

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "courier": {
      "serverUrl": "https://mcp.courier.com",
      "headers": {
        "api_key": "YOUR_API_KEY"
      }
    }
  }
}

See MCP Server for setup on more clients like Claude Desktop and the OpenAI API, plus the complete tool list.

Courier CLI

The CLI gives agents (and you) direct shell access to all Courier API endpoints. Install once, set your API key, and any agent that can run shell commands can send notifications, 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"

Now your agent can run Courier commands. Send a notification:

courier send message \
  --message.to.user_id "user-123" \
  --message.template "order-confirmation" \
  --message.data '{"orderId": "ORD-456"}'

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

Every command supports --format json for machine-readable output.

Courier Skills

Agent skill packs that teach your AI coding assistant Courier notification best practices. Covers channel selection, compliance, reliability patterns, and more.

Claude Code
Cursor (global)
Cursor (project)

git clone https://github.com/trycourier/courier-skills.git ~/.claude/skills/courier-skills

git clone https://github.com/trycourier/courier-skills.git ~/.cursor/skills/courier-skills

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:

URL	Description
`llms.txt`	Structured index of all documentation pages
`llms-full.txt`	Full 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.

What’s Next

MCP Server

Setup for all supported editors and the complete tool list.

CLI Reference

Full command list, output formats, and global flags.

Agent Skills

Coverage details and how the skill routing works.

API Reference

Full REST API documentation.

Whether your agent calls tools, runs shell commands, or just needs context, you’ve got options:

MCP Server: structured tool calls inside an agent session.
Courier CLI: shell access for scripting and CI/CD.
Courier Skills: best-practice packs that guide your assistant.
Docs for Agents: machine-readable indexes agents can fetch.

Every method needs a Courier API key. Create one in your Courier dashboard, then replace YOUR_API_KEY in the examples below.

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.

Claude Code
Cursor
Codex
VS Code
Windsurf

claude mcp add --transport http courier https://mcp.courier.com --header api_key:YOUR_API_KEY

Run /mcp to confirm courier is connected.

Or add it manually:

mcp.json

{
  "mcpServers": {
    "courier": {
      "url": "https://mcp.courier.com",
      "headers": {
        "api_key": "YOUR_API_KEY"
      }
    }
  }
}

~/.codex/config.toml

[mcp_servers.courier]
url = "https://mcp.courier.com"
http_headers = { api_key = "YOUR_API_KEY" }

Restart Codex, then run /mcp to confirm courier is connected.

.vscode/mcp.json

{
  "servers": {
    "courier": {
      "type": "http",
      "url": "https://mcp.courier.com",
      "headers": {
        "api_key": "YOUR_API_KEY"
      }
    }
  }
}

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "courier": {
      "serverUrl": "https://mcp.courier.com",
      "headers": {
        "api_key": "YOUR_API_KEY"
      }
    }
  }
}

See MCP Server for setup on more clients like Claude Desktop and the OpenAI API, plus the complete tool list. The CLI gives agents (and you) direct shell access to all Courier API endpoints. Install once, set your API key, and any agent that can run shell commands can send notifications, 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"

Now your agent can run Courier commands. Send a notification: 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

Claude Code
Cursor (global)
Cursor (project)
Other assistants

git clone https://github.com/trycourier/courier-skills.git ~/.claude/skills/courier-skills

git clone https://github.com/trycourier/courier-skills.git ~/.cursor/skills/courier-skills

git clone https://github.com/trycourier/courier-skills.git .cursor/skills/courier-skills

Clone the repo into the skills directory your assistant uses, or point it at the SKILL.md file manually. The skill is standard Markdown and works with any tool that supports agent skills.

git clone https://github.com/trycourier/courier-skills.git

MCP Server

Setup for all supported editors and the complete tool list.

CLI Reference

Full command list, output formats, and global flags.

Agent Skills

Coverage details and how the skill routing works.

API Reference

Full REST API documentation.

Claude Code
Cursor (global)
Cursor (project)

git clone https://github.com/trycourier/courier-skills.git ~/.claude/skills/courier-skills

git clone https://github.com/trycourier/courier-skills.git ~/.cursor/skills/courier-skills

git clone https://github.com/trycourier/courier-skills.git .cursor/skills/courier-skills

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:

URL	Description
`llms.txt`	Structured index of all documentation pages
`llms-full.txt`	Full documentation content in a single file

What’s Next

MCP Server

Setup for all supported editors and the complete tool list.

CLI Reference

Full command list, output formats, and global flags.

Agent Skills

Coverage details and how the skill routing works.

API Reference

Full REST API documentation.

Whether your agent calls tools, runs shell commands, or just needs context, you’ve got options:

MCP Server: structured tool calls inside an agent session.
Courier CLI: shell access for scripting and CI/CD.
Courier Skills: best-practice packs that guide your assistant.
Docs for Agents: machine-readable indexes agents can fetch.

Every method needs a Courier API key. Create one in your Courier dashboard, then replace YOUR_API_KEY in the examples below.

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.

Claude Code
Cursor
Codex
VS Code
Windsurf

claude mcp add --transport http courier https://mcp.courier.com --header api_key:YOUR_API_KEY

Run /mcp to confirm courier is connected.

Or add it manually:

mcp.json

{
  "mcpServers": {
    "courier": {
      "url": "https://mcp.courier.com",
      "headers": {
        "api_key": "YOUR_API_KEY"
      }
    }
  }
}

~/.codex/config.toml

[mcp_servers.courier]
url = "https://mcp.courier.com"
http_headers = { api_key = "YOUR_API_KEY" }

Restart Codex, then run /mcp to confirm courier is connected.

.vscode/mcp.json

{
  "servers": {
    "courier": {
      "type": "http",
      "url": "https://mcp.courier.com",
      "headers": {
        "api_key": "YOUR_API_KEY"
      }
    }
  }
}

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "courier": {
      "serverUrl": "https://mcp.courier.com",
      "headers": {
        "api_key": "YOUR_API_KEY"
      }
    }
  }
}

npm install -g @trycourier/cli
export COURIER_API_KEY="YOUR_API_KEY"

Now your agent can run Courier commands. Send a notification: 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

​MCP Server

​Courier CLI

​Courier Skills

​Docs for Agents

​What’s Next

MCP Server

CLI Reference

Agent Skills

API Reference

​MCP Server

MCP Server

CLI Reference

Agent Skills

API Reference

​Docs for Agents

​What’s Next

MCP Server

CLI Reference

Agent Skills

API Reference

​MCP Server

MCP Server

Courier CLI

Courier Skills

Docs for Agents

What’s Next

MCP Server

Docs for Agents

What’s Next

MCP Server