io.usefulapi/buttondown

up checked 2026-11-11T02:38:43.054Z

Unclaimed · Unverified

Agent searches it appeared in, last 30 days: 0. Run this server? Claim the listing: verified label, uptime alerts and analytics.

Publisher-provided title

Buttondown MCP by usefulapi

Publisher-provided description

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

Summary by lookupd

Reads and manages Buttondown newsletter subscribers, drafts, automations and analytics, and can add subscribers and tags.

Install

Claude Code, remote (streamable-http)

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

Codex, remote (streamable-http)

codex mcp add buttondown --url https://buttondown.usefulapi.io/mcp

Cursor, remote (streamable-http) → .cursor/mcp.json

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

Other clients: docs. Or tell your agent: Set up lookupd for me: read https://lookupd.com/agent.md and follow it.

Tools (25 tools)

Publisher-provided text

• 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 nev
• 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/c
• 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 subscrib
• 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 o
• 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
• 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 /emai
• 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 But
• 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 But
• 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
• 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.

Details

• Version: 1.24.3
• Transports: streamable-http
• Uptime (7 days): 100%
• Median latency: 662 ms
• First indexed: 2026-11-01T10:03:56.633Z
• Last seen in registry: 2026-11-11T00:17:21.326Z
• Repository: https://github.com/m190/usefulapi-mcp
• Website: https://usefulapi.io/buttondown/

Badge for your README

Shows this live status and links here; updates hourly.

[![lookupd status](https://lookupd.com/badge/io.usefulapi/buttondown.svg)](https://lookupd.com/servers/io.usefulapi/buttondown)

• 62071 servers
• Last crawl: 2026-11-11T16:39:06.253Z
• API base: https://api.lookupd.com
• MCP URL: https://api.lookupd.com/mcp