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

PostcardBot/mcp-server

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

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

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

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

bulk_send

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

Параметры

fromobjectобязательный
Sender (return) address — same for all postcards
image_urlstringобязательный
URL of the image for the front of every postcard. Must be publicly accessible HTTPS URL. Recommended minimum resolution: 1875x1275 pixels.
messagestringобязательный
Message text for the back of every postcard (max 350 characters)
recipientsobject[]обязательный
Array of recipient addresses (max 5,000)

check_balance

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

Параметры

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

check_status

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

Параметры

postcard_idstringобязательный
The postcard ID returned from send_postcard

create_webhook

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

Параметры

eventsstring[]обязательный
Event types to subscribe to: postcard.created, postcard.sent, postcard.delivered, postcard.failed, postcard.returned
urlstringобязательный
HTTPS URL to receive webhook POST requests

delete_webhook

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

Параметры

webhook_idstringобязательный
The webhook ID (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обязательный
Sender (return) address
image_urlstringобязательный
URL of the image for the front of the postcard. Must be a publicly accessible HTTPS URL. Recommended minimum resolution: 1875x1275 pixels.
messagestringобязательный
Message text for the back of the postcard (max 350 characters)
toobjectобязательный
Recipient (mailing) address

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

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

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

Нужен npx

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

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

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

Номер в рейтинге: #198
Звезд на Github: 5
Форков на Github: 1
Загрузок: 501
Язык реализации: TypeScript
Лицензия: MIT
Официальный сервер: Нет
Дата обновления данных: 09.09 в 21:18
Идентификатор: hOGGZ9wZHYYGFfah
Категории: Коммуникации, Обработка изображений и видео, Финансы

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

chaindead/telegram-mcp

Telegram MCP сервер подключает AI-ассистентов к вашему аккаунту: чтение диалогов, отправка сообщений, отслеживание уведомлений. Работает с Claude, Cursor. Упрощает управление перепиской и автоматизацию ответов.

twilio-labs/mcp

MCP сервер для всех публичных Twilio API - SMS, звонки, уведомления. AI-инструменты управляют Twilio напрямую через MCP. Полезен разработчикам для автоматизации общения.

carterlasalle/mac_messages_mcp

MCP-сервер для управления iMessage и SMS на macOS: отправляет сообщения с умным выбором доставки, читает переписку и ищет вложения. Полезен для разработчиков и автоматизации мессенджеров.

gabrielmahia/mpesa-mcp

MCP сервер для африканских платежных API: запускайте платежи M-Pesa, проверяйте статусы, отправляйте SMS и пополняйте воздух через 20+ сетей. Полезен разработчикам AI-агентов для финансовых операций в Восточной Африке.

nanana-app/mcp-server-nano-banana

MCP-сервер для генерации и трансформации изображений через Nanana AI с моделью Google Gemini nano banana. Позволяет Claude Desktop создавать картинки по тексту и редактировать существующие. Полезен...

ExpertVagabond/solmail-mcp

MCP сервер solmail позволяет AI-агентам отправлять физические письма и открытки в 200+ стран с оплатой в Solana. Использует Lob.com, некастодиальный кошелек, работает на devnet и mainnet. Полезен разработчикам, внедряющим крипто-почту в агентов.