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

A
Qualität der Beschreibung
100%
Vollständigkeit des Schemas
92%
Qualität der Benennung
100%
Risiko der Vergiftung
100%
Übereinstimmung der Berechtigungen
100%
Einhaltung des Protokolls
100%

Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.

Kontextkosten

~2,598Tokens (Tool-Definitionen)
~1.6 KBTypische Antwortgröße
Erhebliche Auswirkung auf die Aufmerksamkeit (2.03% von 128k Kontext)

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-http

Was es kann

Tool-Inventar

Tools (13)

🟢 Nur lesen🟡 Schreiben🔴 Löschen⚪ Unbekannt
🟢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

Diesen Server bewerten

Nachweis

Aktuelle Beobachtungen

verifiziertVersion nicht aufgezeichnet13 Tools
verifiziertVersion nicht aufgezeichnet13 Tools
verifiziertVersion nicht aufgezeichnet13 Tools
verifiziertVersion nicht aufgezeichnet13 Tools
fehlgeschlagene BeobachtungVersion nicht aufgezeichnet—
fehlgeschlagene BeobachtungVersion nicht aufgezeichnet—