# io.usefulapi/stream (remote · stream.usefulapi.io)

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

- Trust score: 18/100 (low)
- Change this week: −51
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- remote · `stream.usefulapi.io`: 18/100 (this document), [markdown](https://verifymcp.io/servers/io-usefulapi-stream/stream.md), [page](https://verifymcp.io/servers/io-usefulapi-stream/stream)

## Channel facts

- Endpoint: `https://stream.usefulapi.io/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `1.0.1`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Endpoint Security**: 46/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - Authorisation not fully verified: no authorisation is required to connect, but we couldn't read the tool list to see what that exposes.
  - HTTPS not yet verified: we couldn't determine whether a plaintext access path exists.
  - HSTS check failed: the Strict-Transport-Security header is absent.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
- **Transport & Reachability**: 0/100
  - Transport check failed: declared streamable-http, but the endpoint returned HTTP 429.
- **Schema Quality & AI Usability**: 0/100
  - Schema not yet verified: we couldn't read the endpoint's schema.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **Tool Coverage**: 0/100
  - Tool coverage not yet verified: we couldn't read the endpoint's tools.
- **Capabilities**: 0/100
  - Capabilities not yet verified: we couldn't read the endpoint's capabilities.

**Unverified: 4 categories.** Categories scored 0 because we could not verify them: authentication we do not have, an unreachable endpoint, or not enough scan history. We only credit what we can confirm.

## Install

### Claude

```bash
claude mcp add --transport http io-usefulapi-stream https://stream.usefulapi.io/mcp
```

### Codex

```toml
[mcp_servers.io-usefulapi-stream]
url = "https://stream.usefulapi.io/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "io-usefulapi-stream": {
      "type": "remote",
      "url": "https://stream.usefulapi.io/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add io-usefulapi-stream --url https://stream.usefulapi.io/mcp --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  io-usefulapi-stream:
    url: "https://stream.usefulapi.io/mcp"
```

### Other

```json
{
  "mcpServers": {
    "io-usefulapi-stream": {
      "type": "http",
      "url": "https://stream.usefulapi.io/mcp"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-03 (score 18, −55)

- [security regression] Endpoint reachability: reachable → not serving MCP
- [security regression] Stability: 0.20 → unverified
- [security regression] Authorization: pass → unverified
- [security regression] Transport: pass → fail
- [functional regression] Tool coverage: 100 → unverified
- [functional regression] Capabilities: fail → unverified

### 2026-08-02 (score 73, +55)

- [security improvement] Authorization: unverified → pass
- [security improvement] Transport: fail → pass
- [functional regression] MCP protocol: unverified → fail
- [functional improvement] Endpoint reachability: not serving MCP → reachable
- [functional improvement] Tool coverage: unverified → 100
- [functional improvement] Stability: unverified → 0.20

### 2026-08-01 (score 18, −54)

- [security regression] Endpoint reachability: reachable → not serving MCP
- [security regression] Stability: 0.13 → unverified
- [security regression] Authorization: pass → unverified
- [security regression] Transport: pass → fail
- [functional regression] Capabilities: fail → unverified
- [functional regression] Tool coverage: 100 → unverified

### 2026-07-31 (score 72, +3)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-30 (score 69, −2)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-29 (score 71, +1)

No change was recorded against any check on this day. Stability & Change Management went from 3 to 7. That category is still filling its 30-day observation window: 1 days of observed history at the previous scan, 2 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-07-28 (score 70, +1)

- [functional improvement] Stability: unverified → 0.03

### 2026-07-27 (score 69, +57)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

## MCP tools (13)

### `stream_get_app` (~39 tokens)

Get app settings

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` (~161 tokens)

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.

Input parameters:

- `filter` (object): Stream filter_conditions object, e.g. {"type":"messaging"} or {"members":{"$in":["u1"]}}. Default {} (all channels the app can see).
- `limit` (integer): Max channels (<=30). Default 30.
- `message_limit` (integer): Recent messages per channel to include. Default 25.
- `offset` (integer): Pagination offset.
- `sort` (array): Default [{"field":"last_message_at","direction":-1}].

### `stream_get_channel` (~125 tokens)

Get channel state + recent messages

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.

Input parameters:

- `id` (string, required): Channel id (the part after the type).
- `messages_limit` (integer): Recent messages to return. Default 25.
- `type` (string, required): Channel type, e.g. "messaging", "team", "livestream".

### `stream_search_messages` (~189 tokens)

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.

Input parameters:

- `filter` (object, required): Channel filter_conditions, e.g. {"type":"messaging"} or {"members":{"$in":["u1"]}}.
- `limit` (integer): Max results (<=100). Default 20.
- `message_filter` (object): Message filter object, e.g. {"text":{"$q":"refund"}} or {"attachments":{"$exists":true}}.
- `next` (string): Pagination cursor returned by a previous search.
- `query` (string): Full-text search string. Provide this OR message_filter.
- `sort` (array): Sort spec for results.

### `stream_get_message` (~55 tokens)

Get a message

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

Input parameters:

- `id` (string, required): Message id.
- `show_deleted` (boolean): Include the message even if soft-deleted. Default false.

### `stream_get_replies` (~69 tokens)

Get thread replies

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

Input parameters:

- `limit` (integer): Max replies (<=300). Default 25.
- `parent_id` (string, required): Parent (thread-root) message id.

### `stream_get_reactions` (~61 tokens)

Get message reactions

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

Input parameters:

- `id` (string, required): Message id.
- `limit` (integer): Max reactions. Default 50.
- `offset` (integer): Pagination offset.

### `stream_query_members` (~153 tokens)

Query channel 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.

Input parameters:

- `filter` (object): Member filter_conditions, e.g. {"user_id":{"$in":["u1","u2"]}}. Default {}.
- `id` (string, required): Channel id.
- `limit` (integer): Max members (<=100). Default 100.
- `offset` (integer): Pagination offset.
- `sort` (array): Sort spec, e.g. [{"field":"created_at","direction":1}].
- `type` (string, required): Channel type, e.g. "messaging".

### `stream_query_users` (~124 tokens)

Query users

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

Input parameters:

- `filter` (object): User filter_conditions, e.g. {"role":{"$eq":"admin"}}. Default {} (all users).
- `limit` (integer): Max users (<=100). Default 100.
- `offset` (integer): Pagination offset.
- `sort` (array): Sort spec, e.g. [{"field":"created_at","direction":-1}].

### `stream_query_threads` (~103 tokens)

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.

Input parameters:

- `limit` (integer): Max threads (<=25). Default 10.
- `reply_limit` (integer): Replies to preview per thread. Default 3.
- `sort` (array): Sort spec for threads.
- `user_id` (string): User id to scope thread participation/read-state to.

### `stream_get_unread_counts` (~49 tokens)

Get unread counts for a user

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

Input parameters:

- `user_id` (string, required): User id to fetch unread counts for.

### `stream_send_message` (~114 tokens)

Send a message (WRITE — posts to Stream)

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

Input parameters:

- `id` (string, required): Channel id.
- `mentioned_users` (array): User ids to @mention.
- `text` (string, required): Message text.
- `type` (string, required): Channel type, e.g. "messaging".
- `user_id` (string, required): Existing user id to send the message as.

### `stream_send_reaction` (~103 tokens)

Send a reaction (WRITE — posts to Stream)

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

Input parameters:

- `id` (string, required): Message id to react to.
- `reaction_type` (string, required): Reaction type, e.g. "like", "love", "haha".
- `user_id` (string, required): Existing user id to react as.

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/io-usefulapi-stream/stream#diagnostics

## Score history

- 2026-08-03: 18
- 2026-08-02: 73
- 2026-08-01: 18
- 2026-07-31: 72
- 2026-07-30: 69
- 2026-07-29: 71
- 2026-07-28: 70
- 2026-07-27: 69
- 2026-07-26: 12

## Links

- Remote endpoint: https://stream.usefulapi.io/mcp
- Repository: https://github.com/m190/usefulapi-mcp
- Changelog RSS feed: https://verifymcp.io/servers/io-usefulapi-stream/stream/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/io-usefulapi-stream/stream/changelog.json
- HTML version of this page: https://verifymcp.io/servers/io-usefulapi-stream/stream