# api

MCP-сервер для REST API Political Comms: смотрит организации, проекты, контакты, аналитику и счета, а также создаёт и планирует SMS/MMS по США.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Автор: Political-Comms
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/Political-Comms/political-comms-sdk/tree/HEAD/packages/mcp
- Обновлён: 2026-10-14
- HTML: https://affpapa.org/nevibecode/mcp/api

## Что делает

Сервер работает через stdio и отдаёт агенту набор инструментов над REST API Political Comms. Читающие инструменты показывают организации, дерево иерархии с брендами, проекты и их настройки, статистику доставки, оценку пропускной способности по лимитам оператора, контактные списки с прогрессом импорта и CSV, агрегированную статистику сообщений, расходы по счёту, входящие диалоги и письма с кампаниями, доменами и шаблонами.

Пишущие инструменты создают черновик проекта, отправляют тестовые сообщения на указанные номера, ставят массовую рассылку на конкретные дату и время, снимают её с расписания, ставят на паузу и копируют проект в новый черновик. Отправка теста, постановка в расписание, ответ в диалоге и планирование письма требуют `confirm: true`. Постоянное поведение: операций удаления сервер не даёт.

Понадобится Node 20 или новее и ключ API с префиксом `pc_live_`, который человек создаёт в дашборде в разделе Admin > API. Адрес подсказывает, что это боевой ключ: черновики можно готовить спокойно, а тестовая отправка и расписание сразу бьют по реальным номерам. Инструменты для писем на запись работают, только если у организации есть соответствующая лицензия, иначе ответ `403 ENTITLEMENT_REQUIRED`. Лимит запросов — 600 в минуту на ключ; при упоре в него сервер называет код и время ожидания из `X-RateLimit-Reset`.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `POLITICAL_COMMS_API_KEY` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add api -e POLITICAL_COMMS_API_KEY=<POLITICAL_COMMS_API_KEY> -- npx -y @political-comms/mcp
```
Вместо <…> подставьте свои значения

### Codex

**Командой платформы**
```bash
codex mcp add mcp --env POLITICAL_COMMS_API_KEY=<POLITICAL_COMMS_API_KEY> -- npx -y @political-comms/mcp
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@political-comms/mcp"
            ],
            "env": {
                "POLITICAL_COMMS_API_KEY": "<POLITICAL_COMMS_API_KEY>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@political-comms/mcp"
            ],
            "env": {
                "POLITICAL_COMMS_API_KEY": "<POLITICAL_COMMS_API_KEY>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e POLITICAL_COMMS_API_KEY=<POLITICAL_COMMS_API_KEY> mcp npx -y @political-comms/mcp
```
Вместо <…> подставьте свои значения

## Когда брать
- посмотреть, какие проекты и бренды видны ключу
- оценить, упрётся ли рассылка в дневной лимит T-Mobile
- скачать контактный список в CSV для проверки
- создать черновик проекта и отправить тестовое SMS
- поставить массовую рассылку на конкретные дату и время

## Примеры запросов агенту
- Покажи диалоги, где есть входящие сообщения, и последнее в каждом
- Создай черновик проекта для кампании и отправь тест на мой номер
- Проверь пропускную способность проекта: не встанет ли он на дневном лимите

## Похожие
- [Scrapling MCP Server](https://affpapa.org/nevibecode/mcp/scrapling-mcp-server.md) — MCP-сервер · ★ 89899
- [browser-use](https://affpapa.org/nevibecode/mcp/browser-use.md) — MCP-сервер · ★ 119231
- [AIHawk](https://affpapa.org/nevibecode/mcp/aihawk.md) — MCP-сервер · ★ 32260
- [Skyvern](https://affpapa.org/nevibecode/mcp/skyvern.md) — MCP-сервер · ★ 23283
- [SeleniumBase MCP](https://affpapa.org/nevibecode/mcp/seleniumbase-mcp.md) — MCP-сервер · ★ 13181
- [Inbox Zero](https://affpapa.org/nevibecode/mcp/inbox-zero.md) — MCP-сервер · ★ 12826

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md