Skip to main content
Glama

Server Details

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

Status
Healthy
Last Tested
Transport
Streamable HTTP
URL
Repository
m190/usefulapi-mcp
GitHub Stars
0

Glama MCP Gateway

Connect through Glama MCP Gateway for full control over tool access and complete visibility into every call.

MCP client
Glama
MCP server

Full call logging

Every tool call is logged with complete inputs and outputs, so you can debug issues and audit what your agents are doing.

Tool access control

Enable or disable individual tools per connector, so you decide what your agents can and cannot do.

Managed credentials

Glama handles OAuth flows, token storage, and automatic rotation, so credentials never expire on your clients.

Usage analytics

See which tools your agents call, how often, and when, so you can understand usage patterns and catch anomalies.

100% free. Your data is private.

Tool Definition Quality

Score is being calculated. Check back soon.

Available Tools

13 tools
stream_get_appGet app settings
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

stream_get_channelGet channel state + recent messages
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
idYesChannel id (the part after the type).
typeYesChannel type, e.g. "messaging", "team", "livestream".
messages_limitNoRecent messages to return. Default 25.
stream_get_messageGet a message
Read-only
Inspect

Fetch a single message by its id. GET /api/v2/chat/messages/{id}.

ParametersJSON Schema
NameRequiredDescriptionDefault
idYesMessage id.
show_deletedNoInclude the message even if soft-deleted. Default false.
stream_get_reactionsGet message reactions
Read-only
Inspect

List the reactions on a message. GET /api/v2/chat/messages/{id}/reactions.

ParametersJSON Schema
NameRequiredDescriptionDefault
idYesMessage id.
limitNoMax reactions. Default 50.
offsetNoPagination offset.
stream_get_repliesGet thread replies
Read-only
Inspect

Fetch the reply messages in a thread, given the parent message id. GET /api/v2/chat/messages/{parent_id}/replies.

ParametersJSON Schema
NameRequiredDescriptionDefault
limitNoMax replies (<=300). Default 25.
parent_idYesParent (thread-root) message id.
stream_get_unread_countsGet unread counts for a user
Read-only
Inspect

Fetch total and per-channel unread message/mention counts for one user. GET /api/v2/chat/unread.

ParametersJSON Schema
NameRequiredDescriptionDefault
user_idYesUser id to fetch unread counts for.
stream_query_channelsQuery channels
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
sortNoDefault [{"field":"last_message_at","direction":-1}].
limitNoMax channels (<=30). Default 30.
filterNoStream filter_conditions object, e.g. {"type":"messaging"} or {"members":{"$in":["u1"]}}. Default {} (all channels the app can see).
offsetNoPagination offset.
message_limitNoRecent messages per channel to include. Default 25.
stream_query_membersQuery channel members
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
idYesChannel id.
sortNoSort spec, e.g. [{"field":"created_at","direction":1}].
typeYesChannel type, e.g. "messaging".
limitNoMax members (<=100). Default 100.
filterNoMember filter_conditions, e.g. {"user_id":{"$in":["u1","u2"]}}. Default {}.
offsetNoPagination offset.
stream_query_threadsQuery threads
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
sortNoSort spec for threads.
limitNoMax threads (<=25). Default 10.
user_idNoUser id to scope thread participation/read-state to.
reply_limitNoReplies to preview per thread. Default 3.
stream_query_usersQuery users
Read-only
Inspect

List/filter users in the app. e.g. filter {"role":{"$eq":"admin"}} or {"id":{"$in":["u1"]}}. GET /api/v2/users.

ParametersJSON Schema
NameRequiredDescriptionDefault
sortNoSort spec, e.g. [{"field":"created_at","direction":-1}].
limitNoMax users (<=100). Default 100.
filterNoUser filter_conditions, e.g. {"role":{"$eq":"admin"}}. Default {} (all users).
offsetNoPagination offset.
stream_search_messagesSearch messages
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
nextNoPagination cursor returned by a previous search.
sortNoSort spec for results.
limitNoMax results (<=100). Default 20.
queryNoFull-text search string. Provide this OR message_filter.
filterYesChannel filter_conditions, e.g. {"type":"messaging"} or {"members":{"$in":["u1"]}}.
message_filterNoMessage filter object, e.g. {"text":{"$q":"refund"}} or {"attachments":{"$exists":true}}.
stream_send_messageSend a message (WRITE — posts to Stream)
Destructive
Inspect

⚠️ 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.

ParametersJSON Schema
NameRequiredDescriptionDefault
idYesChannel id.
textYesMessage text.
typeYesChannel type, e.g. "messaging".
user_idYesExisting user id to send the message as.
mentioned_usersNoUser ids to @mention.
stream_send_reactionSend a reaction (WRITE — posts to Stream)
Destructive
Inspect

⚠️ 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.

ParametersJSON Schema
NameRequiredDescriptionDefault
idYesMessage id to react to.
user_idYesExisting user id to react as.
reaction_typeYesReaction type, e.g. "like", "love", "haha".

Discussions

No comments yet. Be the first to start the discussion!

Try in Browser

Your Connectors

Sign in to create a connector for this server.