About Postcard Examples
Postcard Examples is an MCP server in the Search category: code examples for the Postcard.bot REST API — send real printed postcards from Node.js, Python, and cURL.
Install
From source
git clone https://github.com/PostcardBot/postcard-examplesThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
✦
Ask AI about Postcard Examples
Powered by Claude · Grounded in docs
I know everything about Postcard Examples. Ask me about installation, configuration, usage, or troubleshooting.
Security checks
- ✓README presentThe repository ships documentation.
5 checks have not been run yet.
README
Postcard.bot API Examples
Ready-to-run code examples for the Postcard.bot REST API. Send real, printed postcards programmatically.
Quick Start
- Get an API key at postcard.bot/account
- Add balance at postcard.bot/buy-credits
- Pick an example below and run it
Examples
Node.js
| File | Description |
|---|---|
| send-postcard.js | Send a single postcard |
| bulk-send.js | Send postcards to a CSV list of recipients |
| check-status.js | Check postcard delivery status |
| webhooks-server.js | Receive and verify webhook events |
cd node
npm install
POSTCARDBOT_API_KEY=pk_live_your_key node send-postcard.js
Python
| File | Description |
|---|---|
| send_postcard.py | Send a single postcard |
| bulk_send.py | Send postcards to a CSV list of recipients |
| check_status.py | Check postcard delivery status |
| webhooks_server.py | Receive and verify webhook events |
cd python
pip install requests flask
POSTCARDBOT_API_KEY=pk_live_your_key python send_postcard.py
cURL
| File | Description |
|---|---|
| send-postcard.sh | Send a single postcard |
| bulk-send.sh | Send bulk postcards |
| check-balance.sh | Check account balance and pricing tier |
| webhooks.sh | Create, list, and delete webhooks |
cd curl
export POSTCARDBOT_API_KEY=pk_live_your_key
bash send-postcard.sh
API Reference
- Developer Docs — full API reference, MCP server setup, pricing
- OpenAPI Spec — import into Postman, Swagger UI, or any API client
- MCP Server — let AI agents send postcards via Claude, Cursor, etc.
Pricing
Volume pricing based on lifetime top-up amount:
| Tier | Lifetime top-up | USA | International |
|---|---|---|---|
| Pay-as-you-go | $0 | $1.99 | $2.99 |
| Starter | $1+ | $1.49 | $2.49 |
| Bronze | $20+ | $1.29 | $2.29 |
| Silver | $50+ | $0.99 | $1.99 |
| Gold | $200+ | $0.85 | $1.85 |
| Platinum | $500+ | $0.79 | $1.79 |
| Diamond | $1,000+ | $0.69 | $1.69 |
All-inclusive: printing + postage + delivery. No subscription.
License
MIT
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.