Card4U MCP Server
Create and preview postcard drafts in a compatible AI assistant. After reviewing a draft, you can authorize a paid order to print and mail the postcard.
Connect your assistant
-
In an MCP client that supports remote Streamable HTTP servers, add this server URL:
https://card4u.org/mcp -
When prompted, connect your Card4U account with OAuth to check your balance and send postcards.
- Ask the assistant to create a draft and show its preview before placing an order.
The URL is an MCP endpoint for clients, not a page to open in a browser. Setup labels vary between clients.
Postcard workflow
- Create a draft. Provide a message, recipient address, and optionally an image or PDF. You can create a draft without connecting an account.
- Review the result. Open the returned preview link and check the design, address warnings, and estimated price. Address checks are formatting hints, not delivery verification.
- Send when ready. Connect your Card4U account, check your balance, and explicitly confirm the paid order. Card4U then prints and mails the postcard.
The message and recipient address are printed on the back. Keep them out of the front artwork to avoid printing them twice.
Available tools
| MCP tool | Task | Access |
|---|---|---|
get_mcp_connection_status |
Check connection | No account required |
list_fonts |
List fonts | No account required |
create_postcard |
Create a draft | Guest or OAuth |
get_postcard |
Inspect a postcard and its preview | Guest draft by ID; OAuth for account-owned postcards |
update_postcard_draft |
Edit an unpaid draft | Guest text edits by ID; OAuth for owned drafts or artwork changes |
delete_postcard_draft |
Delete an unpaid draft | Guest draft by ID; OAuth for owned drafts |
list_recent_postcards |
List recent postcards | OAuth required |
get_balance |
Check balance | OAuth required |
send_postcard |
Place a paid order | OAuth and explicit confirmation required |
Example request
Create a postcard draft for my friend with this photo and a birthday message. Show me the preview and address warnings before sending anything.
Good to know
- Guest drafts return a link for viewing or claiming them. Sending requires an OAuth-connected Card4U account.
- The MCP server sends individual postcards. Manage bulk campaigns in the web editor.
- Artwork can be supplied as an image or a one- or two-page PDF. See the print specifications for dimensions and bleed. Print specifications.
- The MCP connection uses OAuth. For direct software integration with an API token, see the REST API documentation in your Card4U profile. Open profile.