`social_topic_volume`

Pack: social-signal · Endpoint: https://gateway.pipeworx.io/social-signal/mcp

SOCIAL MEDIA VOLUME as a TIME SERIES: how many posts mention a topic, bucketed by day or hour, so you can see the POST VOLUME TREND and whether SOCIAL CHATTER ABOUT A TOPIC is rising or fading. Answers “how much is X being discussed”, “BUZZ OVER TIME for X”, “is attention on X growing this week”. Returns a per-bucket count broken out by network, running totals, engagement sums where the source exposes them, and an explicit window_actually_covered block. A bucket is a number only where that network was truly measured; where reach ran out it is null, so a measured zero is always distinguishable from an unobserved gap.

Parameters

Name	Type	Required	Description
`topic`	string	yes	The search term to count posts for. Examples: “bitcoin”, “openai”, “federal reserve”. Mastodon matches this as a single hashtag.
`days`	number	no	How many days back to measure. Default 7, maximum 30. With bucket=“hour” this is capped at 3 days.
`bucket`	string	no	Bucket width for the series. Default “day”. Use “hour” for intraday spikes (window capped at 3 days).
`networks`	array	no	Subset of networks to measure. Default is all four: bluesky, mastodon, reddit, hackernews.
`items`	string	no
`mastodon_instance`	string	no	Mastodon instance whose public hashtag timeline is read. Default mastodon.social. Examples: “mastodon.world”, “fosstodon.org”.

Example call

Arguments

{
  "topic": "artificial intelligence",
  "days": 7
}

curl

curl -X POST https://gateway.pipeworx.io/social-signal/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"social_topic_volume","arguments":{"topic":"artificial intelligence","days":7}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('social_topic_volume', {
  "topic": "artificial intelligence",
  "days": 7
});

More examples

{
  "topic": "federal reserve",
  "days": 14,
  "bucket": "day"
}

{
  "topic": "bitcoin",
  "days": 2,
  "bucket": "hour",
  "networks": [
    "bluesky",
    "hackernews"
  ]
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "social-signal": {
      "url": "https://gateway.pipeworx.io/social-signal/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

social_topic_volume