Clearstream MCP by usefulapi

Read lists, subscribers, tags and texts; send texts and change subscribers in Clearstream.

我该使用它吗

质量与安全性

A
描述质量
100%
模式完整度
80%
命名质量
76%
投毒风险
100%
权限匹配度
100%
协议合规性
100%

发现(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 中

基于对工具定义和协议合规性的自动分析。

上下文开销

~2,998token 数(工具定义)
~1.4 KB典型响应大小
对注意力有显著影响(占 128k 上下文窗口的 2.34%)

这是每次将服务器的工具加载到模型上下文窗口时所消耗的大致 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"
}

社区

评价此服务器

证据

最近观测

已验证未记录版本15 个工具