Connect Claude

Install the Buzzabout MCP server in Claude Desktop or Claude on the web with OAuth.

Add the Buzzabout MCP server to Claude. Once it's wired up you can ask Claude things like "Find the top-engaging posts on Reddit mentioning cold brew this week and summarise their hooks" and it will call our tools, stream a markdown response back, and link the source posts.

Prerequisites

A Buzzabout account.
Claude Desktop (download) or a Claude.ai workspace with custom integrations enabled (Team / Enterprise plans).

Add the server

Open the integration settings

Desktop: Settings → Developer → Edit Config. Claude opens claude_desktop_config.json in your editor.
Web (claude.ai): Settings → Integrations → Add custom.

Paste the Buzzabout block

Claude Desktop supports remote MCP servers natively. Point it at the streamable HTTP transport — Claude will run the OAuth flow on first connection.

claude_desktop_config.json

{
  "mcpServers": {
    "buzzabout": {
      "transport": "streamable-http",
      "url": "https://api.buzzabout.ai/mcp/"
    }
  }
}

Field	Value
Name	`buzzabout`
URL	`https://api.buzzabout.ai/mcp/`
Auth	OAuth (Claude handles the redirect)

Authorise

The first time Claude calls a tool, it'll open a browser window to api.buzzabout.ai/mcp/oauth/authorize. Sign in with your Buzzabout account; Claude exchanges the redirect code for a JWT and stores it locally. You won't see this prompt again until the token expires.

Verify

Open a new conversation and ask:

"Which Buzzabout tools do you have available?"

Claude should list the eleven buzzabout__* tools. If it doesn't, see Troubleshooting.

A first prompt

Once the server is wired up, try this:

"Create a new dataset called 'cold brew' and kick off a Reddit run for the search query 'cold brew' over the last week. When it's done, list the top 5 mentions sorted by engagement and summarise the hooks they use."

Claude will:

Call buzzabout__create_dataset.
Call buzzabout__create_dataset_run with the prompt search query.
Poll buzzabout__get_dataset_run until completion.
Call buzzabout__list_mentions with dataset_ids: [new id], sort: engagement_rate, limit: 5.
Stream a markdown summary back to you with citations.

Each tool call is visible in Claude's UI — click to inspect what was sent and what came back.

When to use OAuth vs API key

Use OAuth	Use API key
Interactive Claude Desktop / web user.	Headless agent, custom integration.
Need `buzzabout__ask` (chat tool).	Only need the thin REST-mirror tools.
You want per-user audit trail.	One service-account-style identity.

buzzabout__ask impersonates the authenticated user against the AI assistant chat backend, so it only works with OAuth. API-key callers attempting buzzabout__ask get a structured forbidden error.

Troubleshooting

Server not showing up

Desktop: confirm claude_desktop_config.json is valid JSON (Claude logs to ~/Library/Logs/Claude/main.log on macOS). Common mistake: pasting the snippet outside the existing mcpServers block.

Web: make sure your workspace plan includes "Custom integrations". Free / Pro accounts don't see the option, only Team / Enterprise.

If the tools list is empty, the most likely causes are:

OAuth token revoked — sign out and back in via Claude's integration settings.
Network proxy / firewall — outbound HTTPS to api.buzzabout.ai/mcp/ is blocked.
Account doesn't have access — the Buzzabout account hitting OAuth must be on a plan with API access.

Still stuck? Mail support@buzzabout.ai with the request id from any failed call.

On this page