Who it is for

Two ways in: ask, or build

Marketers: ask Claude, get research

Add buzzabout as a custom connector in Claude with https://mcp.buzzabout.ai/mcp, sign in, and ask what your audience wants, what they complain about and how they say it. You get the answer and the posts that prove it. Connector steps.

Growth engineers: vibecode on real social data

One command: claude mcp add --transport http buzzabout https://mcp.buzzabout.ai/mcp. Then build on it: tracking agents re-run your searches daily or weekly and deliver cited digests to a webhook or Slack, and the REST API comes with Business.

Analysis, not raw records

What does this MCP server return that a scraper does not?

Most social media MCP servers hand your agent raw post records. Your agent then spends its context reading them. buzzabout does the reading on its side and returns the result.

Themes with post counts

Pattern detection turns a collection into 2 to 15 named themes, focused on the question you ask. Each theme has a description, a post count and the posts behind it.

Answers as tables

Ask a question about your data and get a table back: counts, breakdowns, rankings and time series. Your agent reads a few rows, not a thousand posts.

Audience aggregates

Profile the people commenting on a topic. You get gender, age band, interests, countries, brand affinities and Big Five (OCEAN) trait averages. No individual profile is exposed.

Posts already tagged

Every collected post comes back with sentiment, emotions, topics, category, tone of voice, intent, questions, brands and a summary. Filtering and counting need no extra reading.

Each post can also carry up to 100 top-level comments at no extra cost, and your agent reads them through the query tool, so the objections and questions in the replies count too.

The server also protects your credits. Before it collects, it previews the topic. Collection starts only when the preview finds enough matching posts and the sample is about the right subject. Off-topic, out-of-window and duplicate posts are dropped before billing.

Examples

What can your agent do with it?

Ask in plain words. Your agent picks the tools. Here is what it calls and what comes back.

"Collect 250 Reddit and TikTok posts about protein bars from the last three months and group the complaints."

Tools: collect_mentionsget_rundetect_patternsquery
Returns: Named complaint themes, each with a description, a post count and the posts that support it.

"Who comments on posts about home espresso machines? Break it down by age band and country."

Tools: collect_audienceget_runquery
Returns: A table of age bands and countries for the commenters. Groups under 10 profiles are hidden. Audience research needs the Pro plan or above.

"How did sentiment about our brand change week by week, and which posts drove the dips?"

Tools: querylist_mentions
Returns: A weekly sentiment series over posts you already collected, then the posts behind the low weeks, already tagged.

"Research which hooks skincare creators use on TikTok this month and chart them."

Tools: askget_messagerender
Returns: A written answer from the buzzabout research agent, plus charts and tables that open inside hosts that support MCP Apps. Other hosts get the text.

"What did my tracking agents pick up since Monday?"

Tools: list_tracking_agentsquerylist_mentions
Returns: The posts your scheduled tracking agents collected, with counts and themes from a query over their collections.

Setup

How do I connect the buzzabout MCP server?

One endpoint for every client: https://mcp.buzzabout.ai/mcp over streamable HTTP. Sign in with your buzzabout account, or send an API key in the x-api-key header.

Claude Code

Add the server, then run /mcp inside Claude Code and sign in with your buzzabout account.

claude mcp add --transport http buzzabout https://mcp.buzzabout.ai/mcp

To use an API key instead of signing in:

claude mcp add --transport http buzzabout https://mcp.buzzabout.ai/mcp \
  --header "x-api-key: YOUR_API_KEY"

Claude Desktop and claude.ai

Open Settings, then Connectors, and add a custom connector. Name it buzzabout and paste https://mcp.buzzabout.ai/mcp as the URL. Click Connect and sign in with your buzzabout account. There is nothing to copy or store.

Cursor

Add the server to ~/.cursor/mcp.json with an API key:

{
  "mcpServers": {
    "buzzabout": {
      "url": "https://mcp.buzzabout.ai/mcp",
      "headers": { "x-api-key": "YOUR_API_KEY" }
    }
  }
}

Clients that support MCP sign-in can leave out the headers block and sign in with your buzzabout account instead.

Any streamable HTTP client

Point your MCP SDK at the endpoint and send the key on every request. This call lists the 15 tools and costs nothing:

curl -X POST https://mcp.buzzabout.ai/mcp \
  -H "x-api-key: $BUZZABOUT_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Setup for Codex, ChatGPT and the Python and TypeScript SDKs is in the MCP docs.

Authentication

How does authentication work?

The same URL accepts two methods. Both connect to your buzzabout account and see the same collections.

Method	Best for	What you need	Plans
Sign in (OAuth)	Claude Desktop, claude.ai, Claude Code, ChatGPT	Your buzzabout login. The client stores and refreshes the token.	Every plan
API key (`x-api-key` header)	Cursor, Codex, CI jobs and your own agents	A key from Settings, then API keys, in the buzzabout app	Business and Enterprise

The server publishes standard OAuth metadata with PKCE and dynamic client registration, so MCP clients can sign in without manual setup. A request without credentials gets a 401 that points the client to that metadata. More detail is in the MCP authentication docs.

Cheaper than the parts

Is it cheaper than building it yourself?

Yes. Research-grade social data takes five parts: a data provider for collection, speech-to-text, image and on-screen text reading, AI labeling, and hosting. At 10,000 analyzed posts a month across all seven platforms, with comments and full analysis, those parts cost about $591 at list price, before anyone builds or maintains them. The buzzabout Business plan covers the same volume for $450.

buzzabout cost model, November 2026: list-price usage plus hosting on the cheaper data provider route; engineering time not included.

Tools and credits

What does each call cost?

Reads are free. Your agent spends credits when it collects data or runs analysis. Every tool description says whether the tool is free or billed, so your agent knows before it calls.

Tool	What it does	Cost
Collect and analyse
`collect_mentions`	Previews a topic, then collects and tags matching posts	1 credit per platform previewed, then 1 credit per post delivered
`detect_patterns`	Groups a collection into named themes around your question	0.5 credit per post processed
`collect_audience`	Profiles the commenters in a collection, as aggregates	3 credits per profile (Pro and up)
`ingest_mention`	Saves and analyses one post from its URL	1 credit
Ask
`query`	Answers a question about your data with a table	AI inference, priced by tokens
`ask`	Runs a research turn with the buzzabout agent	AI inference, priced by tokens, plus credits for any data it collects
Read and check (free)
`get_me`	Your plan, limits and credit balance	Free
`list_collections`	Your mentions and audience collections	Free
`list_mentions`	Posts in your collections, filtered, sorted and paginated	Free
`get_run`	Progress of a collection, audience or pattern run	Free
`get_message`	Progress and output of a research turn	Free
`render`	Shows a chart or table from a research answer	Free
`get_save_mention_status`	Progress of a saved post	Free
`list_tracking_agents`	Your scheduled tracking agents and their collections	Free
`get_tracking_agent`	One tracking agent's setup	Free

How credits work

You pay for posts delivered, not posts requested. Off-topic, out-of-window and duplicate posts are filtered out before billing.
A preview is billed even when the server decides not to collect. No collection runs in that case.
If your balance cannot cover a full run, collect_mentions collects what your balance covers instead of failing.
Plan credits refresh every month and do not roll over. You can top up any amount from $5 at any time.
When credits run out, new research jobs pause until you top up or your plan credits refresh.

Plans

Which plans include the MCP server?

All of them. Prices cover the whole plan, not each seat, and payments are in USD.

Plan	Price	Credits per month	Posts per research	Audience research	API key
Starter	$98 per month	2,000	250	No	No
Pro	$178 per month	5,000	1,000	Yes	No
Business	$450 per month	20,000	1,000	Yes	Yes
Enterprise	Custom	Custom	10,000+	Yes	Yes

Yearly billing gives 2 months free. Try for free. Full details are on the pricing page.

Limits

What are the limits?

The numbers your agent should plan around.

Posts per run: 20 to 1,000, capped by plan: 250 on Starter, 1,000 on Pro and Business.
Comments: up to 100 per post, 10 by default.
Platforms: Reddit, TikTok, YouTube, X, Instagram, LinkedIn and Facebook. With no platforms set, collect_mentions searches Reddit, X and YouTube.
History: 24 months back, or 60 months on Business.
Collection gate: a collection starts only when the preview estimates at least 200 matching posts, returns at least 5 sample posts, and at least 15% of the sample is on topic.
Audience data: aggregates only. Groups under 10 profiles are hidden. Individual profiles, identifiers and authenticity scores are not available over MCP.
Waiting: get_run and get_message wait up to about 45 seconds per call for news, so your agent does not need to poll in a tight loop.
Speed: most runs finish in a few minutes. Across our production runs, a fully analysed run took a median of 3.5 minutes.

FAQ

What do developers ask about the MCP server?

Short answers to the common questions.

What is an MCP server?

MCP (Model Context Protocol) is an open standard that lets AI assistants call outside tools. The buzzabout MCP server gives an assistant tools to collect and analyse public social media conversations.

Is the buzzabout MCP server free?

No. It comes with every paid plan, from Starter at $98 a month. Try for free. Reads and status checks inside the server are free. Collection and analysis use credits.

Do I need an API key?

Not for clients that sign in, such as Claude and ChatGPT. API keys are for clients you configure with a header, such as Cursor or your own agents. Keys come with the Business and Enterprise plans.

How is this different from a social media scraping MCP?

A scraping server returns raw post records, and your agent has to read them all. buzzabout returns analysis: themes with post counts, tables that answer a question, audience aggregates and research answers. Every collected post is also tagged for sentiment, emotions, topics, brands and more.

Can a collection run cost more than my balance?

No. If your balance cannot cover a full run, collect_mentions shrinks the run to what you can afford. If even 20 posts are out of reach, the run does not start. Paid work always needs available balance, and get_me shows your balance for free.

What happens when a topic is too small or off topic?

The preview declines and says why: too few matching posts, too small a sample, or results about a different subject. It also says what to change. The preview is billed at 1 credit per platform, and no collection runs.

Does it return data about individual people?

No. Audience results come back as aggregates such as age bands, countries and interests. Groups under 10 profiles are hidden, and individual profiles are never returned over MCP.

How does the MCP server relate to the REST API?

They share the same account and data. The MCP server is on every plan. The REST API is on Business and Enterprise. See the API page for the REST side.

Which AI clients work with it?

Any client that supports remote MCP servers over streamable HTTP. Setup steps for Claude, Claude Code, Codex, Cursor and ChatGPT are in the docs, and every tool is listed in the tools reference.

Give your agent social media research

Log in or sign up in the buzzabout app, then connect your client to https://mcp.buzzabout.ai/mcp.

Log in or sign up Read the MCP docs

The social media research MCP for marketers and growth engineers