Stream MCP by usefulapi
Query channels, search messages, and read threads, users and reactions in your Stream Chat app.
使うべきか
品質と安全性
ツール定義とプロトコルへの準拠に関する自動分析に基づいています。
コンテキストコスト
これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。
インストール
ワンクリックインストール
これを `claude_desktop_config.json` ファイルに追加してください:
{
"mcpServers": {
"stream": {
"url": "https://stream.usefulapi.io/mcp"
}
}
}リモートエンドポイント
https://stream.usefulapi.io/mcpstreamable-httpできること
ツール一覧
ツール(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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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}.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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"
}コミュニティ
エビデンス