keila-mcp
# keila-mcp
MCP server for the [Keila](https://www.keila.io/) newsletter API. Lets Claude manage contacts, campaigns, segments, and senders.
## Install
```bash
claude mcp add -s user keila \
-e KEILA_API_KEY=$(op read "op://kube/Keila/api_key") \
-e KEILA_URL=https://mail.korroni.com \
-- uvx --from git+https://github.com/gwbischof/keila-mcp keila-mcp
```
## Tools
| Tool | Description |
|------|-------------|
| `list_contacts` | List all contacts with pagination |
| `get_contact` | Fetch a contact by ID |
| `create_contact` | Create a new contact |
| `update_contact` | Update a contact |
| `delete_contact` | Delete a contact |
| `list_campaigns` | List all campaigns |
| `get_campaign` | Fetch a campaign by ID |
| `create_campaign` | Create a new campaign (does not send) |
| `update_campaign` | Update a campaign |
| `delete_campaign` | Delete a campaign |
| `send_campaign` | Send a campaign immediately |
| `schedule_campaign` | Schedule a campaign for future delivery |
| `list_segments` | List all segments |
| `create_segment` | Create a segment with a filter |
| `delete_segment` | Delete a segment |
| `list_senders` | List configured senders |
| `list_forms` | List signup forms |
## Environment Variables
| Variable | Default | Description |
|----------|---------|-------------|
| `KEILA_URL` | `https://mail.korroni.com` | Keila instance URL |
| `KEILA_API_KEY` | | API key (create in Keila dashboard) |
TDQS
Scored across 17 tools
Every tool has a clearly distinct purpose with no ambiguity. Tools are organized by resource type (campaign, contact, segment, sender, form) and action (create, get, list, update, delete, schedule, send), making it easy for an agent to select the correct one. Overlap is minimal, such as create_campaign and send_campaign being clearly separated in workflow.
Tool names follow a highly consistent verb_noun pattern throughout, with verbs like create, get, list, update, delete, schedule, and send paired with nouns like campaign, contact, segment, sender, and form. There are no deviations in style or convention, making the set predictable and readable.
With 17 tools, the count is well-scoped for an email marketing platform, covering core CRUD operations for campaigns, contacts, and segments, plus essential utilities like listing senders and forms, and campaign-specific actions like scheduling and sending. Each tool earns its place without bloat or redundancy.
The tool surface provides complete CRUD/lifecycle coverage for the domain of email marketing. It includes create, get, list, update, and delete for campaigns, contacts, and segments, plus specialized actions like schedule_campaign and send_campaign, and supporting tools like list_senders and list_forms. There are no obvious gaps that would hinder agent workflows.