Skip to content
MCP server

Clearstream MCP by usefulapi

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

Install
Runs
Remotely
Version
1.4.0
Listing updated
4 days ago

About Clearstream MCP by usefulapi

Clearstream MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.

Install

Run in a terminal

claude mcp add --transport http clearstream https://clearstream.usefulapi.io/mcp

Add to Settings → Connectors → Add custom connector

https://clearstream.usefulapi.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "clearstream": {
      "url": "https://clearstream.usefulapi.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "clearstream": {
      "type": "http",
      "url": "https://clearstream.usefulapi.io/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "clearstream": {
      "serverUrl": "https://clearstream.usefulapi.io/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "clearstream": {
      "type": "http",
      "url": "https://clearstream.usefulapi.io/mcp"
    }
  }
}

Tools this server provides (15)

Read directly from the server.

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.
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.
clearstream_list_lists
List the subscriber lists (groups) in the account, with subscriber counts. Filter by name or locked state. Clearstream API: GET /v1/lists.
clearstream_get_list
Get one subscriber list: name, subscriber count, active texting subscriber count and sync status. Clearstream API: GET /v1/lists/{id}.
clearstream_list_subscribers_of_list
List the subscribers in one list, with optional name filters. Clearstream API: GET /v1/lists/{id}/subscribers.
clearstream_list_subscribers
Search the account's subscribers by name or mobile number. Clearstream API: GET /v1/subscribers.
clearstream_get_subscriber
Get one subscriber by mobile number: name, opt-in status, lists and tags. Clearstream API: GET /v1/subscribers/{number}.
clearstream_list_tags
List the subscriber tags in the account. Clearstream API: GET /v1/tags.
clearstream_list_texts
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.
clearstream_get_text_stats
Get text volume statistics for a date range (YYYY-MM-DD, inclusive). Clearstream API: GET /v1/stats/texts.
clearstream_send_text
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.
clearstream_add_subscriber
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.
clearstream_add_subscriber_to_list
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.
clearstream_remove_subscriber_from_list
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}.
clearstream_tag_subscribers
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.

Clearstream MCP by usefulapi FAQ

How do I add Clearstream MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http clearstream https://clearstream.usefulapi.io/mcp