Install

Drop the snippet into your client's MCP config and restart the client. The server is stateless, so no extra setup is required.

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or the equivalent on Windows / Linux:

{
  "mcpServers": {
    "rumor": {
      "url": "https://rumor.io/api/mcp",
      "headers": {
        "X-API-Key": "pk_your_api_key"
      }
    }
  }
}

Cursor

Add the same block to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "rumor": {
      "url": "https://rumor.io/api/mcp",
      "headers": {
        "X-API-Key": "pk_your_api_key"
      }
    }
  }
}

Need an API key? Grab one from your profile page.

Tools

Four tools cover the surface area: a single-asset snapshot, a timeseries fetch, an aggregated summary, and market-wide sector trends. Errors and rate limits follow the same envelope as the REST API — see the error reference and rate limits.

A note on units, common to every tool: attention level fields (socialAttention*, sentimentNet*Attention*, topic*Attention*) are 0–1 fractions of a cross-entity pool, not percentages. Attention-based *Change* fields are percentage-point deltas in that same fraction unit (level_now − level_prior), not relative percent change; null means there is no prior-period data, and the prior level is level − change. Only priceChangePercentage* is a relative percent.