@cards-for-agents/mcp

MCP server for cards-for-agents.com — lets an AI agent send a real, handwritten-style Mother's Day card through Postable.

Install

Claude Desktop

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "cards-for-agents": {
      "command": "npx",
      "args": ["-y", "@cards-for-agents/mcp"]
    }
  }
}

Restart Claude Desktop. A new tool set called cards-for-agents will appear.

Cursor / other MCP clients

Point your MCP config at npx -y @cards-for-agents/mcp over stdio.

What it does

Exposes a small set of tools for composing, previewing, and handing off a real paper greeting card order. You ask your AI to send a card; the AI walks the order through the tools, produces a signed preview URL, and hands it to you. You open the URL, review, and click through to Postable's checkout to pay.

The agent never sees your payment details.

Tools

• search_cards, get_card_details — browse the Mother's Day catalog.
• create_order, get_order, set_card — build an order.
• compose_message — set the inside-of-card text (and an optional signoff).
• set_recipient, validate_recipient, set_sender — addresses.
• preview_order — generate the signed preview URL and drive the Postable handoff.

Full reference: cards-for-agents.com/tools.

Configuration

The MCP server talks to a hosted API at https://api.cards-for-agents.com. Override with CARDS_FOR_AGENTS_API if you need to point at a different deployment:

{
  "mcpServers": {
    "cards-for-agents": {
      "command": "npx",
      "args": ["-y", "@cards-for-agents/mcp"],
      "env": {
        "CARDS_FOR_AGENTS_API": "http://localhost:3100"
      }
    }
  }
}

License

MIT