Poplar MCP. Automate Physical Direct Mail from your AI Agent
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
Poplar connects your AI agent directly to programmatic direct mail services. This server lets you trigger physical mailers—postcards or letters—by providing a campaign ID and recipient details in plain language.
You can standardize US addresses before mailing, manage entire audience lists (adding members or applying suppression flags), and track the whole workflow from list prep to final delivery status.
It handles all your high-touch physical outreach directly through conversation.
What your AI agents can do
Add to audience
Adds a specified recipient to an existing mailing audience list in your account.
Add to suppression list
Places a recipient on the global 'Do Not Mail' list, preventing them from receiving future physical mailers.
Get api profile
Retrieves basic information about your Poplar account after authentication.
Takes raw address fields (like street and city) and returns a verified, USPS-compliant format for guaranteed deliverability.
Uses a campaign ID and recipient data to send physical mail pieces—postcards or letters—through Poplar's system.
Allows you to list all existing audiences, add new members by email/address, or apply a global 'Do Not Mail' flag using add_to_audience or add_to_suppression_list.
Retrieves real-time data on a specific mailer run, showing its production and delivery status via get_mailer_status.
Sends customer order details back into Poplar using report_transaction, connecting physical mailing costs to measurable revenue.
Ask AI about this MCP
Supported MCP Clients
OAuth 2.0 Compatible Gemini Waiting for input…
Poplar MCP Server: 11 Tools for Physical Marketing
These tools let your AI client handle every step of programmatic direct mail—from cleaning addresses to triggering the final postcard send and tracking sales.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using Poplar on Vinkius019d75f7add to audience
Adds a specified recipient to an existing mailing audience list in your account.
019d75f7add to suppression list
Places a recipient on the global 'Do Not Mail' list, preventing them from receiving future physical mailers.
019d75f7get api profile
Retrieves basic information about your Poplar account after authentication.
019d75f7get mailer status
Checks the current production and delivery status for a specific physical mailer campaign ID.
019d75f7list audiences
Lists all mailing audiences you have set up in your Poplar account.
019d75f7list billing history
Provides a summary of your account's billing and invoice data.
019d75f7list mail creatives
Retrieves a list of all physical mailer designs or templates you have uploaded to Poplar.
019d75f7list marketing campaigns
Lists every direct mail campaign ID currently active in your account.
019d75f7report transaction
Sends a customer order's transaction details back to Poplar so you can track its return on investment (ROI).
019d75f7standardize us address
Cleans and verifies a US mailing address, returning the correct format for high deliverability.
019d75f7trigger physical mailer
Sends out actual physical mail (postcard or letter) when provided with a campaign ID and recipient details.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Poplar, then connect any of our 4,800+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,800+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Poplar. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 11 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Preparing mailing lists shouldn't require manual formatting or multiple dashboard tabs.
Right now, building a list of people to mail is a nightmare. You grab a list from the CRM—it's messy. Addresses are inconsistent; some use ZIP codes, others use full 9-digit formats. Before you can even think about mailing it, you have to spend hours cleaning and validating every single entry in a spreadsheet.
With Poplar MCP Server, that whole process disappears. You just tell your agent the raw data, and it uses `standardize_us_address` instantly. It validates and formats everything into USPS-compliant records. The list is clean before you ever run the mailer.
Poplar MCP Server: Trigger physical mailers with one conversation.
Previously, triggering a campaign meant logging into Poplar's portal, selecting a creative ID from `list_mail_creatives`, finding the target audience ID via `list_audiences`, and then finally manually initiating the send. It was three different systems and four clicks.
Now, you just ask your agent to 'Send Campaign X to Audience Y.' The agent runs all those steps—validation, targeting, and triggering—in sequence. You get the mailer sent without lifting a finger.
What you can do with this MCP connector
Poplar hooks your AI agent right into programmatic direct mail services. This isn't some basic API wrapper; it lets you trigger actual physical campaigns—postcards or letters—by talking to the system in plain language. You use this server when you need to manage high-touch, real-world outreach without lifting a finger.
To get started, your agent first runs get_api_profile after authentication; that just verifies your Poplar account details. Then, it gets down to business by making sure your list and addresses are solid before any physical mail goes out.
If you're dealing with raw address fields—like a street name or city—your agent uses standardize_us_address to clean up the data. This function verifies the US mailing format, giving you USPS-compliant results that guarantee high deliverability rates for your campaign.
When it comes to building your target list, you have full control over who sees your mail. Your agent can pull a complete roster of all existing audience groups using list_audiences. You'll need to add new people by running add_to_audience, or if someone shouldn't get physical mail ever again, it hits the global 'Do Not Mail' list with add_to_suppression_list.
Once your list is prepped and validated, you execute the campaign. To send out actual physical pieces, your agent runs trigger_physical_mailer, which requires just a campaign ID and recipient data to fire off postcards or letters through Poplar's system. You can also check what creative materials are available by pulling a list using list_mail_creatives.
Monitoring the run is easy. To see if production started, or where the mailers stand in delivery, your agent checks the status with get_mailer_status, referencing a specific campaign ID. You can also pull up every active direct mail effort by calling list_marketing_campaigns and get an overview of your account’s finances using list_billing_history.
Finally, you close the loop on revenue tracking. When a customer places a physical order related to your mailing campaign, your agent sends those transaction details back into Poplar using report_transaction, letting you directly connect the cost of the mailer to measurable return on investment.
019d75f7-d2bf-7222-a135-09d94e4ac0cd 
How Poplar MCP Works
- 1 First, you connect your AI client and supply the Poplar Access Token.
- 2 Next, your agent runs a sequence of tools—for example, first calling
standardize_us_addresson raw data, then usingadd_to_audienceto build the final list. - 3 Finally, the agent executes
trigger_physical_mailer, sending the validated mailing data to Poplar for deployment.
The bottom line is: your AI client handles the entire physical marketing pipeline—from dirty addresses to printed mailer tracking—without you having to run multiple API calls manually.
Who Is Poplar MCP For?
This server is for growth marketers and e-commerce owners who realize that digital funnels aren't enough. If your strategy relies on physical follow-ups, this saves you hours of list management and address formatting. It’s built for the marketing ops engineer tired of jumping between CRM dashboards just to validate a mailing list.
Automates high-touch physical follow-ups, ensuring that abandoned cart users or high-value leads get a postcard sent out quickly.
Runs 'win-back' campaigns by targeting lists of churning customers and triggering physical mailers directly from the AI conversation flow.
Tracks the effectiveness (ROI) of direct mail by running report_transaction to send sale data back for attribution against campaigns.
What Changes When You Connect
- Stop Guessing on Addresses: Use
standardize_us_addressto guarantee every mailing address is in USPS-compliant format. This isn't just cleaning; it’s making the mail physically deliverable, reducing bounce rates. - Manage Lists Without Spreadsheets: You don't need CSV uploads for list maintenance. The AI agent handles adding users (
add_to_audience) or opting people out (add_to_suppression_list) directly from conversation. - Full Campaign Visibility: Easily check the status of mailers using
get_mailer_statusand review all available designs withlist_mail_creatives. You see exactly where every campaign stands. - Close the Loop on ROI: Don't just send mail—track it. Run
report_transactionto pipe sale data back into Poplar, finally connecting your physical marketing costs to actual revenue numbers. - Control Your Audience Flow: Use
list_audiencesandadd_to_audiencetogether to segment leads based on criteria (e.g., 'VIPs who haven't bought in 90 days') before triggering the mailer.
Real-World Use Cases
The Win-Back Campaign
A retention manager needs to send a postcard to customers inactive for six months. They ask their agent: 'Find all users in the 'Lapsed' audience and trigger a win-back mailer.' The agent first runs list_audiences to confirm the group, then uses trigger_physical_mailer, completing the outreach without manual steps.
The Dirty Data Cleanup
An e-commerce owner gets a list of 500 addresses copied from an old source. They ask their agent to validate it. The agent calls standardize_us_address on each record, cleaning up state abbreviations and zip codes, making the entire batch ready for mailing.
Tracking Campaign Success
A growth marketer runs a high-value mailer campaign. Later, they receive sales data for those recipients. They tell their agent to report the orders back using report_transaction. This action closes the loop by linking physical spend to measurable profit.
Compliance and Opt-Outs
The marketing team needs to respect new compliance rules. Instead of manually updating lists, they instruct their agent to run add_to_suppression_list for any user who calls customer service and requests opt-out status.
The Tradeoffs
Trying to send mail from a spreadsheet
A user downloads the recipient list as a CSV, manually maps columns (Street, City, State), and then has to use Poplar's web interface to upload it before running the campaign.
→
Don't touch spreadsheets. Just ask your agent: 'Send a postcard using campaign ID X for these recipients.' The agent handles all validation and list building internally using standardize_us_address and trigger_physical_mailer.
Ignoring the global opt-out list
The team runs a general mailing campaign, but accidentally includes recipients who have previously requested they stop receiving mail. This wastes money and violates compliance.
→
Always check add_to_suppression_list first. The agent confirms that any recipient you add to the active list has not been marked for suppression.
Confusing listing with action
A user runs list_marketing_campaigns and sees a campaign ID, but then forgets the required format or needs to check its actual delivery status. They can't proceed.
→
After using list_marketing_campaigns, immediately follow up with get_mailer_status to confirm if that specific campaign is ready for recipients and deployment.
When It Fits, When It Doesn't
Use this server if your marketing strategy requires physical mailers (postcards, letters) as a core part of the customer journey. You need programmatic control over address validation, audience list management, and real-time delivery tracking.
Don't use it if you only run digital campaigns (e.g., email blasts or paid ads). In that case, an Email Service Provider integration is better suited. However, even if your primary channel is digital, you should still use this server for its list management tools—specifically add_to_audience—because keeping clean, verified contact data is always valuable.
If you find yourself doing a mix of physical and digital outreach, Poplar handles the difficult part: connecting those two worlds with precise data flows.
Common Questions About Poplar MCP
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.
How do I use the `list_billing_history` tool with Poplar? +
You can view your account's complete spending details. The tool pulls all invoice data and billing records directly from your Poplar dashboard, helping you track usage across different campaigns.
If I use `standardize_us_address`, what happens when my input address format is incorrect? +
The function returns a structured error detailing exactly why the USPS validation failed. It won't process invalid addresses, allowing your agent to correct the source data before retrying.
How does using the `add_to_suppression_list` tool ensure I manage opt-outs correctly? +
It immediately adds recipients to Poplar's global 'Do Not Mail' list. This action prevents any future physical mailer from targeting that specific individual, ensuring compliance.
Are there rate limits when I use `trigger_physical_mailer`? +
Poplar manages standard API rate limits to ensure stability across all users. The server handles throttling if you exceed established thresholds, automatically pausing and retrying the request.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.