Clearstream MCP by usefulapi is an MCP server published by io.usefulapi, hosted at clearstream.usefulapi.io. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 15 tools, including clearstream_get_account, clearstream_list_numbers, clearstream_list_lists, clearstream_get_list, clearstream_list_subscribers_of_list.
Read lists, subscribers, tags and texts; send texts and change subscribers in Clearstream.
4,010 connections through 5 shared values. Tap any node.
Inferred from the host name and headers: what a server runs on, not who runs it.
Get the Clearstream account behind the API key: name, plan and settings. Good first call to confirm which account is connected. Clearstream API: GET /v1/account.
No parameters.
{
"name": "clearstream_get_account",
"title": "Get account",
"description": "Get the Clearstream account behind the API key: name, plan and settings. Good first call to confirm which account is connected. Clearstream API: GET /v1/account.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "Get account",
"readOnlyHint": true
}
}None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
List the shortcodes and longcodes this account can send texts from, and which one is the default. Clearstream API: GET /v1/numbers.
No parameters.
{
"name": "clearstream_list_numbers",
"title": "List sending numbers",
"description": "List the shortcodes and longcodes this account can send texts from, and which one is the default. Clearstream API: GET /v1/numbers.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List sending numbers",
"readOnlyHint": true
}
}List the subscriber lists (groups) in the account, with subscriber counts. Filter by name or locked state. Clearstream API: GET /v1/lists.
| Parameter | Type | Description |
|---|---|---|
| name | string | Partial match on the list name. |
| page | integer | Page number (default 1). |
| limit | integer | Results per page (1-100). |
| locked | string | Filter by locked state (default any). |
{
"name": "clearstream_list_lists",
"title": "List lists",
"description": "List the subscriber lists (groups) in the account, with subscriber counts. Filter by name or locked state. Clearstream API: GET /v1/lists.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"name": {
"type": "string",
"description": "Partial match on the list name."
},
"page": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Page number (default 1).",
"exclusiveMinimum": 0
},
"limit": {
"type": "integer",
"maximum": 100,
"description": "Results per page (1-100).",
"exclusiveMinimum": 0
},
"locked": {
"enum": [
"locked",
"not_locked",
"any"
],
"type": "string",
"description": "Filter by locked state (default any)."
}
}
},
"annotations": {
"title": "List lists",
"readOnlyHint": true
}
}Get one subscriber list: name, subscriber count, active texting subscriber count and sync status. Clearstream API: GET /v1/lists/{id}.
| Parameter | Type | Description |
|---|---|---|
| list_id * | any | List id (from clearstream_list_lists). |
{
"name": "clearstream_get_list",
"title": "Get a list",
"description": "Get one subscriber list: name, subscriber count, active texting subscriber count and sync status. Clearstream API: GET /v1/lists/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"list_id"
],
"properties": {
"list_id": {
"anyOf": [
{
"type": "string",
"pattern": "^[0-9]{1,20}$"
},
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
],
"description": "List id (from clearstream_list_lists)."
}
}
},
"annotations": {
"title": "Get a list",
"readOnlyHint": true
}
}List the subscribers in one list, with optional name filters. Clearstream API: GET /v1/lists/{id}/subscribers.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number (default 1). |
| first | string | Partial match on the first name. |
| limit | integer | Results per page (1-100). |
| list_id * | any | List id (from clearstream_list_lists). |
| full_name | string | Partial match on the full name. |
{
"name": "clearstream_list_subscribers_of_list",
"title": "List subscribers in a list",
"description": "List the subscribers in one list, with optional name filters. Clearstream API: GET /v1/lists/{id}/subscribers.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"list_id"
],
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Page number (default 1).",
"exclusiveMinimum": 0
},
"first": {
"type": "string",
"description": "Partial match on the first name."
},
"limit": {
"type": "integer",
"maximum": 100,
"description": "Results per page (1-100).",
"exclusiveMinimum": 0
},
"list_id": {
"anyOf": [
{
"type": "string",
"pattern": "^[0-9]{1,20}$"
},
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
],
"description": "List id (from clearstream_list_lists)."
},
"full_name": {
"type": "string",
"description": "Partial match on the full name."
}
}
},
"annotations": {
"title": "List subscribers in a list",
"readOnlyHint": true
}
}Search the account's subscribers by name or mobile number. Clearstream API: GET /v1/subscribers.
| Parameter | Type | Description |
|---|---|---|
| last | string | Partial match on the last name. |
| page | integer | Page number (default 1). |
| first | string | Partial match on the first name. |
| limit | integer | Results per page (default 20). |
| full_name | string | Partial match on the full name. |
| mobile_number | string | Exact match on the mobile number. |
{
"name": "clearstream_list_subscribers",
"title": "List subscribers",
"description": "Search the account's subscribers by name or mobile number. Clearstream API: GET /v1/subscribers.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"last": {
"type": "string",
"description": "Partial match on the last name."
},
"page": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Page number (default 1).",
"exclusiveMinimum": 0
},
"first": {
"type": "string",
"description": "Partial match on the first name."
},
"limit": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Results per page (default 20).",
"exclusiveMinimum": 0
},
"full_name": {
"type": "string",
"description": "Partial match on the full name."
},
"mobile_number": {
"type": "string",
"description": "Exact match on the mobile number."
}
}
},
"annotations": {
"title": "List subscribers",
"readOnlyHint": true
}
}Get one subscriber by mobile number: name, opt-in status, lists and tags. Clearstream API: GET /v1/subscribers/{number}.
| Parameter | Type | Description |
|---|---|---|
| mobile_number * | string | Mobile number in E.164 format, for example +12005551000. |
{
"name": "clearstream_get_subscriber",
"title": "Get a subscriber",
"description": "Get one subscriber by mobile number: name, opt-in status, lists and tags. Clearstream API: GET /v1/subscribers/{number}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"mobile_number"
],
"properties": {
"mobile_number": {
"type": "string",
"pattern": "^\\+?[0-9]{4,20}$",
"description": "Mobile number in E.164 format, for example +12005551000."
}
}
},
"annotations": {
"title": "Get a subscriber",
"readOnlyHint": true
}
}List the subscriber tags in the account. Clearstream API: GET /v1/tags.
No parameters.
{
"name": "clearstream_list_tags",
"title": "List tags",
"description": "List the subscriber tags in the account. Clearstream API: GET /v1/tags.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List tags",
"readOnlyHint": true
}
}List texts in the account's inbox history, incoming or outgoing, optionally for one number. Use the cursor from a previous reply for the next page. Clearstream API: GET /v1/texts.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Results per page (1-100). |
| cursor | string | Pagination cursor from a previous reply. |
| direction | string | IN for incoming, OUT for outgoing. |
| mobile_number | string | Exact match on the contact's mobile number. |
{
"name": "clearstream_list_texts",
"title": "List texts",
"description": "List texts in the account's inbox history, incoming or outgoing, optionally for one number. Use the cursor from a previous reply for the next page. Clearstream API: GET /v1/texts.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"description": "Results per page (1-100).",
"exclusiveMinimum": 0
},
"cursor": {
"type": "string",
"description": "Pagination cursor from a previous reply."
},
"direction": {
"enum": [
"IN",
"OUT"
],
"type": "string",
"description": "IN for incoming, OUT for outgoing."
},
"mobile_number": {
"type": "string",
"description": "Exact match on the contact's mobile number."
}
}
},
"annotations": {
"title": "List texts",
"readOnlyHint": true
}
}Get text volume statistics for a date range (YYYY-MM-DD, inclusive). Clearstream API: GET /v1/stats/texts.
| Parameter | Type | Description |
|---|---|---|
| end * | string | End date (YYYY-MM-DD). |
| start * | string | Start date (YYYY-MM-DD). |
| timezone | string | IANA timezone for the statistics (default UTC). |
{
"name": "clearstream_get_text_stats",
"title": "Get text statistics",
"description": "Get text volume statistics for a date range (YYYY-MM-DD, inclusive). Clearstream API: GET /v1/stats/texts.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"start",
"end"
],
"properties": {
"end": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "End date (YYYY-MM-DD)."
},
"start": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Start date (YYYY-MM-DD)."
},
"timezone": {
"type": "string",
"description": "IANA timezone for the statistics (default UTC)."
}
}
},
"annotations": {
"title": "Get text statistics",
"readOnlyHint": true
}
}Send one SMS to one or more numbers. This sends real messages to real phones and cannot be undone. The customer must hold explicit written consent from every recipient before you use this tool (Clearstream terms, section 4G). Opted-out numbers are skipped (for a list of numbers) or cause an error (for one number). Clearstream API: POST /v1/texts.
| Parameter | Type | Description |
|---|---|---|
| to * | any | One mobile number, or an array of up to 100 numbers. |
| from | string | A sending number from clearstream_list_numbers (default: the account shortcode). |
| media_url | string | Optional JPG or PNG image URL under 5 MB (MMS must be enabled). |
| text_body * | string | The message text. Header and body together must fit the character limit. |
| text_header | string | Sender name shown before the text, for example the organization name. GSM 7-bit characters only. |
| use_default_header | boolean | Use the account default header instead of text_header. |
{
"name": "clearstream_send_text",
"title": "Send a text",
"description": "Send one SMS to one or more numbers. This sends real messages to real phones and cannot be undone. The customer must hold explicit written consent from every recipient before you use this tool (Clearstream terms, section 4G). Opted-out numbers are skipped (for a list of numbers) or cause an error (for one number). Clearstream API: POST /v1/texts.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"to",
"text_body"
],
"properties": {
"to": {
"anyOf": [
{
"type": "string",
"pattern": "^\\+?[0-9(][0-9 ()\\-.]{3,24}$",
"description": "Mobile number, preferably E.164 format, for example +12005551000."
},
{
"type": "array",
"items": {
"type": "string",
"pattern": "^\\+?[0-9(][0-9 ()\\-.]{3,24}$",
"description": "Mobile number, preferably E.164 format, for example +12005551000."
},
"maxItems": 100,
"minItems": 1,
"description": "Mobile numbers in E.164 format (1-100 per call)."
}
],
"description": "One mobile number, or an array of up to 100 numbers."
},
"from": {
"type": "string",
"description": "A sending number from clearstream_list_numbers (default: the account shortcode)."
},
"media_url": {
"type": "string",
"format": "uri",
"description": "Optional JPG or PNG image URL under 5 MB (MMS must be enabled)."
},
"text_body": {
"type": "string",
"minLength": 1,
"description": "The message text. Header and body together must fit the character limit."
},
"text_header": {
"type": "string",
"description": "Sender name shown before the text, for example the organization name. GSM 7-bit characters only."
},
"use_default_header": {
"type": "boolean",
"description": "Use the account default header instead of text_header."
}
}
},
"annotations": {
"title": "Send a text",
"readOnlyHint": false,
"destructiveHint": true
}
}Create or add one subscriber, with optional lists and tags. By default the subscriber must confirm opt-in by text. The customer must hold explicit written consent from every recipient before you use this tool (Clearstream terms, section 4G). Clearstream API: POST /v1/subscribers.
| Parameter | Type | Description |
|---|---|---|
| last | string | Last name. |
| tags | array | Tag ids to add to the subscriber. |
| string | Email address. | |
| first | string | First name. |
| lists | array | List ids to add the subscriber to. |
| double_optin | boolean | Send a confirmation text before opt-in (default true). |
| mobile_number * | string | Mobile number, preferably E.164 format, for example +12005551000. |
{
"name": "clearstream_add_subscriber",
"title": "Add a subscriber",
"description": "Create or add one subscriber, with optional lists and tags. By default the subscriber must confirm opt-in by text. The customer must hold explicit written consent from every recipient before you use this tool (Clearstream terms, section 4G). Clearstream API: POST /v1/subscribers.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"mobile_number"
],
"properties": {
"last": {
"type": "string",
"description": "Last name."
},
"tags": {
"type": "array",
"items": {
"anyOf": [
{
"type": "string",
"pattern": "^[0-9]{1,20}$"
},
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
],
"description": "Tag id (from clearstream_list_tags)."
},
"description": "Tag ids to add to the subscriber."
},
"email": {
"type": "string",
"description": "Email address."
},
"first": {
"type": "string",
"description": "First name."
},
"lists": {
"type": "array",
"items": {
"anyOf": [
{
"type": "string",
"pattern": "^[0-9]{1,20}$"
},
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
],
"description": "List id (from clearstream_list_lists)."
},
"description": "List ids to add the subscriber to."
},
"double_optin": {
"type": "boolean",
"description": "Send a confirmation text before opt-in (default true)."
},
"mobile_number": {
"type": "string",
"pattern": "^\\+?[0-9(][0-9 ()\\-.]{3,24}$",
"description": "Mobile number, preferably E.164 format, for example +12005551000."
}
}
},
"annotations": {
"title": "Add a subscriber",
"readOnlyHint": false,
"destructiveHint": true
}
}Add one mobile number to a subscriber list. Locked lists cannot change. The customer must hold explicit written consent from every recipient before you use this tool (Clearstream terms, section 4G). Clearstream API: POST /v1/lists/{id}/subscribers.
| Parameter | Type | Description |
|---|---|---|
| list_id * | any | List id (from clearstream_list_lists). |
| mobile_number * | string | Mobile number, preferably E.164 format, for example +12005551000. |
{
"name": "clearstream_add_subscriber_to_list",
"title": "Add a subscriber to a list",
"description": "Add one mobile number to a subscriber list. Locked lists cannot change. The customer must hold explicit written consent from every recipient before you use this tool (Clearstream terms, section 4G). Clearstream API: POST /v1/lists/{id}/subscribers.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"list_id",
"mobile_number"
],
"properties": {
"list_id": {
"anyOf": [
{
"type": "string",
"pattern": "^[0-9]{1,20}$"
},
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
],
"description": "List id (from clearstream_list_lists)."
},
"mobile_number": {
"type": "string",
"pattern": "^\\+?[0-9(][0-9 ()\\-.]{3,24}$",
"description": "Mobile number, preferably E.164 format, for example +12005551000."
}
}
},
"annotations": {
"title": "Add a subscriber to a list",
"readOnlyHint": false,
"destructiveHint": true
}
}Remove one mobile number from a subscriber list. The subscriber's opt-in status does not change. Locked lists cannot change. Clearstream API: DELETE /v1/lists/{id}/subscribers/{number}.
| Parameter | Type | Description |
|---|---|---|
| list_id * | any | List id (from clearstream_list_lists). |
| mobile_number * | string | Mobile number in E.164 format, for example +12005551000. |
{
"name": "clearstream_remove_subscriber_from_list",
"title": "Remove a subscriber from a list",
"description": "Remove one mobile number from a subscriber list. The subscriber's opt-in status does not change. Locked lists cannot change. Clearstream API: DELETE /v1/lists/{id}/subscribers/{number}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"list_id",
"mobile_number"
],
"properties": {
"list_id": {
"anyOf": [
{
"type": "string",
"pattern": "^[0-9]{1,20}$"
},
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
],
"description": "List id (from clearstream_list_lists)."
},
"mobile_number": {
"type": "string",
"pattern": "^\\+?[0-9]{4,20}$",
"description": "Mobile number in E.164 format, for example +12005551000."
}
}
},
"annotations": {
"title": "Remove a subscriber from a list",
"readOnlyHint": false,
"destructiveHint": true
}
}Add a tag to up to 100 subscribers by mobile number. The customer must hold explicit written consent from every recipient before you use this tool (Clearstream terms, section 4G). Clearstream API: POST /v1/tags/{id}/subscribers.
| Parameter | Type | Description |
|---|---|---|
| tag_id * | any | Tag id (from clearstream_list_tags). |
| mobile_numbers * | array | Mobile numbers in E.164 format (1-100 per call). |
{
"name": "clearstream_tag_subscribers",
"title": "Tag subscribers",
"description": "Add a tag to up to 100 subscribers by mobile number. The customer must hold explicit written consent from every recipient before you use this tool (Clearstream terms, section 4G). Clearstream API: POST /v1/tags/{id}/subscribers.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"tag_id",
"mobile_numbers"
],
"properties": {
"tag_id": {
"anyOf": [
{
"type": "string",
"pattern": "^[0-9]{1,20}$"
},
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
],
"description": "Tag id (from clearstream_list_tags)."
},
"mobile_numbers": {
"type": "array",
"items": {
"type": "string",
"pattern": "^\\+?[0-9(][0-9 ()\\-.]{3,24}$",
"description": "Mobile number, preferably E.164 format, for example +12005551000."
},
"maxItems": 100,
"minItems": 1,
"description": "Mobile numbers in E.164 format (1-100 per call)."
}
}
},
"annotations": {
"title": "Tag subscribers",
"readOnlyHint": false,
"destructiveHint": true
}
}Tools for Clearstream, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "Which of our lists has the most subscribers, and how many are active for texting?"; "Show the text volume for last month, incoming and outgoing."; "Add the new volunteer at +12005551234 to the Volunteers list.". Read-only tools never change data; ask the user before a tool that creates, changes or deletes Clearstream data. Free plan: 50 tool calls per month. Run clearstream_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run clearstream_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run clearstream_upgrade without a plan: it returns both plans, each with a payment link for the user to open. clearstream_cancel_subscription cancels Pro at the end of the paid period.
Names, descriptions and schemas were written by the server and are shown as data.
Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators.