# Poplar MCP for AI Agents AI Agent Connect > Poplar MCP for AI Agents lets you automate your physical mail campaigns directly from your AI agent. You can trigger postcards, verify US mailing addresses, and manage your audience lists without leaving your chat interface. It handles the tedious work of data cleaning and list management, allowing you to focus on your growth strategy. Whether you are sending out win-back letters or tracking the ROI of a high-value mailer, Poplar connects your agent to the entire physical outreach lifecycle. ## Overview - **Category:** marketing-automation - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_wjdR2dT38sZaHT3kHkl8b02xmhEnARQ2SQFjEIIE/ai-agent-connect - **Tags:** direct-mail, programmatic-marketing, address-verification, physical-outreach, campaign-tracking, automation ## Description Poplar lets you run your entire physical outreach strategy through a conversation with your AI agent. Instead of jumping between tabs to check campaign status or verify if a zip code is valid, you just tell your agent what needs to happen. It handles the heavy lifting of cleaning US addresses, adding people to your mailing lists, and triggering the actual mailers. You can even report sales back to the system so you know exactly which postcards actually moved the needle. It's a big shift from manual data entry to just giving directions. You can find this and thousands of other connectors in the Vinkius catalog to keep your marketing stack connected. ## Tools ### report_transaction Send customer order data back to Poplar for attribution tracking. This lets you see the real ROI of your physical mail. ### trigger_physical_mailer Send a postcard or letter to a recipient using a specific campaign ID. This is the core action for your physical outreach. ### add_to_audience Put a new person onto one of your existing mailing lists. This keeps your audience data current and ready for use. ### add_to_suppression_list Add a name to your global Do Not Mail list to stay compliant. It ensures you never mail someone who opted out. ### get_api_profile View the basic details of your connected account. Use this to confirm your connection is active and correct. ### get_mailer_status Check where a specific postcard or letter is in the production process. This helps you stay on top of your delivery timeline. ### list_audiences See every mailing list currently saved in your Poplar account. Use this to identify the right groups for your next campaign. ### list_billing_history Pull up your past invoices and billing data. This keeps your marketing spend organized in one place. ### list_marketing_campaigns View all your active and past direct mail campaigns. It's the fastest way to see what's currently in flight. ### list_mail_creatives Browse all the different designs and layouts you have uploaded. You can pick the right creative for your next mailer easily. ### standardize_us_address Clean and verify a US mailing address to ensure it's deliverable. This prevents wasted postage on bad data. ## Prompt Examples **Prompt:** ``` Send a postcard to Jane Doe using campaign ID 'camp_123'. ``` **Response:** ``` I've started the process for campaign camp_123. To trigger the mailer, I need Jane Doe's full mailing address (street, city, state, zip). Once provided, I'll send the request to Poplar. Should I also include any custom merge tags? ``` **Prompt:** ``` Standardize this address: 123 main st, nyc, ny 10001. ``` **Response:** ``` Standardizing... Poplar has verified the address. The correct USPS format is: '123 MAIN ST, NEW YORK, NY 10001-4107'. The address is valid and deliverable. Would you like to add this recipient to an audience list? ``` **Prompt:** ``` List all active audiences and find 'Holiday VIPs'. ``` **Response:** ``` Retrieving audiences... I found 4 groups in your account, including 'Holiday VIPs' (ID: aud_552) with 1,200 members. Other audiences are 'New Signups', 'Churn Risks', and 'Global Suppressions'. Should I list the members of 'Holiday VIPs'? ``` ## Capabilities ### Trigger physical mailers Send postcards or letters to specific recipients instantly with your agent. ### Standardize addresses Clean and verify US mailing data before it hits the mail to prevent delivery issues. ### Manage mailing audiences Add new people to your lists or view your current groups via simple chat commands. ### Track campaign status See the real-time production and delivery status of your mailers in one place. ### Report sales data Send transaction info back to the system to track your campaign's ROI accurately. ### Manage suppression lists Add recipients to a global Do Not Mail list to keep your outreach compliant. ### Browse mail creatives View all the different designs and layouts you have uploaded to your account. ## Use Cases ### Churn Prevention A retention manager asks the agent to send a win-back postcard to 50 customers who haven't ordered in 3 months using trigger_physical_mailer. ### Lead Nurturing A growth marketer tells the agent to mail a physical brochure to high-value leads who visited the pricing page by adding them to a list with add_to_audience. ### E-commerce Attribution An owner reports a sale back to Poplar to see if a recent direct mail campaign worked by using report_transaction. ### Bulk Address Cleanup A user provides a messy list of addresses and asks the agent to verify them all via the standardize_us_address tool. ## Benefits - Automate mailers: Use trigger_physical_mailer to send postcards without manual CSV uploads. - Clean data: Use standardize_us_address to fix messy addresses before they hit the mail. - Manage lists: Use add_to_audience and list_audiences to keep your targets organized in real time. - Track ROI: Use report_transaction to see which postcards actually drive sales and conversions. - Stay compliant: Use add_to_suppression_list to keep your Do Not Mail list updated automatically. - View creatives: Use list_mail_creatives to quickly identify the best designs for your current campaign. ## How It Works The bottom line is you stop copy-pasting addresses and start sending physical mail through a simple conversation. 1. Connect your Poplar access token to your AI client through the Vinkius marketplace. 2. Tell your agent to perform a task, like cleaning a list or triggering a specific mailer. 3. Receive confirmation of the delivery status or a summary of the completed mailing task. ## Frequently Asked Questions **Can I send postcards with the Poplar MCP?** Yes, you can trigger postcards or letters to specific recipients directly through your AI agent by providing a campaign ID and the recipient's details. **How does the Poplar MCP handle messy addresses?** The Connector includes a dedicated tool to clean and verify US mailing addresses. It formats them into the correct USPS standard so your mail actually gets delivered. **Can I track my ROI with the Poplar MCP?** Yes, you can report customer transactions back to Poplar through your agent. This allows you to see which mailers are actually driving revenue. **How do I manage my mailing lists using the Poplar MCP?** You can ask your agent to list all your current audiences, view specific members, or add new people to your mailing lists using simple voice or text commands. **Is the Poplar MCP good for e-commerce?** It's excellent for e-commerce because it lets you connect your sales data to your physical mail campaigns, helping you see which mailers drive the most orders. **Can I see my billing history through the Poplar MCP?** Yes, you can ask your agent to pull up your past invoices and billing data from your Poplar account at any time. **How do I get my Poplar Access Token?** Log in to your Poplar account and navigate to the **API Settings** or **Developer** section. You will find your Access Token there. Use a Test Token for development and a Production Token for live mailings. **Can I standardize non-US addresses?** No, Poplar's address standardization service is specifically designed for US addresses only. For international mailing, ensure your addresses are pre-formatted correctly. **How can I check if a mailer has been delivered?** Use the `get_mailer_status` tool with the unique mailer ID. It will return the current status, including production phases and the final USPS delivery confirmation when available. **Is the integration secure for customer addresses?** Absolutely. The integration uses official Poplar Bearer tokens over HTTPS. Your credentials and customer data are encrypted and stored securely within the Vinkius Cloud infrastructure.