# Stream MCP by usefulapi

> Stream MCP by usefulapi is an MCP server. Query channels, search messages, and read threads, users and reactions in your Stream Chat app. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/stream/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/stream
- **MCP Registry name:** io.usefulapi/stream
- **Listing updated:** 2026-11-13

## About

Query channels, search messages, and read threads, users and reactions in your Stream Chat app.

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http stream https://stream.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://stream.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "stream": {
      "url": "https://stream.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "stream": {
      "type": "http",
      "url": "https://stream.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "stream": {
      "serverUrl": "https://stream.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "stream": {
      "type": "http",
      "url": "https://stream.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `stream_get_app`: Fetch the Stream app's settings and configured channel types. Good first call to confirm credentials and discover available channel types. GET /api/v2/app.
- `stream_query_channels`: List/filter channels by a Stream query filter. e.g. filter {"type":"messaging"} or {"members":{"$in":["user-1"]}}. Returns channels with recent state. POST /api/v2/chat/channels.
- `stream_get_channel`: Fetch a single channel's state (config, members) and its most recent messages. Note: uses Stream's get-or-create endpoint — for an existing channel it reads; if the type/id does not exist it may be created empty. POST /api/v2/chat/channels/{type}/{id}/query.
- `stream_search_messages`: Search messages across channels. Scope with a channel filter (filter, e.g. {"type":"messaging"}) plus EITHER a full-text `query` OR a `message_filter` object (e.g. {"text":{"$q":"refund"}}). GET /api/v2/chat/search.
- `stream_get_message`: Fetch a single message by its id. GET /api/v2/chat/messages/{id}.
- `stream_get_replies`: Fetch the reply messages in a thread, given the parent message id. GET /api/v2/chat/messages/{parent_id}/replies.
- `stream_get_reactions`: List the reactions on a message. GET /api/v2/chat/messages/{id}/reactions.
- `stream_query_members`: List/filter the members of one channel. Requires the channel type + id. Optional member filter, e.g. {"name":{"$autocomplete":"jo"}}. GET /api/v2/chat/members.
- `stream_query_users`: List/filter users in the app. e.g. filter {"role":{"$eq":"admin"}} or {"id":{"$in":["u1"]}}. GET /api/v2/users.
- `stream_query_threads`: List threads (messages with replies). Server-side calls should pass a user_id to scope thread read-state to that user. POST /api/v2/chat/threads.
- `stream_get_unread_counts`: Fetch total and per-channel unread message/mention counts for one user. GET /api/v2/chat/unread.
- `stream_send_message`: ⚠️ WRITE: post a new message to a channel, attributed to user_id (must be an existing user in the app). POST /api/v2/chat/channels/{type}/{id}/message.
- `stream_send_reaction`: ⚠️ WRITE: add a reaction (e.g. "like", "love") to a message, attributed to user_id (must be an existing user). POST /api/v2/chat/messages/{id}/reaction.

## FAQ

### How do I add Stream MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http stream https://stream.usefulapi.io/mcp

---
Source: https://ai-powered.com/mcp/stream-mcp-by-usefulapi
