# Handwrytten MCP

> Handwrytten automates physical mail by allowing you to send handwritten notes, cards, and gifts directly through your AI agent's chat interface. You manage everything from selecting card types and fonts to listing recipients and checking your credit balance—all without leaving the conversation flow.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** direct-mail, handwriting-automation, customer-retention, personalized-marketing, physical-mail, outreach

## Description

Need to send a thoughtful, personalized note but hate going through web forms? This MCP connects your entire physical outreach workflow into any chat client. Instead of juggling tabs and manually entering addresses, you talk to your agent, and it handles the rest. You can browse all available stationery types, select a font that matches the tone, and manage your contacts without ever touching the website's backend. Everything runs through simple conversation. Through Vinkius, you get this entire catalog of physical communication tools connected to one place. It’s like having an executive assistant dedicated solely to making sure every 'thank you' or holiday card gets sent perfectly, on time, and with zero friction.

## Tools

### get_credit_balance
Checks your current account credit balance to see how many cards you can afford to send.

### get_order
Retrieves specific details for a single, existing card order.

### list_address_book
Provides a list of all recipients stored in your address book.

### list_cards
Shows every available stationery and card type you can use.

### list_categories
Lists the different types of cards or occasions (like 'Birthday' or 'Thank You').

### list_fonts
Retrieves a list of all available handwriting styles to choose from.

### list_gifts
Shows what physical gifts you can include with your handwritten cards.

### list_orders
Lists the history of all card orders you've placed.

### list_templates
Shows a library of saved message templates to help maintain brand voice.

### send_card
Sends one single, fully customized handwritten card using the chosen recipient, font, and message.

## Prompt Examples

**Prompt:** 
```
Send a 'Thank You' card to John Doe using font hwDavid.
```

**Response:** 
```
I've started the process. I found 3 'Thank You' cards. Which one would you like to use? After that, I'll need the recipient's address to complete the order.
```

**Prompt:** 
```
Check my current credit balance.
```

**Response:** 
```
Accessing account... Your current Handwrytten balance is $145.50. This is enough to send approximately 35 more premium cards. Would you like to see your recent order history?
```

**Prompt:** 
```
List all available handwriting fonts.
```

**Response:** 
```
Retrieving fonts... Handwrytten offers 25+ styles, including: 'hwDavid' (Clean Print), 'hwCursive' (Classic Cursive), 'hwCasual' (Relaxed), and 'hwProfessional'. Would you like a description of any specific style?
```

## Capabilities

### Send Handwritten Cards
The agent sends personalized cards using a selected font, message, and recipient details in one go.

### Manage Contacts
You can pull up your stored address book to retrieve names and mailing addresses for the people you need to reach.

### Check Account Budget
The MCP instantly checks your current credit balance so you know exactly how many cards you can afford to send.

### Browse Stationery Options
You browse available card types, categories, and gift options before drafting a message.

### Review Message Templates
The agent lets you look at saved templates to maintain consistency for recurring messages.

## Use Cases

### Following up after a big pitch.
A sales rep needs to send 10 personalized 'Congratulations' cards. They first call `list_cards` for the correct stationery, then use `list_fonts` to pick a classy script. Finally, they feed the recipient list via `list_address_book` and trigger `send_card` in one flow.

### Running holiday marketing.
A marketing manager needs to send 50 'Happy Holidays' cards with a small gift. They use `list_gifts` to select the item, confirm their budget with `get_credit_balance`, and then run a batch job using `send_card`.

### Checking an old client order.
A customer success manager needs to verify if a card sent three weeks ago was processed. They call `list_orders` first, and if they need details on one specific piece, they use `get_order`.

### Onboarding a new client list.
A team needs to send cards to 20 people whose addresses are in the system. They call `list_address_book` to verify all details, and then use this data source as input for multiple calls to `send_card`.

## Benefits

- You always know your budget before you start. Use `get_credit_balance` to check your funds instantly, avoiding unexpected costs when sending cards.
- No more manual data entry for contacts. Just call `list_address_book` and have your agent pull the recipient details needed for any send job.
- Need a specific style? You can quickly review all options by calling `list_cards` or checking out different handwriting styles with `list_fonts` before writing a single word.
- Keep everything consistent. Before sending, browse your saved message templates using `list_templates` to make sure the tone is right for that recipient.
- The entire process feels like talking to an assistant. Instead of running multiple commands, you just talk through the steps: select card, pick font, list recipients, and finally, use `send_card`.

## How It Works

The bottom line is: your AI client manages the entire order lifecycle from conversation prompt to confirmation email.

1. Subscribe to this MCP and enter your Handwrytten API Key in the Vinkius settings.
2. Ask your AI agent to check your credit balance or list available card types. The tool provides the necessary data points.
3. Give a direct command, like 'Send a thank you note to John Doe using font hwDavid.' Your agent collects all required inputs and initiates the physical mailing process.

## Frequently Asked Questions

**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.

**If I need to check my budget before sending physical cards, how does using the `get_credit_balance` tool work?**
The tool immediately returns your current account credit balance. This lets you track your spending and plan exactly how many premium cards you can afford for a mailing campaign.

**I have multiple clients; if I use the `list_address_book` tool, what data do I get to send cards?**
It pulls all saved recipient details from your address book directly into the chat. You can verify names and addresses right away before running a bulk mailing job.

**How does `list_templates` help me maintain consistent messaging when I send out many cards?**
This tool shows all your pre-saved message templates, allowing you to reuse approved language. It keeps your brand voice consistent across every personalized physical mailing.

**If I need proof of past mailings, can I use the `list_orders` tool to check my history?**
Yes, running this tool provides a list of all previous card order details. You can review the status and specifics of past mailing jobs within your conversation.