MCP server
Buttondown MCP by usefulapi
Read Buttondown subscribers, emails, analytics and automations; add subscribers; write…
- Runs
- Remotely
- Version
- 1.27.0
- Listing updated
- 4 days ago
About Buttondown MCP by usefulapi
Buttondown MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.
Read Buttondown subscribers, emails, analytics and automations; add subscribers; write email drafts.
Install
Run in a terminal
claude mcp add --transport http buttondown https://buttondown.usefulapi.io/mcpAdd to Settings → Connectors → Add custom connector
https://buttondown.usefulapi.io/mcpInstall in CursorOpens Cursor, which asks you to confirm. Or add it by hand:
Add to ~/.cursor/mcp.json
{
"mcpServers": {
"buttondown": {
"url": "https://buttondown.usefulapi.io/mcp"
}
}
}Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:
Add to .vscode/mcp.json
{
"servers": {
"buttondown": {
"type": "http",
"url": "https://buttondown.usefulapi.io/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"buttondown": {
"serverUrl": "https://buttondown.usefulapi.io/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"buttondown": {
"type": "http",
"url": "https://buttondown.usefulapi.io/mcp"
}
}
}Tools this server provides (25)
Read directly from the server.
- buttondown_get_account
- The Buttondown account this API key belongs to: username and e-mail address. GET /accounts/me.
- buttondown_list_newsletters
- List the newsletters on the account with name, username, domains, sender, locale and timezone. The newsletter's API key, custom CSS and e-mail templates are never returned. GET /newsletters.
- buttondown_get_newsletter
- One newsletter by id (settings and identity only; no API key, CSS or templates). GET /newsletters/{id}.
- buttondown_list_subscribers
- List or search subscribers (newest first by default) with e-mail, type (regular, unactivated, unsubscribed, premium, ...), tags, notes, metadata, source, open/click rates and dates. Filter by e-mail text, type, tag, signup date or domain. GET /subscribers.
- buttondown_get_subscriber
- One subscriber by id or by e-mail address: type, tags, notes, metadata, source, engagement and lifecycle dates. GET /subscribers/{id_or_email}.
- buttondown_add_subscriber
- WRITE: add ONE subscriber by e-mail address. No subscriber type is set, so Buttondown applies the newsletter's normal sign-up rules (double opt-in: the subscriber is typically created as unactivated and Buttondown e-mails THAT ONE address a confirmation message; opt-in is never bypassed, nor is the firewall). Only add people who asked to subscribe. Creating a subscriber (and its tags) can also sta
- buttondown_update_subscriber
- WRITE: change ONE subscriber's tags, private note or metadata. Tags are merged (add_tags / remove_tags change only those names; the others stay). A given note or metadata replaces the existing value (destructive for that field). The subscriber's type (unsubscribe, block, ...) and e-mail address cannot be changed here, and this tool sends nothing itself; but a tag, note or metadata change can start
- buttondown_list_emails
- List emails (drafts, scheduled and sent), newest first by default, with subject, status, publish date, slug, archive URL and analytics summary. The body is left out unless include_body is set. Filter by status, subject text or date. GET /emails.
- buttondown_get_email
- One email by id with its full body, subject, status, publish date, slug, archive settings and analytics summary. GET /emails/{id}.
- buttondown_get_email_analytics
- Delivery and engagement numbers for one sent email: recipients, deliveries, opens, clicks, failures, unsubscriptions, complaints, replies, page views. GET /emails/{id}/analytics.
- buttondown_create_email_draft
- WRITE: create a DRAFT email (status always "draft"). Nothing is sent or scheduled and no subscriber is e-mailed; to send it, the user must open the draft in Buttondown and send it there. This server has no tool that sends or schedules email. Body is Markdown or HTML. POST /emails.
- buttondown_update_email_draft
- WRITE: edit the subject, body, description, slug or preview image of an email that is still a DRAFT (replaces those fields; the previous text is lost unless Buttondown's email history is used). Refuses any email that is not a draft, and never changes status or publish date, so nothing is sent or scheduled. PATCH /emails/{id}.
- buttondown_list_tags
- List subscriber tags with name, color, descriptions and whether subscribers can edit them. GET /tags.
- buttondown_get_tag_analytics
- Subscribers created, open rate and click rate for one tag. GET /tags/{id}/analytics.
- buttondown_create_tag
- WRITE: create a subscriber tag (needs a Buttondown plan with tags). An existing tag with the same name is returned as an error and not changed. POST /tags.
- buttondown_list_automations
- List automations (welcome sequences and other triggered e-mails) with name, status, trigger, actions and filters (webhook URLs in actions are shown by host only). Read-only: automations are not started or changed. GET /automations.
- buttondown_get_automation
- One automation by id with its trigger, actions and filters. GET /automations/{id}.
- buttondown_get_automation_analytics
- Performance numbers for one automation. GET /automations/{id}/analytics.
- buttondown_list_surveys
- List surveys with question, answers, status and response count. GET /surveys.
- buttondown_list_survey_responses
- List survey responses (who answered what), optionally for one survey, email or subscriber. GET /survey_responses.
- buttondown_list_segments
- List saved subscriber segments with name, description and filters. GET /segments.
- buttondown_list_forms
- List sign-up forms with title, slug, status, tags and subscriber counts. GET /forms.
- buttondown_list_snippets
- List reusable content snippets with identifier, name, mode and how often each is referenced. GET /snippets.
- buttondown_list_webhooks
- List configured webhooks with status and subscribed event types. The signing key is never returned and the URL is shown by host only. GET /webhooks.
- buttondown_list_events
- List delivery events (delivered, opened, clicked, bounced, unsubscribed, ...), newest first, optionally for one email or subscriber. GET /events.
Buttondown MCP by usefulapi FAQ
How do I add Buttondown MCP by usefulapi to Claude Code?
Run this command in your terminal: claude mcp add --transport http buttondown https://buttondown.usefulapi.io/mcp