Skip to content
MCP server

Stream MCP by usefulapi

Query channels, search messages, and read threads, users and reactions in your Stream…

Install
Runs
Remotely
Version
1.40.0
Listing updated
4 days ago

About Stream MCP by usefulapi

Stream MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.

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

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://stream.usefulapi.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "stream": {
      "url": "https://stream.usefulapi.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (13)

Read directly from the server.

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.

Stream MCP by usefulapi 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