Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@PostcardAI MCP ServerSend a thank you postcard to Jane Doe at 456 Elm St, NY 10001"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
PostcardAI MCP Server
Model Context Protocol server for PostcardAI. Use PostcardAI with Claude, Cursor, and other AI assistants.
Quick Start
1. Install & Authenticate
This opens your browser to authenticate and stores credentials securely.
2. Configure Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
3. Restart Claude Desktop
That's it! Ask Claude to send postcards.
Alternative: API Key
If you prefer not to use the CLI login:
Get your API key from https://app.postcard.ai/settings/api
Available Tools
Mailings
Tool | Description |
| Create and send a postcard mailing |
| List mailings with filters |
| Get mailing details |
| Cancel a pending mailing |
| Get preview images |
| Confirm and send after preview |
| Get delivery metrics |
Contacts
Tool | Description |
| Create a new contact |
| Batch create (max 1000) |
| Find by email/phone/address |
| List with search |
| Get details |
| Update fields |
| Remove contact |
| Get mailing history |
Designs
Tool | Description |
| Generate from prompt |
| List saved designs |
| Get with iterations |
| Generate variations |
| Publish iteration |
| Archive design |
Lists
Tool | Description |
| Create contact list |
| List all lists |
| Get list details |
| Update name/description |
| Delete list |
| Add contacts |
| Remove contacts |
Credits
Tool | Description |
| Check balance |
| Estimate cost |
| Buy credits |
| Transaction history |
Brands & Addresses
Tool | Description |
| Create brand profile |
| List brands |
| Set default |
| Add return address |
| Set default |
Account
Tool | Description |
| Organization info, plan, usage |
Example Prompts
Once configured, try asking Claude:
"Send a postcard to John Smith at 123 Main St, Austin TX 78701 with a summer home buying theme"
"Show me my credit balance"
"Create a new contact list called 'VIP Clients'"
"Generate a thank you postcard design for new customers"
Configuration
Environment Variables
Variable | Required | Description |
| No | API key (alternative to CLI login) |
| No | API URL (default: |
| No | Custom config file path |
Credential Priority
POSTCARDAI_API_KEYenvironment variable~/.postcardai/config.json(from CLI login)Custom path via
POSTCARDAI_CONFIG_PATH
Other Clients
Cursor
Add to Cursor settings under MCP:
Claude Code
Documentation
License
MIT