English Français العربية

com.politicalcomms/api

Official registry Marketing and sales

Compliant political SMS/MMS from MCP clients: projects, contacts, analytics, billing.

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package @political-comms/mcp
Claude Code 
claude mcp add api -e 'POLITICAL_COMMS_API_KEY=<your political_comms_api_key>' -- npx -y @political-comms/mcp@0.2.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "api": {
            "command": "npx",
            "args": [
                "-y",
                "@political-comms/mcp@0.2.1"
            ],
            "env": {
                "POLITICAL_COMMS_API_KEY": "<your political_comms_api_key>"
            }
        }
    }
}

Environment variables

  • POLITICAL_COMMS_API_KEY required secret Political Comms API key (pc_live_*), created by a human operator in the dashboard under Admin > API Keys

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Political Comms SDK
  2. Packages
  3. Authentication
  4. Development
  5. License

Political Comms SDK

Official client libraries and tools for the Political Comms REST API. Direct-to-carrier political texting for campaigns, PACs, advocacy organizations, fundraisers, and elected officials.

The API surface covers Projects (compose, test, schedule, send), Contact Lists, Media Files, Organizations and hierarchy, Brands, Campaigns, Tracking Domains, Phone Numbers, Analytics, Billing, and Email (sending domains, sender identities, lists and imports, suppressions, templates and AI drafts, and campaigns). The full OpenAPI 3.1 specification lives at politicalcomms.com/openapi.json and the reference documentation at docs.politicalcomms.com.

Packages

PackageRegistryDescription
@political-comms/sdknpmTypeScript SDK. Zero dependencies, native fetch, built-in retries.
@political-comms/clinpmCommand line interface. npx @political-comms/cli auth check
@political-comms/mcpnpmMCP server for Claude and other MCP clients.
political-commsPyPIPython SDK mirroring the TypeScript client.

Authentication

Every client authenticates with an API key passed in the X-API-Key header. Keys are created in the dashboard under Admin > API and are prefixed pc_live_. All packages read the POLITICAL_COMMS_API_KEY environment variable by default.

Development

Node 20 or later and Python 3.10 or later.

npm install
npm run build
npm test

cd python
python3 -m venv .venv
.venv/bin/pip install -e '.[dev]'
.venv/bin/pytest

License

MIT. See LICENSE.

Frequently asked questions

What is com.politicalcomms/api?

Compliant political SMS/MMS from MCP clients: projects, contacts, analytics, billing.

How do I install com.politicalcomms/api?

It runs on your machine. In Claude Code: claude mcp add api -e 'POLITICAL_COMMS_API_KEY=<your political_comms_api_key>' -- npx -y @political-comms/mcp@0.2.1. For other clients, paste the JSON configuration from this page into their MCP settings.

Does com.politicalcomms/api need an API key?

Yes. It expects POLITICAL_COMMS_API_KEY, which you set in its configuration.

Is com.politicalcomms/api open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains com.politicalcomms/api?

It is published by Political-Comms. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.