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 rangeclearstream_list_subscribers_of_list에서
- LOWTool 'clearstream_add_subscriber_to_list' name length outside 3-30 rangeclearstream_add_subscriber_to_list에서
- LOWTool 'clearstream_remove_subscriber_from_list' name length outside 3-30 rangeclearstream_remove_subscriber_from_list에서
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`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"
}커뮤니티
증거