Stream MCP by usefulapi
Query channels, search messages, and read threads, users and reactions in your Stream Chat app.
Sollte ich dies verwenden
Qualität und Sicherheit
Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.
Kontextkosten
Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.
Installieren
Installation mit einem Klick
Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:
{
"mcpServers": {
"stream": {
"url": "https://stream.usefulapi.io/mcp"
}
}
}Remote-Endpunkte
https://stream.usefulapi.io/mcpstreamable-httpWas es kann
Tool-Inventar
Tools (13)
🟢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.
Eingabe-Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢stream_query_channels(filter, sort, limit, offset, message_limit)
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.
Eingabe-Schema
{
"type": "object",
"properties": {
"filter": {
"description": "Stream filter_conditions object, e.g. {\"type\":\"messaging\"} or {\"members\":{\"$in\":[\"u1\"]}}. Default {} (all channels the app can see).",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"sort": {
"description": "Default [{\"field\":\"last_message_at\",\"direction\":-1}].",
"type": "array",
"items": {
"type": "object",
"properties": {
"field": {
"type": "string"
},
"direction": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
},
"required": [
"field",
"direction"
]
}
},
"limit": {
"description": "Max channels (<=30). Default 30.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 30
},
"offset": {
"description": "Pagination offset.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"message_limit": {
"description": "Recent messages per channel to include. Default 25.",
"type": "integer",
"minimum": 0,
"maximum": 300
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢stream_get_channel(type, id, messages_limit)
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.
Eingabe-Schema
{
"type": "object",
"properties": {
"type": {
"type": "string",
"description": "Channel type, e.g. \"messaging\", \"team\", \"livestream\"."
},
"id": {
"type": "string",
"description": "Channel id (the part after the type)."
},
"messages_limit": {
"description": "Recent messages to return. Default 25.",
"type": "integer",
"minimum": 0,
"maximum": 300
}
},
"required": [
"type",
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢stream_search_messages(filter, query, message_filter, limit, sort, ...)
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.
Eingabe-Schema
{
"type": "object",
"properties": {
"filter": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {},
"description": "Channel filter_conditions, e.g. {\"type\":\"messaging\"} or {\"members\":{\"$in\":[\"u1\"]}}."
},
"query": {
"description": "Full-text search string. Provide this OR message_filter.",
"type": "string"
},
"message_filter": {
"description": "Message filter object, e.g. {\"text\":{\"$q\":\"refund\"}} or {\"attachments\":{\"$exists\":true}}.",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"limit": {
"description": "Max results (<=100). Default 20.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
},
"sort": {
"description": "Sort spec for results.",
"type": "array",
"items": {
"type": "object",
"properties": {
"field": {
"type": "string"
},
"direction": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
},
"required": [
"field",
"direction"
]
}
},
"next": {
"description": "Pagination cursor returned by a previous search.",
"type": "string"
}
},
"required": [
"filter"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢stream_get_message(id, show_deleted)
Fetch a single message by its id. GET /api/v2/chat/messages/{id}.
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Message id."
},
"show_deleted": {
"description": "Include the message even if soft-deleted. Default false.",
"type": "boolean"
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢stream_get_replies(parent_id, limit)
Fetch the reply messages in a thread, given the parent message id. GET /api/v2/chat/messages/{parent_id}/replies.
Eingabe-Schema
{
"type": "object",
"properties": {
"parent_id": {
"type": "string",
"description": "Parent (thread-root) message id."
},
"limit": {
"description": "Max replies (<=300). Default 25.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 300
}
},
"required": [
"parent_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢stream_get_reactions(id, limit, offset)
List the reactions on a message. GET /api/v2/chat/messages/{id}/reactions.
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Message id."
},
"limit": {
"description": "Max reactions. Default 50.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 300
},
"offset": {
"description": "Pagination offset.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢stream_query_members(type, id, filter, sort, limit, ...)
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.
Eingabe-Schema
{
"type": "object",
"properties": {
"type": {
"type": "string",
"description": "Channel type, e.g. \"messaging\"."
},
"id": {
"type": "string",
"description": "Channel id."
},
"filter": {
"description": "Member filter_conditions, e.g. {\"user_id\":{\"$in\":[\"u1\",\"u2\"]}}. Default {}.",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"sort": {
"description": "Sort spec, e.g. [{\"field\":\"created_at\",\"direction\":1}].",
"type": "array",
"items": {
"type": "object",
"properties": {
"field": {
"type": "string"
},
"direction": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
},
"required": [
"field",
"direction"
]
}
},
"limit": {
"description": "Max members (<=100). Default 100.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
},
"offset": {
"description": "Pagination offset.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"type",
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢stream_query_users(filter, sort, limit, offset)
List/filter users in the app. e.g. filter {"role":{"$eq":"admin"}} or {"id":{"$in":["u1"]}}. GET /api/v2/users.
Eingabe-Schema
{
"type": "object",
"properties": {
"filter": {
"description": "User filter_conditions, e.g. {\"role\":{\"$eq\":\"admin\"}}. Default {} (all users).",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"sort": {
"description": "Sort spec, e.g. [{\"field\":\"created_at\",\"direction\":-1}].",
"type": "array",
"items": {
"type": "object",
"properties": {
"field": {
"type": "string"
},
"direction": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
},
"required": [
"field",
"direction"
]
}
},
"limit": {
"description": "Max users (<=100). Default 100.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
},
"offset": {
"description": "Pagination offset.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢stream_query_threads(user_id, limit, reply_limit, sort)
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.
Eingabe-Schema
{
"type": "object",
"properties": {
"user_id": {
"description": "User id to scope thread participation/read-state to.",
"type": "string"
},
"limit": {
"description": "Max threads (<=25). Default 10.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 25
},
"reply_limit": {
"description": "Replies to preview per thread. Default 3.",
"type": "integer",
"minimum": 0,
"maximum": 10
},
"sort": {
"description": "Sort spec for threads.",
"type": "array",
"items": {
"type": "object",
"properties": {
"field": {
"type": "string"
},
"direction": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
},
"required": [
"field",
"direction"
]
}
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢stream_get_unread_counts(user_id)
Fetch total and per-channel unread message/mention counts for one user. GET /api/v2/chat/unread.
Eingabe-Schema
{
"type": "object",
"properties": {
"user_id": {
"type": "string",
"description": "User id to fetch unread counts for."
}
},
"required": [
"user_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴stream_send_message(type, id, text, user_id, mentioned_users)
⚠️ 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.
Eingabe-Schema
{
"type": "object",
"properties": {
"type": {
"type": "string",
"description": "Channel type, e.g. \"messaging\"."
},
"id": {
"type": "string",
"description": "Channel id."
},
"text": {
"type": "string",
"minLength": 1,
"description": "Message text."
},
"user_id": {
"type": "string",
"description": "Existing user id to send the message as."
},
"mentioned_users": {
"description": "User ids to @mention.",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"type",
"id",
"text",
"user_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴stream_send_reaction(id, reaction_type, user_id)
⚠️ 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.
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Message id to react to."
},
"reaction_type": {
"type": "string",
"minLength": 1,
"description": "Reaction type, e.g. \"like\", \"love\", \"haha\"."
},
"user_id": {
"type": "string",
"description": "Existing user id to react as."
}
},
"required": [
"id",
"reaction_type",
"user_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Community
Nachweis