Clearstream MCP by usefulapi
Read lists, subscribers, tags and texts; send texts and change subscribers in Clearstream.
我該用這個嗎
品質與安全性
發現項目（3）
- LOWTool 'clearstream_list_subscribers_of_list' name length outside 3-30 range在 clearstream_list_subscribers_of_list 中
- LOWTool 'clearstream_add_subscriber_to_list' name length outside 3-30 range在 clearstream_add_subscriber_to_list 中
- LOWTool 'clearstream_remove_subscriber_from_list' name length outside 3-30 range在 clearstream_remove_subscriber_from_list 中
根據工具定義與協定合規性的自動化分析。
上下文成本
這是每次將伺服器的工具載入模型上下文時所消耗的約略 token 數量。數量越高，可用於其他工作的注意力就越少。
安裝
一鍵安裝
將以下內容加入你的 `claude_desktop_config.json` 檔案：
{
"mcpServers": {
"clearstream": {
"url": "https://clearstream.usefulapi.io/mcp"
}
}
}遠端端點
https://clearstream.usefulapi.io/mcpstreamable-http它能做什麼
工具清單
工具（15）
🟢clearstream_get_account
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.
輸入結構描述
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢clearstream_list_numbers
List the shortcodes and longcodes this account can send texts from, and which one is the default. Clearstream API: GET /v1/numbers.
輸入結構描述
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢clearstream_list_lists(name, locked, limit, page)
List the subscriber lists (groups) in the account, with subscriber counts. Filter by name or locked state. Clearstream API: GET /v1/lists.
輸入結構描述
{
"type": "object",
"properties": {
"name": {
"description": "Partial match on the list name.",
"type": "string"
},
"locked": {
"description": "Filter by locked state (default any).",
"type": "string",
"enum": [
"locked",
"not_locked",
"any"
]
},
"limit": {
"description": "Results per page (1-100).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢clearstream_get_list(list_id)
Get one subscriber list: name, subscriber count, active texting subscriber count and sync status. Clearstream API: GET /v1/lists/{id}.
輸入結構描述
{
"type": "object",
"properties": {
"list_id": {
"anyOf": [
{
"type": "string",
"pattern": "^[0-9]{1,20}$"
},
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
],
"description": "List id (from clearstream_list_lists)."
}
},
"required": [
"list_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢clearstream_list_subscribers_of_list(list_id, full_name, first, limit, page)
List the subscribers in one list, with optional name filters. Clearstream API: GET /v1/lists/{id}/subscribers.
輸入結構描述
{
"type": "object",
"properties": {
"list_id": {
"anyOf": [
{
"type": "string",
"pattern": "^[0-9]{1,20}$"
},
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
],
"description": "List id (from clearstream_list_lists)."
},
"full_name": {
"description": "Partial match on the full name.",
"type": "string"
},
"first": {
"description": "Partial match on the first name.",
"type": "string"
},
"limit": {
"description": "Results per page (1-100).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"list_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢clearstream_list_subscribers(full_name, first, last, mobile_number, limit, ...)
Search the account's subscribers by name or mobile number. Clearstream API: GET /v1/subscribers.
輸入結構描述
{
"type": "object",
"properties": {
"full_name": {
"description": "Partial match on the full name.",
"type": "string"
},
"first": {
"description": "Partial match on the first name.",
"type": "string"
},
"last": {
"description": "Partial match on the last name.",
"type": "string"
},
"mobile_number": {
"description": "Exact match on the mobile number.",
"type": "string"
},
"limit": {
"description": "Results per page (default 20).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢clearstream_get_subscriber(mobile_number)
Get one subscriber by mobile number: name, opt-in status, lists and tags. Clearstream API: GET /v1/subscribers/{number}.
輸入結構描述
{
"type": "object",
"properties": {
"mobile_number": {
"type": "string",
"pattern": "^\\+?[0-9]{4,20}$",
"description": "Mobile number in E.164 format, for example +12005551000."
}
},
"required": [
"mobile_number"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢clearstream_list_tags
List the subscriber tags in the account. Clearstream API: GET /v1/tags.
輸入結構描述
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢clearstream_list_texts(direction, mobile_number, limit, cursor)
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.
輸入結構描述
{
"type": "object",
"properties": {
"direction": {
"description": "IN for incoming, OUT for outgoing.",
"type": "string",
"enum": [
"IN",
"OUT"
]
},
"mobile_number": {
"description": "Exact match on the contact's mobile number.",
"type": "string"
},
"limit": {
"description": "Results per page (1-100).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
},
"cursor": {
"description": "Pagination cursor from a previous reply.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢clearstream_get_text_stats(start, end, timezone)
Get text volume statistics for a date range (YYYY-MM-DD, inclusive). Clearstream API: GET /v1/stats/texts.
輸入結構描述
{
"type": "object",
"properties": {
"start": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Start date (YYYY-MM-DD)."
},
"end": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "End date (YYYY-MM-DD)."
},
"timezone": {
"description": "IANA timezone for the statistics (default UTC).",
"type": "string"
}
},
"required": [
"start",
"end"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴clearstream_send_text(to, text_body, text_header, from, use_default_header, ...)
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.
輸入結構描述
{
"type": "object",
"properties": {
"to": {
"anyOf": [
{
"type": "string",
"pattern": "^\\+?[0-9(][0-9 ()\\-.]{3,24}$",
"description": "Mobile number, preferably E.164 format, for example +12005551000."
},
{
"minItems": 1,
"maxItems": 100,
"type": "array",
"items": {
"type": "string",
"pattern": "^\\+?[0-9(][0-9 ()\\-.]{3,24}$",
"description": "Mobile number, preferably E.164 format, for example +12005551000."
},
"description": "Mobile numbers in E.164 format (1-100 per call)."
}
],
"description": "One mobile number, or an array of up to 100 numbers."
},
"text_body": {
"type": "string",
"minLength": 1,
"description": "The message text. Header and body together must fit the character limit."
},
"text_header": {
"description": "Sender name shown before the text, for example the organization name. GSM 7-bit characters only.",
"type": "string"
},
"from": {
"description": "A sending number from clearstream_list_numbers (default: the account shortcode).",
"type": "string"
},
"use_default_header": {
"description": "Use the account default header instead of text_header.",
"type": "boolean"
},
"media_url": {
"description": "Optional JPG or PNG image URL under 5 MB (MMS must be enabled).",
"type": "string",
"format": "uri"
}
},
"required": [
"to",
"text_body"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴clearstream_add_subscriber(mobile_number, first, last, email, lists, ...)
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.
輸入結構描述
{
"type": "object",
"properties": {
"mobile_number": {
"type": "string",
"pattern": "^\\+?[0-9(][0-9 ()\\-.]{3,24}$",
"description": "Mobile number, preferably E.164 format, for example +12005551000."
},
"first": {
"description": "First name.",
"type": "string"
},
"last": {
"description": "Last name.",
"type": "string"
},
"email": {
"description": "Email address.",
"type": "string"
},
"lists": {
"description": "List ids to add the subscriber to.",
"type": "array",
"items": {
"anyOf": [
{
"type": "string",
"pattern": "^[0-9]{1,20}$"
},
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
],
"description": "List id (from clearstream_list_lists)."
}
},
"tags": {
"description": "Tag ids to add to the subscriber.",
"type": "array",
"items": {
"anyOf": [
{
"type": "string",
"pattern": "^[0-9]{1,20}$"
},
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
],
"description": "Tag id (from clearstream_list_tags)."
}
},
"double_optin": {
"description": "Send a confirmation text before opt-in (default true).",
"type": "boolean"
}
},
"required": [
"mobile_number"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴clearstream_add_subscriber_to_list(list_id, mobile_number)
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.
輸入結構描述
{
"type": "object",
"properties": {
"list_id": {
"anyOf": [
{
"type": "string",
"pattern": "^[0-9]{1,20}$"
},
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
],
"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."
}
},
"required": [
"list_id",
"mobile_number"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴clearstream_remove_subscriber_from_list(list_id, mobile_number)
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}.
輸入結構描述
{
"type": "object",
"properties": {
"list_id": {
"anyOf": [
{
"type": "string",
"pattern": "^[0-9]{1,20}$"
},
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
],
"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."
}
},
"required": [
"list_id",
"mobile_number"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴clearstream_tag_subscribers(tag_id, mobile_numbers)
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.
輸入結構描述
{
"type": "object",
"properties": {
"tag_id": {
"anyOf": [
{
"type": "string",
"pattern": "^[0-9]{1,20}$"
},
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
],
"description": "Tag id (from clearstream_list_tags)."
},
"mobile_numbers": {
"minItems": 1,
"maxItems": 100,
"type": "array",
"items": {
"type": "string",
"pattern": "^\\+?[0-9(][0-9 ()\\-.]{3,24}$",
"description": "Mobile number, preferably E.164 format, for example +12005551000."
},
"description": "Mobile numbers in E.164 format (1-100 per call)."
}
},
"required": [
"tag_id",
"mobile_numbers"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}社群
證據