# Cardly MCP for AI Agents AI Agent Connect

> Cardly lets you send physical greeting cards through your AI agent. You can automate personalized mailings, manage your contact lists, and preview card designs before they ship. It handles the heavy lifting of physical mail logistics so you can focus on building relationships.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_rmtkVUMmByrTvymx59h9Tx36WZHqq93WgulPlibU/ai-agent-connect
- **Tags:** greeting-cards, direct-mail, customer-appreciation, physical-mail, gifting, order-management

## Description

Cardly lets you connect your account to your AI agent to handle physical gifting and customer appreciation without the usual manual overhead. You can tell your agent to send out personalized cards to your clients or employees, and it will handle the logistics of placing the orders and managing the designs. Instead of jumping between tabs to copy and paste addresses or browse through an artwork gallery, you can just describe what you need in plain English. It handles the heavy lifting of finding the right design, verifying the recipient information, and even showing you a preview of the final card layout before it goes out. This makes it much easier to keep up with high-volume mailings while ensuring every card looks exactly how you intended. Because Cardly is available through the Vinkius Marketplace, you can get this integrated into your existing workflow quickly. It turns a multi-step administrative task into a simple conversation that results in real mail arriving on doorsteps. You can manage your entire contact book and see all your custom artwork without ever logging into a separate dashboard. Whether you are sending a single thank you to a VIP or a mass appreciation campaign for a whole team, the process stays the same. You just give the command, and the agent takes care of the rest.

## Tools

### add_contact_to_list
Add a new person to a specific list in your account. This helps you keep your mailing database organized.

### find_contact
Search for a specific person in your lists by their email address. It makes it easy to find the right recipient quickly.

### get_account_info
Pull core account details and status information. Use this to check your general account standing.

### get_artwork_details
Get specific metadata and info for a piece of card artwork. This is useful for checking design IDs and specifics.

### list_card_artwork
See all available greeting card designs in your library. This lets you browse your options without leaving your chat.

### list_contact_lists
List all contact lists in your account

### place_greeting_card_order
Place a real order for a physical greeting card to be shipped. This is the tool that actually sends the mail.

### preview_greeting_card
Generate a watermarked PDF preview of a card layout. This lets you verify the text and design before it prints.

### verify_api_connection
Check if your API key is working and active. Use this to troubleshoot any connection issues instantly.

## Prompt Examples

**Prompt:** 
```
Show me all the cards I can use.
```

**Response:** 
```
I found 12 designs in your Cardly library. Here are the top ones:

| Design Name | ID |
| :--- | :--- |
| Birthday Balloon | art_1 |
| Thank You Floral | art_2 |
| Holiday Cheer | art_3 |

Which one should we use?
```

**Prompt:** 
```
Send a thank you card to Sarah at sarah@example.com.
```

**Response:** 
```
I've found Sarah in your list. I'll use the 'Thank You' design. Want to see a preview before I place the order?
```

**Prompt:** 
```
Is my Cardly account connected?
```

**Response:** 
```
Yes, your API connection is active and verified. You're all set to start sending cards.
```

## Capabilities

### Place physical card orders
Order real cards with custom messages and designs via chat.

### Browse artwork library
See all your custom designs and their metadata instantly.

### Preview card layouts
Get a watermarked PDF preview of a card to verify content before sending.

### Manage contact lists
Access and manage your contact lists and add new recipients to your address book.

### Verify API status
Verify your connection and API key status instantly using a quick command.

## Use Cases

### Send a quick thank you to a lead
A sales rep wants to thank a new lead. They ask the agent to send a card to the lead's email using a specific floral design.

### Automate team birthday cards
HR needs to send cards to the whole team. They ask the agent to find all contacts in the Staff list and send a card.

### Review custom artwork designs
A brand manager wants to see their options. They ask the agent to list all artwork and show details for a specific design ID.

### Check connection status
A developer wants to ensure the setup is correct. They ask the agent to verify the API connection to see if it is active.

## Benefits

- Send real mail via `place_greeting_card_order` without ever opening a web browser or manual portal.
- Browse your full gallery with `list_card_artwork` to find the perfect design for any occasion.
- Avoid shipping mistakes by using `preview_greeting_card` to see a watermarked layout before it goes live.
- Organize your mailing lists more efficiently using `add_contact_to_list` and `find_contact`.
- Stay on top of your account status by using `verify_api_connection` to check your connection health.

## How It Works

The bottom line is you turn a multi-step mail process into a single conversation.

1. Connect your Cardly API key to your AI client via the Vinkius platform.
2. Describe the card you want to send, including the recipient and message.
3. Review the preview and confirm the order to ship the physical card.

## Frequently Asked Questions

**Can Cardly send physical cards to other countries?**
Yes, Cardly supports shipping to the US, Australia, UK, and many other locations worldwide. This means you can reach your customers or employees no matter where they are.

**How do I see the different card designs I can use?**
Your agent can list all the available designs in your account. This allows you to browse your full artwork library without leaving your chat window.

**Can I see a preview of the card before I pay for it?**
Yes, you can generate a watermarked preview of the card layout. This lets you verify that the message and design look right before the order is finalized.

**Does Cardly let me manage my own contact lists?**
You can add new recipients to specific lists and search for existing ones by email. This helps you keep your mailing database organized and ready to use.

**Is this tool for sending physical mail or just emails?**
This tool is specifically for physical mail. It handles the process of placing real orders for greeting cards that arrive on a recipient's doorstep.

**How can I check if my Cardly account is connected correctly?**
You can ask your agent to verify your API status instantly. It will check your connection and key validity so you know everything is ready to go.

**Can I see a preview of the card before sending it?**
Yes! Use the `preview_greeting_card` tool with your message and artwork ID. Your agent will return a preview URL (usually a PDF) so you can verify everything looks perfect.

**How do I find the correct artwork ID for a design?**
Simply ask the agent to `list_card_artwork`. It will retrieve all the available designs from your account, including their titles and unique IDs or slugs.

**Does the integration support international shipping?**
Yes. When using the `place_greeting_card_order` action, you can specify the country code (e.g., 'UK', 'AU', 'US'). Cardly handles the local printing and postage automatically.