MCP server

Buttondown MCP by usefulapi

io.usefulapi/buttondown

Checked 25 Oct 2026, 20:29 UTC · Connected to it and listed its tools

Read Buttondown subscribers, emails, analytics and automations; add subscribers; write email drafts.

Website Source

At a glance

Type

MCP server

Publisher

usefulapi.io (verified by the MCP Registry)

Status

Working at last check

Tools

25

Token cost

About 5,504 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

25 Oct 2026, 20:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

claude mcp add --transport http buttondown https://buttondown.usefulapi.io/mcp

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.buttondown]
url = "https://buttondown.usefulapi.io/mcp"

Gemini CLI

{"mcpServers":{"buttondown":{"httpUrl":"https://buttondown.usefulapi.io/mcp"}}}

Cursor

{"mcpServers":{"buttondown":{"url":"https://buttondown.usefulapi.io/mcp"}}}

VS Code

{"servers":{"buttondown":{"type":"http","url":"https://buttondown.usefulapi.io/mcp"}}}

Antigravity

agy mcp add buttondown https://buttondown.usefulapi.io/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"buttondown","server_url":"https://buttondown.usefulapi.io/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"buttondown","server_url":"https://buttondown.usefulapi.io/mcp"}

Tools

• buttondown_add_subscriber ~500 tokens
  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
• buttondown_create_email_draft ~298 tokens
  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_create_tag ~258 tokens
  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_get_account ~72 tokens
  The Buttondown account this API key belongs to: username and e-mail address. GET /accounts/me.
• buttondown_get_automation ~125 tokens
  One automation by id with its trigger, actions and filters. GET /automations/{id}.
• buttondown_get_automation_analytics ~125 tokens
  Performance numbers for one automation. GET /automations/{id}/analytics.
• buttondown_get_email ~134 tokens
  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 ~151 tokens
  Delivery and engagement numbers for one sent email: recipients, deliveries, opens, clicks, failures, unsubscriptions, complaints, replies, page views. GET /emails/{id}/analytics.
• buttondown_get_newsletter ~131 tokens
  One newsletter by id (settings and identity only; no API key, CSS or templates). GET /newsletters/{id}.
• buttondown_get_subscriber ~128 tokens
  One subscriber by id or by e-mail address: type, tags, notes, metadata, source, engagement and lifecycle dates. GET /subscribers/{id_or_email}.
• buttondown_get_tag_analytics ~108 tokens
  Subscribers created, open rate and click rate for one tag. GET /tags/{id}/analytics.
• buttondown_list_automations ~155 tokens
  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_list_emails ~557 tokens
  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_list_events ~277 tokens
  List delivery events (delivered, opened, clicked, bounced, unsubscribed, ...), newest first, optionally for one email or subscriber. GET /events.
• buttondown_list_forms ~111 tokens
  List sign-up forms with title, slug, status, tags and subscriber counts. GET /forms.
• buttondown_list_newsletters ~143 tokens
  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_list_segments ~111 tokens
  List saved subscriber segments with name, description and filters. GET /segments.
• buttondown_list_snippets ~119 tokens
  List reusable content snippets with identifier, name, mode and how often each is referenced. GET /snippets.
• buttondown_list_subscribers ~614 tokens
  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_list_survey_responses ~288 tokens
  List survey responses (who answered what), optionally for one survey, email or subscriber. GET /survey_responses.
• buttondown_list_surveys ~139 tokens
  List surveys with question, answers, status and response count. GET /surveys.
• buttondown_list_tags ~116 tokens
  List subscriber tags with name, color, descriptions and whether subscribers can edit them. GET /tags.
• buttondown_list_webhooks ~130 tokens
  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_update_email_draft ~302 tokens
  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 sch
• buttondown_update_subscriber ~412 tokens
  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 cann

Browse

• Converting to Markdown
• Email
• Forms and surveys
• Email marketing

Related MCP servers

• MailerLite MCP by usefulapi
  Read subscribers, groups, campaigns, fields, segments, automations, webhooks; safe additive writes.
• ReferralHero MCP by usefulapi
  Read ReferralHero campaigns, subscribers, referrals and rewards; add subscribers and points.
• Mailrith Email Marketing
  Manage Subscribers, Broadcasts, Sequences, Automations, and reporting in Mailrith.
• Mailchimp MCP by usefulapi
  Read audiences, members, campaigns and reports; add, update, tag and archive subscribers.
• Enginemailer MCP by usefulapi
  Read Enginemailer subscribers, lists and campaigns; add subscribers, create and send campaigns.
• Mail Blaze MCP by usefulapi
  Manage Mail Blaze lists, subscribers, templates, campaigns and reports; send transactional email.
• Moosend MCP by usefulapi
  Inspect Moosend lists, subscribers, segments and campaign stats, and add or unsubscribe subscribers.
• Trumpia MCP by usefulapi
  Read Trumpia lists, subscribers, keywords and reports; add contacts and send SMS or email campaigns.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.usefulapi/buttondown.svg)](https://aptlynx.net/servers/io.usefulapi/buttondown)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents