modcard-mcp-setup

<p align="center"><img src="assets/logo-512.png" width="96" alt="ModCard logo"></p>

# ModCard MCP server

Find, personalize, share, and mail animated greeting cards with original music, from any AI assistant that supports MCP.

ModCard is a catalog of animated greeting cards, each with its own original song. Connect it to your assistant and ask for the card you need, such as "a funny birthday card for my dad who loves fishing". The assistant searches the catalog, makes your own copy with your message and names, and shows you a private preview. Then it can make an eCard link for you to share, or set up a printed card mailed to a US address. You pay at a secure Stripe checkout page.

Everything works by voice. You never need to look at a screen to finish an order.

This repository holds setup instructions only. The server is hosted by ModCard; there is nothing to install or run.

## Server

|           |                                                                                                                              |
| --------- | ---------------------------------------------------------------------------------------------------------------------------- |
| URL       | `https://api.modcard.fun/api/mcp`                                                                                            |
| Transport | Streamable HTTP                                                                                                              |
| Sign-in   | OAuth 2.1 with your ModCard account (free to create in the sign-in window). No API key.                                      |
| Registry  | [`fun.modcard/modcard`](https://registry.modelcontextprotocol.io/v0/servers?search=fun.modcard) in the official MCP Registry |

## Connect

The first time your assistant connects, a browser window opens. Sign in to ModCard, or create an account with Google, Apple, or email, and approve access once.

**Claude** (claude.ai and the desktop app): Settings → Connectors → Add custom connector, then paste the URL above.

**Claude Code:**

```bash
claude mcp add --transport http modcard https://api.modcard.fun/api/mcp
```

**ChatGPT:** go to [chatgpt.com/plugins](https://chatgpt.com/plugins), select **+** → **Add custom MCP server**, paste the URL, and choose OAuth.

**VS Code:** add [`config/vscode-mcp.json`](config/vscode-mcp.json) to `.vscode/mcp.json`:

```json
{
  "servers": {
    "modcard": { "type": "http", "url": "https://api.modcard.fun/api/mcp" }
  }
}
```

**Cursor:** add [`config/cursor-mcp.json`](config/cursor-mcp.json) to `~/.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "modcard": { "url": "https://api.modcard.fun/api/mcp" }
  }
}
```

Any other MCP client that supports remote servers with OAuth works the same way: point it at the URL.

## Try it

- "Find a funny birthday card for my dad. He's turning 60 and loves fishing."
- "Use that one. Write 'Happy 60th, Dad! Love, Sam' inside."
- "Give me an eCard link I can text him."
- "Mail a printed one to my aunt in Portland."
- "Has my last order shipped?"

## Tools

| Tool                       | What it does                                                                 |
| -------------------------- | ---------------------------------------------------------------------------- |
| `start`                    | Your name, settings, and drafts to pick up again.                            |
| `find_cards`               | Search cards by occasion, recipient, age, interests, or city.                |
| `list_card_filters`        | The occasions, tones, styles, and music genres search accepts.               |
| `make_card`                | Your copy of a card with message, names, and color in one step.              |
| `create_draft`             | Make your own copy of a catalog card to edit.                                |
| `personalize_card`         | Put the recipient's name into the song and voice.                            |
| `set_card_message`         | Write the message inside the card.                                           |
| `set_card_color`           | Pick one of the card's color versions.                                       |
| `get_card`                 | A card's details, pictures, preview link, and print options.                 |
| `create_share`             | Make an eCard link to send yourself.                                         |
| `checkout_card`            | Order a printed, mailed card; you pay at a secure link.                      |
| `pay_for_card`             | Pay with your saved credit card, only if you turned that on (not in Claude). |
| `get_order_status`         | Whether an order is paid, printed, or mailed.                                |
| `list_my_orders`           | Your recent orders.                                                          |
| `get_add_credit_card_link` | A secure Stripe link where you save a credit card.                           |

## Safe by default

- Your assistant sees only your own cards and orders.
- It can't pay unless you turn that on in your ModCard profile, and then only with a credit card you saved, up to a per-order cap. Otherwise every order comes to you as a checkout link.
- It never sees credit card numbers; Stripe handles them.
- It can use your saved address without seeing it in full.
- You can disconnect it at any time by removing the connector.

**In Claude**, a few things work differently: Claude can't make payments (you always get a checkout link), names are added to the song only from our recorded name library, and a different music style is available only when that version of the card already exists.

## Links

- How it works: <https://www.modcard.fun/agents>
- Privacy Policy: <https://www.modcard.fun/privacy>
- Terms of Service: <https://www.modcard.fun/terms>
- Support: <ayudar@modcard.fun>