Skip to main content

MCP Server

The AnnounceKit MCP server lets your AI assistant - Claude, ChatGPT, Cursor and other Model Context Protocol clients - work with your AnnounceKit data straight from a chat: read your changelog, feedback, roadmap and stats, and draft, update or publish posts.

It is read + create/update/publish only. There are no delete or other destructive actions - those stay in the dashboard.

There are two ways to connect:

  • Hosted (recommended) - nothing to install; add one URL to your AI client and sign in.
  • Local (stdio) - run the server on your own machine; for developers.

Option 1 - Hosted (recommended)

Nothing to install. Point your AI client at this URL:

https://mcp.announcekit.app/mcp

When you add it, your client sends you to AnnounceKit to log in and approve the connection - there is no token to copy or paste. You can review or remove the connection any time under Settings → Connected apps.

Claude (claude.ai and Claude Desktop)

  1. Open Settings → Connectors.
  2. Scroll to the bottom and click Add custom connector.
  3. Enter the URL https://mcp.announcekit.app/mcp and add it.
  4. Open the connector, click Connect, then log in to AnnounceKit and approve access.

Other clients

Any MCP-compatible client connects the same way: add https://mcp.announcekit.app/mcp as a custom / remote MCP server, then complete the AnnounceKit login and approval when your client opens it. Where you add it differs per app.

For example, in Cursor add it to your mcp.json:

{
  "mcpServers": {
    "announcekit": {
      "url": "https://mcp.announcekit.app/mcp"
    }
  }
}

In ChatGPT, remote MCP connectors are available through Developer Mode (currently in beta, and may require a Business/Enterprise plan or admin setup) - enable it under Settings, then add the URL above.

Using a client that expects a token instead of the login flow? You can authenticate with an API token by sending it as a Bearer header - Authorization: Bearer ak_pat_…. See Creating an API token below.

Option 2 - Local (stdio)

For developers who prefer to run the server locally. Requires Node.js 22+ and an API token.

Run it directly with npx:

npx announcekit-mcp

The server reads your token from the ANNOUNCEKIT_TOKEN environment variable. Most clients let you register it with a short config - for example, with Claude:

claude mcp add announcekit \
  --env ANNOUNCEKIT_TOKEN=ak_pat_… \
  -- npx announcekit-mcp

Or as a JSON MCP config block:

{
  "mcpServers": {
    "announcekit": {
      "command": "npx",
      "args": ["announcekit-mcp"],
      "env": { "ANNOUNCEKIT_TOKEN": "ak_pat_…" }
    }
  }
}

Creating an API token

You need an API token for local (stdio) use, or for a hosted client that authenticates with a token instead of the login flow.

  1. Go to Settings → API Tokens (owners and managers only).
  2. Create a token and pick a scope:
    • Read - view posts, feedback, stats and roadmap.
    • Write - read, plus create and update content (no deletes).
  3. Copy the token (it starts with ak_pat_) - it is shown only once.

A token acts on behalf of the member who created it and is limited to the projects that member can access, at their role. If that member loses access to a project, the token stops working there.

What your AI can do

Once connected, your assistant can:

  • Posts - list, read, draft, update, and publish or schedule release notes.
  • Feedback & feature requests - read feedback, and create, comment on, or reply to feature requests.
  • Roadmap - read the roadmap and add items or statuses.
  • Insights - read post stats and NPS.

What’s available depends on your scope (read vs. write). Deletes and account or billing actions are intentionally left out - use the dashboard for those.

Troubleshooting

  • The connection stopped working. A token or connection acts on behalf of the member who created it. If that member lost access to a project, create a new token (Settings → API Tokens) or reconnect.
  • Need to re-approve or remove a hosted connection. Go to Settings → Connected apps to disconnect, then reconnect from your client.
  • "Connection limit reached." Each user can connect up to 10 apps. Remove one under Settings → Connected apps and try again.