# Handwrytten MCP for AI Agents AI Agent Connect

> Handwrytten lets you send physical, handwritten cards through your AI agent. You can browse stationery, pick specific handwriting styles, and manage your recipient list or order history without leaving your chat interface. It turns digital prompts into real mail sent to your customers or team members.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_IZiaJpx2XCeF1ir3zokKywUarauvjGpXU31Jq6mt/ai-agent-connect
- **Tags:** direct-mail, handwriting-automation, customer-retention, personalized-marketing, physical-mail, outreach

## Description

This Connector lets you send physical, handwritten cards through your AI agent. You can browse stationery, pick specific handwriting styles, and manage your recipient list or order history without leaving your chat interface. It turns digital prompts into real mail sent to your customers or team members.

Imagine you want to send a handwritten thank-you note to a client, but you're stuck in a spreadsheet or a CRM. Usually, this means logging into a separate website, picking a card, typing out a message, and manually entering an address. This connector changes that. You just tell your AI agent what you want to say and who it's for, and the heavy lifting happens in the background. It handles the logistics of finding the right card and the specific pen style that fits your brand. Because it's part of the Vinkius catalog, you can plug it into your existing workflow and treat physical mail like just another digital task. You can check your remaining balance, browse your saved templates for consistency, and see what's been shipped, all from one place. It makes high-touch outreach feel as fast as sending an email while keeping that personal, human touch that only paper and ink can provide. You can manage your entire physical mail strategy from a single conversation, making it easy to keep your brand's presence in the real world without the usual overhead. You can even look through your saved templates to ensure your messaging stays consistent across every single card you send. It bridges the gap between digital efficiency and physical presence, making it easy to manage your entire outreach budget and recipient list from one place.

## Tools

### list_categories
View different card types grouped by occasion or style. Use this to browse specific collections.

### list_fonts
See all the different handwriting styles you can choose from. This lets you personalize the look of your mail.

### get_credit_balance
Check your current account balance to see how many more cards you can send. Use this to manage your budget.

### get_order
Get specific details for a single past order. This is useful for verifying delivery or specific card details.

### list_address_book
See all the recipients you have saved in your address book. This helps you quickly find the right person to mail.

### list_cards
See every card and stationery option currently available. This helps you find the right card for any occasion.

### list_gifts
Check which physical gifts can be added to your cards. Use this to add a personal touch to your notes.

### list_orders
View your full history of sent cards and order details. This is great for tracking your past outreach.

### list_templates
See your saved message templates to keep your brand voice consistent. Use this to quickly pull pre-approved text.

### send_card
Send a single handwritten card with a custom message to a specific recipient. This triggers the actual mail order.

## Prompt Examples

**Prompt:** 
```
Send a thank you card to Sarah Jenkins using a professional font.
```

**Response:** 
```
I've located Sarah Jenkins in your address book. I found 3 'Thank You' cards available. Which one would you like to use? Once you pick, I'll send the card using a professional handwriting style.
```

**Prompt:** 
```
How many credits do I have left?
```

**Response:** 
```
You currently have **$145.50** remaining in your Handwrytten account. This is enough to send approximately **35 more premium cards**. Would you like to see your recent order history?
```

**Prompt:** 
```
Show me some different handwriting styles.
```

**Response:** 
```
Handwrytten offers over 25 styles. Here are a few popular options:

* **hwDavid** (Clean Print)
* **hwCursive** (Classic Cursive)
* **hwCasual** (Relaxed)
* **hwProfessional** (Formal)

Would you like me to apply one of these to your next card?
```

## Capabilities

### Browse stationery options
See all available cards and stationery categories in one place.

### Pick handwriting styles
Select from various realistic handwriting styles to personalize your notes.

### Send physical cards
Trigger a single handwritten card with a custom message to a specific recipient.

### Manage recipient lists
Access and view the recipients saved in your address book.

### Track order history
View details and history for all your previous card orders.

### Monitor account balance
Check your current credit balance to manage your outreach budget.

### Access message templates
Browse your saved message templates to maintain brand consistency.

## Use Cases

### Closing a high-value deal
A Sales Rep wants to thank a lead. They ask the agent to send a 'Thank You' card from the address book using a professional font.

### Client retention
A CSM wants to celebrate a client's anniversary. They use list_templates to find the right message and send_card to mail it.

### Corporate holiday mailings
An EA needs to send holiday cards to 50 people. They ask the agent to send cards to the entire address book using a specific 'holiday' card.

### Marketing budget tracking
A Marketing Manager needs to check the budget. They ask the agent to check get_credit_balance before starting a new campaign.

## Benefits

- Save time on manual data entry by using list_address_book to pull recipient details automatically.
- Maintain brand consistency across all mailings by quickly browsing your saved scripts with list_templates.
- Personalize your outreach for different audiences by switching between handwriting styles using list_fonts.
- Manage your outreach budget easily by checking your remaining balance with get_credit_balance.
- Quickly find the right stationery for any occasion by browsing categories with list_categories.
- Track your physical marketing efforts with a clear history of every shipment via list_orders.

## How It Works

The bottom line is that you can turn a chat command into a physical piece of mail without ever opening a browser tab.

1. Connect your Handwrytten API key to the Connector.
2. Tell your AI agent which card, font, and recipient you want to use.
3. Receive a confirmation once the order is placed.

## Frequently Asked Questions

**Can I use the Handwrytten MCP to send physical mail automatically?**
Yes, this Connector lets your AI agent trigger the sending of real, physical handwritten cards. It handles the card selection and message sending so you don't have to visit the website.

**How does Handwrytten help with customer retention?**
It allows you to send personalized items like 'Thank You' or 'Birthday' cards to your clients. Your agent can pull these from your address book and send them instantly to keep your relationships strong.

**Can I manage my outreach budget with this Connector?**
Yes, you can ask your agent to check your current credit balance at any time. This helps you monitor your spending and plan how many more cards you can send during a campaign.

**Does this Connector support different handwriting styles?**
It does. You can browse all available fonts and styles through the agent. This ensures your physical mail matches the tone of your brand, whether it's casual or professional.

**Can I use saved templates to keep my mail consistent?**
Absolutely. The Connector can browse your saved message templates. This lets your agent use pre-approved language for common scenarios like holiday greetings or new client welcomes.

**How do I send a card to someone in my contact list?**
You just tell your agent who to send it to. It will pull the recipient details from your saved address book and send the card using the card and font you've chosen.

**How do I find my Handwrytten API Key?**
Log in to your Handwrytten dashboard, go to **Settings**, and then to the **API Keys** section. You can generate a new key or copy your existing one from there.

**Can I use realistic handwriting fonts?**
Yes! Handwrytten uses robots with real pens. You can list all available styles using the `list_fonts` tool and specify the `font_id` when sending a card.

**How do I check if my card was sent?**
Use the `list_orders` tool to see your history of sent cards or `get_order` with a specific order ID to check its current fulfillment status.

**Is it possible to include gifts with the cards?**
Yes, Handwrytten offers various gifts. You can list available items using the `list_gifts` tool and include the gift ID in your order request.