featurebase-mcp

MCP server for the FeatureBase REST API. Gives any MCP-compatible AI client (Claude Code, Claude Desktop, Cursor, Windsurf, Cline, etc.) full access to your FeatureBase workspace — feedback posts, changelogs, conversations, help center, users, and more.

Tools (44 total)

| Category | Tools | Operations | |----------|-------|------------| | Posts | 4 | list, create, update, delete | | Upvoters | 2 | list, add | | Comments | 4 | list, create, update, delete | | Changelogs | 4 | list, create, update, delete | | Changelog Publishing | 2 | publish, unpublish | | Changelog Subscribers | 3 | list, add, remove | | Users | 4 | get, list, upsert, delete | | Custom Fields | 2 | list, get | | Conversations | 6 | list, get, create, update, delete, reply | | Help Center | 11 | help centers (list, get), collections (CRUD), articles (CRUD) | | Utility | 2 | resolve post slug, find similar posts |

Prerequisites

• Node.js >= 18
• A FeatureBase account
• A FeatureBase API key (Settings > API in your FeatureBase dashboard)

Setup

Option A: npx (no clone needed)

npx @gkpacker/featurebase-mcp --api-key your_api_key_here

Option B: Clone and build

git clone https://github.com/gkpacker/featurebase-mcp.git
cd featurebase-mcp
npm install
npm run build

Get your API key

Go to your FeatureBase dashboard → Settings → API → copy your API key.

Configure your MCP client

Claude Code

claude mcp add featurebase-mcp \
  -e FEATUREBASE_API_KEY=your_api_key_here \
  -- npx -y @gkpacker/featurebase-mcp

To also enable slug resolution and similar posts (requires your org URL):

claude mcp add featurebase-mcp \
  -e FEATUREBASE_API_KEY=your_api_key_here \
  -e FEATUREBASE_ORG_URL=https://yourorg.featurebase.app \
  -- npx -y @gkpacker/featurebase-mcp

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "featurebase": {
      "command": "npx",
      "args": ["-y", "@gkpacker/featurebase-mcp"],
      "env": {
        "FEATUREBASE_API_KEY": "your_api_key_here",
        "FEATUREBASE_ORG_URL": "https://yourorg.featurebase.app"
      }
    }
  }
}

Cursor / Windsurf / Other MCP clients

Follow your client's MCP server configuration docs. The server runs on stdio transport. The command is:

npx -y @gkpacker/featurebase-mcp

Environment variables:

| Variable | Required | Description | |----------|----------|-------------| | FEATUREBASE_API_KEY | Yes | Your FeatureBase API key | | FEATUREBASE_BASE_URL | No | API base URL (default: https://do.featurebase.app/v2) | | FEATUREBASE_ORG_URL | No | Your org URL (e.g. https://yourorg.featurebase.app). Required for resolve_post_slug and find_similar_posts. |

You can also pass these as CLI arguments: --api-key, --base-url, --org-url.

Usage examples

Once configured, you can ask your AI client things like:

• "List my top 10 most upvoted feature requests"
• "Create a changelog entry for the v2.1 release"
• "Reply to the latest conversation in Portuguese"
• "List all help center articles"
• "Create a new help center article about getting started"
• "Find posts similar to 'dark mode'"
• "Show me all users who upvoted post X"
• "Update the status of post X to 'In Progress'"

Field selection

List tools support a select parameter that filters response fields using json-mask syntax. This reduces token usage when you only need specific fields:

select: "id,title,upvotes,postStatus(name)"

Development

# Run in development mode (no build step)
npm run dev

# Build
npm run build

# Run the built server
npm start

License

MIT