mcp-getstream-feeds — Erwann Mest

Features

Feed subscription inspection — list everything a feed follows and everything that follows it, paginated.
Activity retrieval — fetch recent activities on any feed with full timestamps and payloads.
Follow management — create or remove follow relationships between feeds with a required confirm safety gate.
Safe by default — write tools (follow, unfollow) require explicit confirmation to prevent accidental mutations.
Zero-config auth — pass your GetStream API key and secret via environment variables; the SDK signs requests server-side automatically.

Install

npx @kud/mcp-getstream-feeds

Add the server to your MCP client configuration:

{
  "mcpServers": {
    "mcp-getstream-feeds": {
      "command": "npx",
      "args": ["@kud/mcp-getstream-feeds"],
      "env": {
        "MCP_GETSTREAM_API_KEY": "<your-api-key>",
        "MCP_GETSTREAM_SECRET": "<your-api-secret>"
      }
    }
  }
}

Usage

Tool	Description
`getstream_feed_following`	Get feeds that a specific feed follows (its subscriptions).
`getstream_feed_followers`	Get feeds that follow a specific feed (its subscribers).
`getstream_feed_activities`	Retrieve recent activities on a feed with timestamps and payloads.
`getstream_feed_follow`	Subscribe one feed to another. Requires `confirm: true`.
`getstream_feed_unfollow`	Remove a follow relationship between two feeds. Requires `confirm: true`.

Development

git clone https://github.com/kud/mcp-getstream-feeds.git
cd mcp-getstream-feeds
npm install
npm run dev

Script	Description
`npm run dev`	Run via `tsx` (no build step)
`npm run build`	Compile TypeScript to `dist/`
`npm test`	Run tests with Vitest
`npm run inspect:dev`	Launch MCP Inspector against source