# Stannp MCP for AI Agents AI Agent Connect > Stannp MCP lets you manage your physical mail marketing directly through your AI agent. You can send postcards, letters, and manage mailing lists without leaving your chat interface. It handles everything from checking your account balance to querying your recipient database for specific campaigns. ## Overview - **Category:** productivity - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_KFN7VPaZdnwN56OtLiBDy5qIjyEeKrB3ntbwJju8/ai-agent-connect - **Tags:** direct-mail, physical-letters, postcards, marketing-automation, mailing-list, snail-mail, stannp ## Description This Connector bridges the gap between your digital AI workflows and the physical world. Instead of hopping between tabs to manage your snail mail, you can tell your agent to handle the heavy lifting. You can query your entire mailing list to find the right people for a specific outreach, then have the agent draft and send out physical letters or postcards in bulk. It handles the logistics of direct mail marketing so you don't have to. You can check your current account balance to keep an eye on your spend or pull reports on your active campaigns to see how your physical outreach is performing. It's a way to turn your AI into a full-scale direct mail department. You'll find this is one of the most practical ways to use the Vinkius catalog to get tangible results outside of your computer screen. ## Tools ### create_postcard Create and send a physical postcard to a recipient. This is useful for quick, high-impact visual marketing. ### create_recipient Add a new mailing address to your database. Use this to keep your contact list current. ### get_campaign Pull specific details for a direct mail campaign. It helps you see the status of a specific project. ### get_letter Retrieve details for a specific physical letter. Use this to check the content or status of a single mailer. ### get_recipient Get specific info for a single mailing contact. This is helpful for verifying individual addresses. ### create_physical_letter Send a physical letter to a specific address. This is the primary tool for sending personalized long-form mail. ### get_account_balance Check your current available credit for mailings. Use this to ensure you have enough funds before a big send. ### list_direct_mail_campaigns View a list of all your configured mail campaigns. This gives you a high-level view of your marketing efforts. ### list_letters See all sent and drafted letters in your account. This helps you track your history of physical outreach. ### list_postcards See all sent and drafted postcards in your account. Use this to audit your previous postcard campaigns. ### list_mailing_recipients Get a list of all contacts in your mailing database. This is the best way to query your audience for target lists. ## Prompt Examples **Prompt:** ``` Check my current balance and tell me if I have enough to send 500 postcards. ``` **Response:** ``` I've checked your Stannp account. Your current balance is **$150.00**. At an average cost of $0.45 per piece, sending 500 postcards will cost approximately **$225.00**. **Status:** You are currently short by **$75.00**. ``` **Prompt:** ``` List my last 5 sent letters and tell me which ones were for the VIP campaign. ``` **Response:** ``` Here are your last 5 sent letters: | Date | Recipient | Campaign | Status | | :--- | :--- | :--- | :--- | | Oct 12 | Jane Doe | VIP Rewards | Delivered | | Oct 11 | John Smith | VIP Rewards | Delivered | | Oct 10 | Alice Wong | General | Delivered | | Oct 09 | Bob Brown | VIP Rewards | Delivered | | Oct 08 | Charlie Day | General | Delivered | ``` **Prompt:** ``` Find all recipients in my list who haven't received a letter in 3 months. ``` **Response:** ``` I've scanned your mailing list. I found **42 recipients** who have not received a physical letter in the last 90 days. Would you like me to generate a draft for a re-engagement letter for this group? ``` ## Capabilities ### Send physical postcards Create and ship postcards to your customers with one command. ### Manage mailing lists Query and update your database of physical mailing addresses. ### Launch mail campaigns Retrieve metadata and status for your current direct mail projects. ### Track account spend Check your real-time credit balance to manage your mailing budget. ### Monitor outreach history View a history of all your sent and drafted physical letters. ## Use Cases ### Personalized Loyalty Rewards An e-commerce owner asks the agent to find top customers and send a thank you postcard using create_postcard. ### Bulk Re-engagement A marketing manager uses list_mailing_recipients to identify old leads and then sends a physical letter via create_physical_letter. ### Campaign Tracking A fundraiser asks for a summary of all active mailers and uses list_direct_mail_campaigns to see delivery statuses. ### List Management A user adds new leads to their database by telling the agent to use create_recipient for new signups. ## Benefits - You can send bulk postcards using create_postcard without leaving your chat window. - You'll save time by querying your mailing list with list_mailing_recipients to target specific groups. - You can keep your budget in check by checking your balance with get_account_balance. - You'll stay organized by viewing all your history with list_letters and list_postcards. - You can pull detailed campaign stats with list_direct_mail_campaigns to see what's working. ## How It Works The bottom line is you can run a full physical mail operation using only natural language commands. 1. Subscribe to the Stannp MCP on Vinkius. 2. Enter your Stannp API Key into your AI client's configuration. 3. Ask your agent to send mail, list recipients, or check campaign stats. ## Frequently Asked Questions **Can I use Stannp MCP to send physical mail?** Yes, it lets you send letters and postcards directly to your customers' mailboxes through your AI agent. **Does Stannp MCP work for bulk mailing?** Yes, you can send letters and postcards to many people at once, making it great for large-scale direct mail campaigns. **How do I check my mailing list with Stannp MCP?** You can simply ask your agent to list your current mailing recipients to see who is in your database. **Can I see my mailing spend?** Yes, you can ask the agent to check your account balance at any time to stay on top of your mailing budget. **Can I manage multiple mail campaigns?** Yes, you can list all your campaigns and get specific details on any of them, including delivery status and metadata. **Is this for digital marketing?** No, this Connector is specifically for physical direct mail like postcards and letters, not for email or social media. **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.