# Stannp MCP > Stannp lets you run direct mail campaigns via your AI agent. Send personalized physical letters, postcards, and manage entire mailing lists programmatically. You can query campaign status, check your account balance, or pull specific recipient data—all through natural conversation. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** direct-mail, physical-letters, postcards, marketing-automation, mailing-list, snail-mail, stannp ## Description Listen, you connect your **Stannp** account to your AI agent on Vinkius. This lets your agent handle direct mail campaigns—physical letters and postcards—without you ever having to touch a web dashboard or write code. You just talk to it like talking to a teammate; your agent handles the rest of the heavy lifting. ### Sending Mailers When you need to send physical mail, your agent uses specific tools. To blast out personalized letters, it calls `create_physical_letter`, which sends either single letters or bulk runs based on what you tell it. If postcards are what you're running, the agent executes `create_postcard` to create and dispatch those. You can also track these efforts; for a rundown of every letter sent or drafted, check `list_letters`. Similarly, if you need postcard history, run `list_postcards`. ### Managing Your Contacts You've got records in the system that your agent manages. If you need to build out the mailing list, tell it to use `create_recipient`, and it adds a brand new contact record right into the database. To see who’s already in the mix, it generates a full roster using `list_mailing_recipients`. Need details on one specific person's address? The agent runs `get_recipient` and pulls all available data for that single mailing address. ### Tracking Campaigns and Status Your AI client keeps tabs on everything. If you want to know about past or planned campaigns, the agent uses `list_direct_mail_campaigns` to pull up a history by name or date range. For deep-dive status reports on one specific campaign ID, it calls `get_campaign`, providing all the metadata and current status you need. You can also check the full details of any single letter that was sent or even just drafted by running `get_letter`. ### Monitoring Finances It’s important to know your limits before you start mailing things out. To see what money you've got left in your prepaid account and what your spending cap is, simply run the `get_account_balance` tool. This keeps you from getting stuck halfway through a big campaign because of an unexpected balance issue. ## Tools ### create_postcard Creates and sends a physical postcard to designated addresses. ### create_recipient Adds a brand new contact record to the mailing system database. ### get_campaign Fetches detailed status and metadata for a specific direct mail campaign ID. ### get_letter Retrieves the full details of one particular letter that was sent or drafted. ### get_recipient Gets all available data for a single, specific mailing address contact. ### create_physical_letter Sends a single or bulk physical letter to specified recipients. ### get_account_balance Retrieves your current prepaid account credit balance and spending limits. ### list_direct_mail_campaigns Lists all historical and configured direct mail campaigns by name or date range. ### list_letters Provides a history log of all letters that have been sent or are currently drafted. ### list_postcards Provides a history log of all postcards that have been sent or are currently drafted. ### list_mailing_recipients Generates a comprehensive list of existing mailing recipients and their addresses. ## Prompt Examples **Prompt:** ``` List my sent letters in Stannp. ``` **Response:** ``` I've retrieved your letters. You have 10 sent items, including 'Welcome Pack' and 'Invoice #123'. ``` **Prompt:** ``` Show me all direct mail campaigns with their delivery status and response rates. ``` **Response:** ``` 8 direct mail campaigns. Active (3): "Spring Promo Postcards" (2,340 sent, 2,280 delivered, 98 responses, 4.3% response rate, QR scans: 156). "VIP Thank You Letters" (120 sent, 118 delivered, personalized). "Re-engagement Mailer" (890 sent, in transit). Completed (4): avg 3.8% response rate. Draft (1): "Summer Sale Flyer" (ready for review). Total pieces mailed this month: 5,200. Total spend: £1,890. Average cost per piece: £0.36. Best performing: "Holiday Catalog" at 6.2% response. ``` **Prompt:** ``` Create and send a personalized postcard to our top 50 customers with a loyalty discount code. ``` **Response:** ``` Postcard campaign created: "VIP Loyalty Reward". Recipients: 50 top customers (by lifetime value). Personalization: first name, unique discount code per recipient (VIP-[NAME]-20). Design: A5 size, full-color front with product image, personalized back with message and QR code to redemption page. Print status: queued for next business day. Estimated delivery: 3-5 business days. Cost: £22.50 (£0.45/piece). Tracking: Royal Mail tracked. Redemption tracking: unique codes linked to CRM profiles. ``` ## Capabilities ### Send Physical Letters The agent sends single or bulk physical letters using the `create_physical_letter` tool. ### Generate Postcards You can create and send postcards programmatically with the `create_postcard` tool. ### Manage Contacts Retrieve, update, or list mailing recipients using tools like `list_mailing_recipients` or creating new records via `create_recipient`. ### Track Campaigns The agent pulls campaign metadata and status reports using `list_direct_mail_campaigns`. ### Monitor Spending Check your remaining funds and mailing budget instantly with the `get_account_balance` tool. ## Use Cases ### Auditing the last quarter’s outreach. The coordinator needs to know how many letters were sent in Q2. They prompt their agent with: 'Show me all my mail activity from April to June.' The agent runs `list_letters` and `list_postcards`, giving a consolidated count, saving hours of manual record-checking. ### Running a targeted local promotion. The marketing team wants to send postcards only to high-value clients in one zip code. They first run `list_mailing_recipients` to get all addresses, and then instruct the agent: 'Filter that list for ZIP 90210, then send a postcard.' The entire process runs in two tool calls. ### Checking compliance before a big push. Before launching a massive campaign, the Campaign Manager asks the agent to run `get_account_balance`. This immediately shows the current spending cap. If it’s low, they stop and fix the budget issue rather than wasting money on sends. ### Creating a new mailing segment. The team identified a group of contacts that need special handling. They use `list_mailing_recipients` to pull names, and then call `create_recipient` with updated details or missing information for those specific people. ## Benefits - Instantly monitor your budget with `get_account_balance`. You know exactly how much you can spend before the agent initiates any large send, preventing unexpected overages. - Build complex campaign reports. Use `list_direct_mail_campaigns` to pull metadata and status across dozens of outreach efforts in one query. - Perfect for personalized follow-up. Instead of manual lookups, use `get_recipient` combined with the agent to ensure every single address is current before sending a letter via `create_physical_letter`. - Streamline list building. The `list_mailing_recipients` tool pulls your entire contact database into the conversation, letting you filter and prep for sends without exporting a CSV. - Full audit trail available. Need to prove when something was sent? Use `list_letters` or `list_postcards` to access a history log of every physical piece mailed. ## How It Works The bottom line is you stop writing API code. You just talk to your AI client, and it executes the complex mail workflow for you. 1. Subscribe to this server on Vinkius and input your Stannp API key into your AI client. This grants your agent access to all 11 tools. 2. Tell your agent what you need done (e.g., 'Send postcards to the top 50 clients'). The agent determines the necessary sequence of tool calls. 3. The agent executes the plan—for instance, it first uses `list_mailing_recipients` and then passes those IDs into `create_postcard`—and reports the final status. ## Frequently Asked Questions **How do I check my remaining mailing budget with Stannp MCP Server?** You use the `get_account_balance` tool. This immediately pulls your current credit balance, so you know exactly how much spending power is left before starting any campaign. **Can I send a postcard to only one specific client using Stannp MCP Server?** Yes. First, use `get_recipient` to pull all the necessary details for that single person. Then, instruct your agent to run `create_postcard` with those specific credentials. **What if I need to update a contact's address before sending mail?** You should first use `list_mailing_recipients` to see the current data. If an address is wrong, you can tell your agent to create or modify that record using the `create_recipient` tool. **Does Stannp MCP Server track my sent letters?** Yes. You access a full history log by calling `list_letters`. This shows you every letter that has been drafted or successfully mailed through the system. **How do I retrieve the status and metadata for a direct mail campaign using get_campaign?** The agent retrieves detailed records for any specified Campaign ID. You see the total pieces sent, delivery rates, and whether the campaign is currently active or finalized. **What should I do if the create_physical_letter tool returns an error?** The server sends a specific error code detailing the failure. This usually points to bad recipient data, invalid formatting, or billing issues; check your account status first. **How do I list and view all my mailing recipients using list_mailing_recipients?** You call list_mailing_recipients. This pulls a comprehensive manifest of every contact in your system. From this result, you can select the IDs needed for targeted sends or record creation. **What happens if my Stannp API key expires while using any tool?** The server will fail and return a clear authentication error message. You must update your Stannp API Key within Vinkius with a fresh, active credential before running any operations. **Can I send a physical letter using my AI agent?** Yes! Use the `create_physical_letter` action. Provide the recipient details and a template ID to trigger printing and mailing programmatically.