Agents

Ship production-ready notifications with your AI coding agent

Install the Courier skill in the tool you already use. It builds templates with fallback routing, journeys, preferences, and an in-app inbox in your codebase, following Courier's own patterns for every channel. Add the hosted MCP server to test against your account.

What’s included

Four pieces, all free

The skill does the building. The MCP server, the CLI, and the machine-readable docs are there when the agent needs to test, run, or look something up.

Courier Skills

A router plus about 40 guides covering seven channels, transactional and growth patterns, routing, reliability, and Inbox. Your agent reads the router first and loads only the one or two guides a task needs.

npx skills add trycourier/courier-skills
Skills docs

Hosted MCP server

144 tools covering the full Courier API, for testing and prototyping: create a template in your test workspace, send yourself a test, read the delivery events. Authenticates with your API key as a header; nothing runs locally.

https://mcp.courier.com
MCP docs

Courier CLI

The full Courier API from the terminal your agent already runs commands in: send messages, manage users, inspect delivery logs.

npm install -g @trycourier/cli
CLI docs

Docs for agents

Machine-readable indexes of the documentation. Point your agent at llms.txt for the map, llms-full.txt for everything in one file, or add .md to any docs URL for that page as Markdown.

https://www.courier.com/docs/llms.txt
AI onboarding guide

For agents

If you are an agent reading this

Do these in order. Everything you need is linked or pasteable.

# Courier for agents

1. Read https://www.courier.com/docs/llms.txt for the documentation index.
2. Install the skill: npx skills add trycourier/courier-skills
   Then open SKILL.md; its routing table maps each task to the one or two guides to load.
3. Build against the Courier SDKs and API. Use the test-environment API key.
4. To test what you built: connect to https://mcp.courier.com over MCP with
   header api_key: <test key>. 144 tools. Send a test, then read the delivery events.
5. New workspace, nothing set up yet: https://www.courier.com/docs/tools/agent-quickstart

FAQ

Frequently asked questions

Which AI coding tools does Courier support?

Any tool that reads a skills directory or a SKILL.md can use the Courier skill, and any MCP client can connect to the hosted server. Courier documents the install for Claude Code, Cursor, Codex, VS Code, Windsurf, Antigravity, Gemini CLI, Grok Build, OpenCode, Zed, Warp, and Devin.

What does the Courier skill add?

A routing file plus about 40 reference guides covering seven channels, transactional and growth patterns, routing, reliability, and Inbox. Your agent reads the router first and loads only the one or two guides a task needs. Install it with npx skills add trycourier/courier-skills.

Do I need the MCP server?

Not to build. The skill is enough for your agent to write templates, routing, journeys, and Inbox code in your repo. Add the MCP server when you want to test and prototype against your Courier account from the editor: publish to your test workspace, send yourself a test, read the delivery events.

Is it safe to let an agent work against my Courier account?

Use the test-environment API key. Test and production keys are separate, so templates, journeys, and test sends stay in the test environment and never reach real users. Switch to the production key when you ship.

Can my agent read Courier's documentation directly?

Yes. courier.com/docs/llms.txt is a structured index of every docs page, courier.com/docs/llms-full.txt is the full documentation in one file, and any docs URL with .md appended returns that page as Markdown.