# CardClan — how to use (mcp.ai)

Connect your CardClan account and use 9 tools for marketing straight from your AI agent. Connect with your own API key. CardClan helps teams personalize and send digital cards, generate card links, and manage card integration workflows.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_cardclan?ms=1787296020000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `cardclan_create_integration_config`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/cardclan`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/cardclan/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/cardclan/create/integration/config` — Create a persistent CardClan integration configuration linking a card to its workspace. The connected user's ID is resolved automatically.
  - body: { card_id: string, workspace_id: string }
- `POST https://api.mcp.ai/api/cardclan/generate/card/url` — Generate a personalized CardClan viewing URL without sending an email. This may create recipient-specific CardClan state but does not deliver a message.
  - body: { card_id: string, recipients: object[], integration_id: string }
- `POST https://api.mcp.ai/api/cardclan/get/card/details` — Get a CardClan card's title, merge-tag requirements, and owning workspace details by card ID.
  - body: { card_id: string }
- `POST https://api.mcp.ai/api/cardclan/get/integration/config` — Get a CardClan integration configuration by either integration ID or card ID.
  - body: { card_id?: string, integration_id?: string }
- `POST https://api.mcp.ai/api/cardclan/list/cards` — List cards in a CardClan workspace, including card IDs needed for details, integration configuration, personalized links, and sending.
  - body: { workspace_id: string }
- `POST https://api.mcp.ai/api/cardclan/list/email/accounts` — List configured CardClan sender accounts that can be selected when sending a card.
- `POST https://api.mcp.ai/api/cardclan/list/workflow/cards` — List cards with active CardClan integration workflows and return their integration, card, and workspace IDs.
- `POST https://api.mcp.ai/api/cardclan/list/workspaces` — List CardClan workspaces accessible to the connected account, including the workspace IDs needed to find cards and create integration configurations.
- `POST https://api.mcp.ai/api/cardclan/send/card` — Immediately personalize and send a CardClan card by email to one or more recipients. This externally side-effecting operation is irreversible; use GENERATE_CARD_URL when delivery is not intended.
  - body: { card_id: string, recipients: object[], confirm_send: boolean, integration_id: string, email_account_id?: string }

## Example prompts
- "What can I do in CardClan?"
- "Show me a summary of my CardClan account"

## More
- Page: https://mcp.ai/cardclan
- Agent spec (llms.txt): https://mcp.ai/cardclan/llms.txt
- Postman collection: https://mcp.ai/cardclan/postman.json