PostcardAI MCP Server

$npx -y @postcardai/mcp-server
README.md

Use PostcardAI with Claude, Cursor, and other AI assistants.

PostcardAI MCP Server

Model Context Protocol server for PostcardAI. Use PostcardAI with Claude, Cursor, and other AI assistants.

Quick Start

1. Install & Authenticate

npx @postcardai/cli login

This opens your browser to authenticate and stores credentials securely.

2. Configure Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "postcardai": {
      "command": "npx",
      "args": ["-y", "@postcardai/mcp-server"]
    }
  }
}

3. Restart Claude Desktop

That's it! Ask Claude to send postcards.

Alternative: API Key

If you prefer not to use the CLI login:

{
  "mcpServers": {
    "postcardai": {
      "command": "npx",
      "args": ["-y", "@postcardai/mcp-server"],
      "env": {
        "POSTCARDAI_API_KEY": "pcai_sk_live_xxx"
      }
    }
  }
}

Get your API key from https://app.postcard.ai/settings/api

Available Tools

Mailings

Tool Description
create_mailing Create and send a postcard mailing
list_mailings List mailings with filters
get_mailing Get mailing details
cancel_mailing Cancel a pending mailing
get_mailing_previews Get preview images
send_mailing Confirm and send after preview
get_mailing_analytics Get delivery metrics

Contacts

Tool Description
create_contact Create a new contact
create_contacts_batch Batch create (max 1000)
match_contact Find by email/phone/address
list_contacts List with search
get_contact Get details
update_contact Update fields
delete_contact Remove contact
get_contact_history Get mailing history

Designs

Tool Description
create_design Generate from prompt
list_designs List saved designs
get_design Get with iterations
iterate_design Generate variations
publish_design Publish iteration
delete_design Archive design

Lists

Tool Description
create_list Create contact list
list_lists List all lists
get_list Get list details
update_list Update name/description
delete_list Delete list
add_contacts_to_list Add contacts
remove_contacts_from_list Remove contacts

Credits

Tool Description
get_credit_balance Check balance
estimate_mailing_cost Estimate cost
purchase_credits Buy credits
get_credit_transactions Transaction history

Brands & Addresses

Tool Description
create_brand Create brand profile
list_brands List brands
set_default_brand Set default
create_return_address Add return address
set_default_return_address Set default

Account

Tool Description
get_account 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
POSTCARDAI_API_KEY No API key (alternative to CLI login)
POSTCARDAI_API_URL No API URL (default: https://api.postcard.ai/v1)
POSTCARDAI_CONFIG_PATH No Custom config file path

Credential Priority

  1. POSTCARDAI_API_KEY environment variable
  2. ~/.postcardai/config.json (from CLI login)
  3. Custom path via POSTCARDAI_CONFIG_PATH

Other Clients

Cursor

Add to Cursor settings under MCP:

{
  "postcardai": {
    "command": "npx",
    "args": ["-y", "@postcardai/mcp-server"]
  }
}

Claude Code

claude mcp add postcardai npx @postcardai/mcp-server

Documentation

License

MIT

Tools (38)

create_mailingCreate and send a postcard mailing
list_mailingsList mailings with filters
get_mailingGet mailing details
cancel_mailingCancel a pending mailing
get_mailing_previewsGet preview images
send_mailingConfirm and send after preview
get_mailing_analyticsGet delivery metrics
create_contactCreate a new contact
create_contacts_batchBatch create (max 1000)
match_contactFind by email/phone/address
list_contactsList with search
get_contactGet details
update_contactUpdate fields
delete_contactRemove contact
get_contact_historyGet mailing history
create_designGenerate from prompt
list_designsList saved designs
get_designGet with iterations
iterate_designGenerate variations
publish_designPublish iteration
delete_designArchive design
create_listCreate contact list
list_listsList all lists
get_listGet list details
update_listUpdate name/description
delete_listDelete list
add_contacts_to_listAdd contacts
remove_contacts_from_listRemove contacts
get_credit_balanceCheck balance
estimate_mailing_costEstimate cost
purchase_creditsBuy credits
get_credit_transactionsTransaction history
create_brandCreate brand profile
list_brandsList brands
set_default_brandSet default
create_return_addressAdd return address
set_default_return_addressSet default
get_accountOrganization info, plan, usage

Environment Variables

POSTCARDAI_API_KEYAPI key (alternative to CLI login)
POSTCARDAI_API_URLAPI URL (default: https://api.postcard.ai/v1)
POSTCARDAI_CONFIG_PATHCustom config file path

Configuration

claude_desktop_config.json
{
  "mcpServers": {
    "postcardai": {
      "command": "npx",
      "args": ["-y", "@postcardai/mcp-server"]
    }
  }
}

Try it

→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

Frequently Asked Questions

How do I install PostcardAI MCP Server?

Install PostcardAI MCP Server by running: npx -y @postcardai/mcp-server

What MCP clients work with PostcardAI MCP Server?

PostcardAI MCP Server works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Use PostcardAI MCP Server with Conare

Manage MCP servers visually, upload persistent context, and never start from zero with Claude Code & Codex.

Try Free

Related MCP Servers

Feishu MCP Server
A remote MCP server for Feishu (Lark) with OAuth and Cloudflare Workers support
communication81 stars
Instagram MCP Server
AI-driven management of Instagram Business accounts via Graph API
communication79 stars
Outline MCP Server
Read and write documents through the Outline API
communication11 stars
Discord MCP Server
Comprehensive administrative control over Discord communities via MCP
communication6 stars
Slabby
MCP server for Slab knowledge base integration with AI coding agents
communication6 stars
DingTalk MCP Server
Enables Claude to interact with DingTalk workspaces to search for users.
communication5 stars