Каталог MCP
PostcardBot/mcp-server

PostcardBot/mcp-server

Name: PostcardBot/mcp-server
Availability: InStock
Author: postcardbot

MCP-сервер Postcard.bot для отправки физических открыток по всему миру напрямую из кода. Полезен разработчикам AI-агентов и интеграций — позволяет отправлять реальные открытки через Claude, Cursor ...

Github NPM Сайт сервера

README

8 инструментов

Версии

Установить сервер

@postcardbot/mcp-server

Send real postcards from code. MCP server for Postcard.bot — let AI agents send physical postcards worldwide.

Works with Claude Desktop, Claude Code, Cursor, Windsurf, and any MCP-compatible client.

Hosted Server (Recommended)

The easiest way to get started — no API key needed, no local install. Just add the URL and sign in with your Postcard.bot account:

https://postcard.bot/api/mcp

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "postcardbot": {
      "url": "https://postcard.bot/api/mcp"
    }
  }
}

Claude Code:

claude mcp add --transport http postcardbot https://postcard.bot/api/mcp

Your MCP client will open a browser for you to sign in with Google or email. Click "Allow" and you're ready to send postcards.

Local Server (npm)

If you prefer running the server locally with an API key:

1. Get an API key

2. Add balance

Инструменты были проиндексированы: 15.10.2026

bulk_send

Отправляет одну и ту же открытку нескольким получателям (асинхронно). Одинаковые сообщение, изображение и обратный адрес для всех открыток - различаются только адреса получателей. До 5 000 получателей на один запрос. Общая стоимость резервируется заранее; за неудавшиеся открытки автоматически возвращаются деньги. Возвращает bulk_id немедленно - открытки обрабатываются фоновыми пакетами. Используйте check_status с bulk_id для опроса хода выполнения.

Параметры

fromobjectобязательный
Адрес отправителя (обратный адрес): одинаков для всех открыток.
image_urlstringобязательный
URL изображения для лицевой стороны каждой открытки. Должен быть публично доступным HTTPS URL. Рекомендуемое минимальное разрешение: 1875x1275 пикселей.
messagestringобязательный
Текст сообщения на обороте каждой открытки (не более 350 символов)
recipientsobject[]обязательный
Массив адресов получателей (максимум 5 000)

check_balance

Проверяет баланс счета, общую сумму пополнений за всё время и текущий уровень ценообразования в зависимости от объема. Используйте это перед отправкой, чтобы узнать стоимость одной открытки и доступные средства.

Параметры

Без параметров.

check_status

Проверяет статус доставки ранее отправленной открытки. Возвращает текущий статус, информацию об отслеживании доставки и ожидаемую дату доставки.

Параметры

postcard_idstringобязательный
Идентификатор открытки, возвращаемый send_postcard

create_webhook

Регистрирует URL вебхука для получения уведомлений о событиях открыток (отправлено, доставлено, не доставлено, возвращено). События подписываются с помощью HMAC-SHA256. Секрет подписи возвращается только один раз - сохраните его надёжно. URL должен использовать HTTPS. Максимум 10 вебхуков на аккаунт.

Параметры

eventsstring[]обязательный
Типы событий для подписки: postcard.created, postcard.sent, postcard.delivered, postcard.failed, postcard.returned
urlstringобязательный
HTTPS URL для приёма webhook POST запросов

delete_webhook

Удаляет зарегистрированный вебхук по его ID.

Параметры

webhook_idstringобязательный
Идентификатор webhook (wh_...)

get_pricing

Получает ценовые уровни для открыток на основе суммы пожизненного пополнения. USA от $1.99 (сумма менее $50) до $0.69 ($5000 и более), International от $2.99 до $1.99.

Параметры

Без параметров.

list_webhooks

Выводит список всех зарегистрированных вебхуков для вашего аккаунта. Вебхуки отправляют уведомления в реальном времени на ваш URL при наступлении событий, связанных с открытками.

Параметры

Без параметров.

send_postcard

Отправляет физическую открытку, которая будет напечатана и доставлена на реальный адрес. Доставка занимает 5-10 рабочих дней. Цена зависит от тарифного уровня на основе пополнения за все время (от $0.69-$1.99 США, $1.99-$2.99 международная). Средства списываются с предоплаченного баланса Postcard.bot пользователя. Используйте check_balance, чтобы узнать текущий тарифный уровень перед отправкой. Требует URL изображения (общедоступный) и сообщение (макс. 350 символов).

Параметры

fromobjectобязательный
Адрес отправителя (обратный адрес)
image_urlstringобязательный
URL изображения для лицевой стороны открытки. Должен быть публично доступным HTTPS URL. Рекомендуемое минимальное разрешение: 1875x1275 пикселей.
messagestringобязательный
Текст сообщения для обратной стороны открытки (максимум 350 символов)
toobjectобязательный
Адрес получателя (почтовый)

`1.2.0`основная	10.03.2026
`1.1.1`	08.03.2026
`1.1.0`	08.03.2026
`1.0.0`	08.03.2026

Выберите клиент, чтобы установить PostcardBot/mcp-server:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "postcardbot-mcp-server-fo2f0kbvv5": {
      "command": "npx",
      "args": [
        "-y",
        "@postcardbot/mcp-server"
      ],
      "env": {
        "POSTCARDBOT_API_KEY": "pk_live_your_key_here"
      }
    }
  }
}

Cursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "postcardbot-mcp-server-fo2f0kbvv5": {
      "command": "npx",
      "args": [
        "-y",
        "@postcardbot/mcp-server"
      ],
      "env": {
        "POSTCARDBOT_API_KEY": "pk_live_your_key_here"
      }
    }
  }
}

VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "postcardbot-mcp-server-fo2f0kbvv5": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@postcardbot/mcp-server"
      ],
      "env": {
        "POSTCARDBOT_API_KEY": "pk_live_your_key_here"
      }
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"postcardbot-mcp-server-fo2f0kbvv5\",\"type\":\"stdio\",\"command\":\"npx\",\"args\":[\"-y\",\"@postcardbot/mcp-server\"],\"env\":{\"POSTCARDBOT_API_KEY\":\"pk_live_your_key_here\"}}"

Claude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "postcardbot-mcp-server-fo2f0kbvv5": {
      "command": "npx",
      "args": [
        "-y",
        "@postcardbot/mcp-server"
      ],
      "env": {
        "POSTCARDBOT_API_KEY": "pk_live_your_key_here"
      }
    }
  }
}

Claude Code

Добавьте сервер одной командой в терминале:

claude mcp add postcardbot-mcp-server-fo2f0kbvv5 --env POSTCARDBOT_API_KEY=pk_live_your_key_here -- npx -y @postcardbot/mcp-server

Либо через JSON-конфиг:

claude mcp add-json postcardbot-mcp-server-fo2f0kbvv5 "{\"command\":\"npx\",\"args\":[\"-y\",\"@postcardbot/mcp-server\"],\"env\":{\"POSTCARDBOT_API_KEY\":\"pk_live_your_key_here\"}}"

Codex

Добавьте сервер командой в терминале:

codex mcp add postcardbot-mcp-server-fo2f0kbvv5 --env POSTCARDBOT_API_KEY=pk_live_your_key_here -- npx -y @postcardbot/mcp-server

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.postcardbot-mcp-server-fo2f0kbvv5]
command = "npx"
args = ["-y", "@postcardbot/mcp-server"]

[mcp_servers.postcardbot-mcp-server-fo2f0kbvv5.env]
POSTCARDBOT_API_KEY = "pk_live_your_key_here"

Perplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

Откройте Настройки аккаунта → Connectors.
Установите вспомогательное приложение PerplexityXPC (один раз).
Нажмите Add Connector → вкладка Simple.
В поле Server Name укажите PostcardBot/mcp-server, а в поле команды запуска — строку ниже:

npx -y @postcardbot/mcp-server

Нажмите Save и дождитесь статуса Running.

Windsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "postcardbot-mcp-server-fo2f0kbvv5": {
      "command": "npx",
      "args": [
        "-y",
        "@postcardbot/mcp-server"
      ],
      "env": {
        "POSTCARDBOT_API_KEY": "pk_live_your_key_here"
      }
    }
  }
}

Cline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "postcardbot-mcp-server-fo2f0kbvv5": {
      "command": "npx",
      "args": [
        "-y",
        "@postcardbot/mcp-server"
      ],
      "env": {
        "POSTCARDBOT_API_KEY": "pk_live_your_key_here"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Continue

Создайте файл в .continue/mcpServers/ (например postcardbot-mcp-server-fo2f0kbvv5.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: postcardbot-mcp-server-fo2f0kbvv5
    command: npx
    args:
      - "-y"
      - "@postcardbot/mcp-server"
    env:
      POSTCARDBOT_API_KEY: pk_live_your_key_here

Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "postcardbot-mcp-server-fo2f0kbvv5": {
      "command": "npx",
      "args": [
        "-y",
        "@postcardbot/mcp-server"
      ],
      "env": {
        "POSTCARDBOT_API_KEY": "pk_live_your_key_here"
      }
    }
  }
}

Конфиг для установки сервера

{
  "command": "npx",
  "args": [
    "-y",
    "@postcardbot/mcp-server"
  ],
  "env": {
    "POSTCARDBOT_API_KEY": "pk_live_your_key_here"
  }
}

Нужен npx

Сервер запускается через npx
Без него ничего работать не будет.

Как установить npx

Информация о сервере

Номер в рейтинге: #197
Звезд на Github: 5
Форков на Github: 1
Загрузок: 338
Язык реализации: TypeScript
Лицензия: MIT
Официальный сервер: Нет
Дата обновления данных: 19.10 в 08:07
Идентификатор: hOGGZ9wZHYYGFfah
Категории: Автоматизация приложений

PostcardBot/mcp-server

@postcardbot/mcp-server

Hosted Server (Recommended)

Local Server (npm)

1. Get an API key

2. Add balance

Похожие MCP-сервера

arbengine/mailbox-mcp

boldsign/boldsign-mcp

offorte/offorte-mcp-server

ahujasid/blender-mcp

jtalk22/slack-mcp-server

Prototypr/feedbagel-mcp