politicalcomms

@political-comms/mcp

Political Comms REST API 用の MCP（Model Context Protocol）サーバーです。Claude やその他の MCP クライアントから、組織、プロジェクト、連絡先リスト、分析、請求情報を確認できるほか、米国の規制に準拠した政治関連の SMS や MMS の送信を作成、テスト、予約できます。

stdio 経由で動作します。Node 20 以降と Political Comms API キーが必要です（ダッシュボードの Admin > API で作成でき、pc_live_ が接頭辞です）。

セットアップ

Claude Code

claude mcp add political-comms \
  --env POLITICAL_COMMS_API_KEY=pc_live_... \
  -- npx -y @political-comms/mcp

Claude Desktop

claude_desktop_config.json に追加します：

{
  "mcpServers": {
    "political-comms": {
      "command": "npx",
      "args": ["-y", "@political-comms/mcp"],
      "env": {
        "POLITICAL_COMMS_API_KEY": "pc_live_..."
      }
    }
  }
}

ツール

読み取り専用：

ツール	説明
list_organizations	API キーから表示できる組織を一覧表示します。認証情報の確認にも使用できます。
get_hierarchy	ブランドを含む組織階層の完全なツリーを取得します。
list_projects	メッセージングプロジェクトを一覧表示します。組織、ブランド、キャンペーンで絞り込めます。
get_project	1 つのプロジェクトの完全な設定を取得します。
get_project_stats	1 つのプロジェクトの配信およびエンゲージメント統計を取得します。
get_project_throughput	1 つのプロジェクトのキャリア制限に基づく見積もりを取得します。T-Mobile の 1 日あたりの上限で一時停止するか、完了までにどれくらいかかるかを確認できます。
get_campaign_throughput	キャンペーンの T-Mobile の 1 日あたりの上限と本日の使用量、および AT&T の 1 分あたりの送信レートを取得します。
list_contact_lists	連絡先リストを件数とステータスとともに一覧表示します。
get_contact_list	1 つの連絡先リストについて、インポートの進捗状況、分析、downloads URL を取得します。
download_contact_list	連絡先リストを CSV テキストとして取得します（type は original または analyzed）。最大 100,000 文字で切り詰められます。
get_message_stats	指定した期間のメッセージ統計を集計して取得します。
get_ledger_usage	指定した期間の請求使用量を取得します。
list_conversations	インバウンドメッセージが 1 件以上ある会話を、最後のインバウンドメッセージが新しい順に一覧表示します。
get_conversation	1 つの会話のステータス、連絡先、メッセージ件数、最終アクティビティを取得します。
list_conversation_messages	1 つの会話のメッセージを新しい順に一覧表示します。
list_email_domains	メール送信ドメインと DNS 検証ステータスを一覧表示します。
get_email_domain	公開が必要な DNS レコードを含む、1 つの送信ドメインの情報を取得します。
list_email_senders	メール送信者の ID（From アドレス）を一覧表示します。
list_email_lists	メールリストを連絡先件数とステータスとともに一覧表示します。
list_email_suppressions	組織、ID、またはリストのスコープで抑制されているアドレスを一覧表示します。
list_email_campaigns	メールキャンペーンをステータスと対象者数とともに一覧表示します。
get_email_campaign	予約できない理由を示す blocked を含む、1 つのキャンペーンの情報を取得します。
get_email_campaign_stats	レポートタイルとリンクごとのクリック数を取得します。
list_email_templates	件名と最終更新時刻を含む、保存済みメールテンプレートを一覧表示します。
get_email_template	HTML 本文全体を含む、1 つのテンプレートの情報を取得します。

書き込み（すべて読み取り専用ではないと注記されています。create_project、test_project、schedule_project、reply_to_conversation は、実際のメッセージを準備または送信するため、さらに confirm: true が必要です）：

ツール	説明
create_project	メッセージングプロジェクトの下書きを作成します。
test_project	指定した電話番号に実際のテストメッセージを送信します。
schedule_project	指定した日時に一括送信を確定します。
unschedule_project	プロジェクトの予約を解除します。
pause_project	実行中または予約済みの送信を一時停止します。schedule_project で再開できます。
copy_project	プロジェクトを新しい下書きにコピーします（リスト、予約、統計は引き継がれません）。
reply_to_conversation	既存の会話内で実際の SMS 返信を送信します。confirm: true が必要です。
schedule_email_campaign	メール送信を確定します。confirm: true が必要です。
unschedule_email_campaign	予約済みキャンペーンを下書き状態に戻します。
start_email_list_import	連絡先の CSV をメールリストにインポートします。confirm: true が必要です。

このサーバーでは意図的に削除操作を公開していません。

メールツール

メールの書き込みツールには、組織にメールのエンタイトルメントが必要です。エンタイトルメントがない場合は、403 ENTITLEMENT_REQUIRED が返されます。読み取りは公開されています。有料のメールワークフローや人間が操作するメールワークフロー（AI による下書き作成、結果のエクスポート）、および配信可能性のトリアージ（進行中の送信の一時停止と再開）は、ツールではなくダッシュボードの機能です。これらは費用がかかるか、送信中に人間が監視する必要があるためです。受信メールや受信トレイの機能はありません。

エラー

API エラーは、機械可読コードと復旧のヒントを含むツールエラーとして返されます。レート制限されたリクエスト（キーごとに毎分 600 リクエスト）には、待機時間を示す X-RateLimit-Reset が記載されます。認証エラーでは、人間がダッシュボードでキーを作成する必要があることが説明されます。

API の完全なリファレンス：docs.politicalcomms.com。OpenAPI 仕様：politicalcomms.com/openapi.json。

ライセンス

MIT。お問い合わせ：[email protected]