MCP server
Stream MCP by usefulapi
Query channels, search messages, and read threads, users and reactions in your Stream…
- 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/mcpAdd to Settings → Connectors → Add custom connector
https://stream.usefulapi.io/mcpInstall 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