# AMcards MCP

> AMcards MCP sends personalized physical notes and greeting cards directly from your AI client. Automate relationship management by triggering customized mailings or enrolling clients into timed follow-up sequences, all without leaving your chat window.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** direct-mail, greeting-cards, automated-gifting, relationship-management, personalized-marketing, webhook

## Description

You can use this MCP to manage high-touch, physical outreach for clients and prospects. Instead of manually logging into a separate mailing portal every time you want to send a thank-you note, your AI agent handles it instantly. You can programmatically dispatch personalized cards using custom messages and track the delivery status right through your natural conversation flow. It’s ideal for maintaining consistent client relationships at scale.

For instance, if you just closed a deal, you don't need to copy an address into a separate form; you simply tell your agent to send a 'Welcome' card with a specific template ID to the new contact. Need to check up on past outreach? Your agent retrieves detailed historical records of every sent card and verifies which templates are available for use. This level of control over physical relationship management is now accessible through any MCP-compatible client, making your AI agent function as a dedicated physical mail coordinator.

## Tools

### check_api_health
Verifies the current connection status of your AMcards API service.

### get_card_sending_history
Retrieves a detailed list and status report of all cards that have been sent previously.

### list_drip_campaigns
Retrieves a list of ongoing or scheduled automated card-sending sequences.

### list_card_templates
Shows you the available greeting card designs and message templates in your account.

### list_configured_webhooks
Lists all active webhooks configured for automatic external notifications.

### send_greeting_card
Sends an immediate, personalized greeting card to a specified recipient and address.

### trigger_drip_campaign
Starts or restarts a pre-configured automated mailing sequence for a specific contact.

## Prompt Examples

**Prompt:** 
```
List all my physical card templates in AMcards.
```

**Response:** 
```
I've retrieved your card library. You currently have 5 active templates, including 'Modern Thank You' (ID: 92) and 'New Client Welcome'. Which one should we use for your next mailing?
```

**Prompt:** 
```
Send a 'Welcome' card (ID: '92') to 'John Smith' at '123 Main St, New York, NY 10001'.
```

**Response:** 
```
Mailing orchestrated! I've successfully triggered the shipment of the Welcome card to John Smith. The order is now being processed for high-fidelity physical delivery. Need a copy of the message logs?
```

**Prompt:** 
```
Show my recent card sending history and statuses.
```

**Response:** 
```
Accessing shipment logs... Your last 5 shipments include 3 'Delivered' cards and 2 'In Transit'. The most recent was a gift bundle to @user1. Would you like the high-fidelity tracking numbers?
```

## Capabilities

### Send personalized cards
Dispatch a greeting card to an address using a custom message or existing template.

### Automate follow-up campaigns
Enroll contacts into scheduled sequences of cards and gifts for ongoing relationship maintenance.

### View available templates
List all card designs and message frameworks you have saved in your account library.

### Check mailing history
Retrieve a log of past cards sent, including their current delivery status.

### Verify system connectivity
Confirm that the AMcards API is running and ready to accept commands.

## Use Cases

### The Sales Follow-Up Gap
A sales rep just finished a major discovery call. Instead of making notes and forgetting to send the thank you, they simply prompt their agent: 'Send a personalized card using Template ID 92 to Jane Doe.' The `send_greeting_card` tool handles the mailing immediately.

### The Cold Lead Nurture Cycle
A real estate agent needs to stay top-of-mind with new leads. They use their agent to run `trigger_drip_campaign` on a list of contacts, starting a 6-month sequence that sends a welcome card every two months.

### The Client Appreciation Audit
A customer success manager needs to prove they've been proactive. They use `get_card_sending_history` to generate an audit trail showing the last quarter’s gifts, proving relationship effort before a review meeting.

### The Campaign Check
A marketing team needs to know if their automated campaign is running correctly. They use `list_drip_campaigns` and then confirm connectivity with the `check_api_health` tool before launching any new sequences.

## Benefits

- Maintain relationships effortlessly. Use the `trigger_drip_campaign` tool to set up scheduled card sequences, ensuring clients hear from you even when you're busy.
- Immediate, high-fidelity outreach. Instead of remembering details later, simply ask your agent to use `send_greeting_card` after a call; it handles the mailing instantly.
- No guessing about branding. The MCP lets you access and monitor all templates via `list_card_templates`, guaranteeing your brand voice is consistent across every card sent.
- Full visibility into outreach efforts. You can pull up `get_card_sending_history` to see exactly what was sent, when it went out, and its current delivery status.
- System confidence. Use the `check_api_health` tool at any time to verify connectivity, so you never risk a failed mailing because of an API hiccup.

## How It Works

The bottom line is that your AI client manages the entire physical mailing workflow through simple chat commands, eliminating manual portal logins.

1. Subscribe to this MCP on Vinkius and grab your Access Token from your AMcards dashboard.
2. Connect your preferred AI client (like Cursor or Claude) using the token. Your agent now has access to all card management functions.
3. Issue a natural language command—for example, 'Send a thank you note to Sarah Jones'—and watch it process the mailing.

## Frequently Asked Questions

**How do I check if my AMcards API connection is working using `check_api_health`?**
Run the `check_api_health` tool. It immediately verifies your account connectivity and tells you if the service is ready to accept mailing commands.

**Can I see all my past mailed cards using `get_card_sending_history`?**
Yes, running `get_card_sending_history` pulls up a detailed log. You can see the status of each card—whether it's delivered or still in transit.

**I need to send a card but don't know what templates I have; how do I use `list_card_templates`?**
Execute `list_card_templates`. This will show you every available design and template ID number, so you can reference the correct one when sending.

**What is the difference between `send_greeting_card` and `trigger_drip_campaign`?**
`send_greeting_card` sends a single card right now. `trigger_drip_campaign` sets up a sequence of cards or gifts to send automatically over weeks or months.

**How do I use `list_configured_webhooks` to verify that data is flowing correctly from AMcards?**
It shows every active webhook endpoint you've set up. This lets you confirm which third-party services are receiving card status updates or client metadata automatically.

**Before starting a new campaign, what does `list_drip_campaigns` show me about existing automated sequences?**
It retrieves a list of all your active and dormant drip campaigns. This lets you quickly review the current stages, recipients, and timing rules for any scheduled outreach.

**When I run `send_greeting_card`, how do I ensure I provide all necessary recipient data?**
The tool requires specific parameters like a valid address, an associated template ID, and the personalized message content. Missing any of these details will stop the mailing process immediately.

**I'm worried about API usage limits; is there anything to check regarding my AMcards account quota?**
You should monitor your account-level profile metadata through the agent to see current utilization and rate limits. This prevents unexpected failures when sending a large volume of cards or running campaigns.

**How do I find my AMcards Access Token?**
Log in to your account, navigate to **Settings** > **API**, and generate a new Access Token for your integration.

**Can I include a gift with the card?**
Yes! If your chosen template ID includes a gift (like brownies), the system will automatically process the high-fidelity gifting workflow.

**How do I check if a card was delivered?**
Use the `get_card_sending_history` tool to retrieve the high-fidelity status log of all your previous card shipments.