AI Direct Mail API for Autonomous Agents
Give Claude, Cursor, LangChain, and autonomous LLM agents physical hands in the real world. Trigger postcards, handwritten letters, folded notecards, and digital gift cards straight to any doorstep using our hosted 57-tool Model Context Protocol (MCP) server or REST API.
The AI direct mail API from Thanks.io enables autonomous agents, LLMs, and developer pipelines to trigger physical postcards, handwritten letters, folded notecards, and gift cards via an official 57-tool Model Context Protocol (MCP) server or REST API with real-time QR scan webhooks.
Digital Inboxes Are Saturated.
Physical Mail Has 100% Inspection.
Autonomous outbound email and SMS bots are hitting severe carrier filters and low open rates. High-value decision makers ignore automated digital noise.
Email Inboxes & Automated SMS
AI generation has made email marginal costs near zero, leading to aggressive junk folders and spam filtering.
- Average Cold Email Open Rate< 18%
- Carrier A2P 10DLC SMS BlockingHigh Risk
- Average Recipient Attention Span1.2 Seconds
- Executive Trust LevelLow (Flagged as AI Slop)
Thanks.io Autonomous Postal Delivery
Every physical mailer delivered to an office or home is physically held, flipped, and read by the decision maker.
- Household Mail Inspection RateNear 100%
- Physical Desk & Counter Dwell TimeUp to 17 Days
- Spam Filter VulnerabilityZero (Bypasses Digital Filters)
- Tactile Sensory ImpactHeavy Linen & Realistic Pen Ink
4 Production-Ready Agentic Direct Mail Recipes
Copy and paste these exact tool calls, triggers, and templates directly into Claude, Cursor, or your autonomous agent loops.
thanksio:send-giftcard1. Autonomous Outbound Bribe ($10 Coffee Notecard)
When an AI sales agent qualifies a high-value enterprise prospect in your CRM, it automatically dispatches a folded notecard with realistic handwriting and a $10 digital Starbucks gift card to guarantee an executive meeting.
Agent Trigger & Decision Logic
Autonomous Agent Step: Prospect domain enriched, ARR >= $1M verified, and executive postal address located via company registry or Lead Feed.
Recommended Physical Format
5×4 Heavy Linen Folded Notecard + $10 Starbucks Gift Card + Real 1st-Class Stamp
Handwritten Message Copy
{
"brand": "starbucks",
"amount": 10,
"handwriting_style": "style_mom",
"recipient": {
"name": "Alex Rivera",
"address": "100 Montgomery St Ste 1200",
"city": "San Francisco",
"state": "CA",
"postal_code": "94104"
},
"message": "Alex, loved your podcast breakdown on agentic workflows. Coffee is on me while you check out our direct mail MCP integration. Scan inside to claim and grab 10 minutes on my calendar!",
"qr_url": "https://yourcompany.com/demo?lead_id=74921"
}Featured Tools from the Official 57-Tool MCP Server
Hosted at https://mcp.thanks.io/mcp with built-in schema validation, address standardization, and instant order dispatch.
send-postcardDirect Mail DispatchSend physical 4x6, 6x9, or 6x11 postcards with custom front imagery, realistic handwriting styles, and dynamic QR tracking codes.
Primary outbound outreach tool for sales agents, lead gen funnels, and customer winbacks.
send-letterDirect Mail DispatchSend multi-page standard or windowless letters with custom letterhead, realistic pen ink, and optional return envelopes.
Used for official business notices, high-trust B2B proposals, legal correspondence, and billing dunning.
send-notecardDirect Mail DispatchSend premium 5x4 folded notecards in heavy linen envelopes with a real first-class stamp and folded presentation.
Ideal for VIP customer welcomes, executive account bribes, and partner relationship building.
send-giftcardDirect Mail DispatchSend physical folded notecards embedded with genuine digital gift cards (Starbucks, Amazon, Target, Home Depot) claimable via QR scan.
Guarantees booked demo attendance and re-engages stalled high-ticket opportunities.
search-lead-topicsLead IntelligenceSearch Thanks.io's live buyer-intent database across thousands of commercial topics for active, in-market prospects.
Allows autonomous agents to identify people actively searching for specific products and services in the last 72 hours.
buy-targeted-leadsLead IntelligencePurchase verified in-market prospect addresses for $0.10 per lead, complete with full name, postal address, and verified status.
Feeds autonomous outbound direct mail engines with zero manual list buying or CSV scraping.
create-studio-designDesign & PersonalizationTrigger ThanksAI Studio to generate bespoke, print-ready direct mail artwork from a natural language prompt.
Agents dynamically compose visually stunning postcard fronts matching the prospect's brand or industry.
preview-orderAnalytics & WebhooksGenerate a high-resolution PDF and PNG digital proof of any mail piece before submitting the order to USPS print production.
Enables human-in-the-loop approval workflows or automated visual QA checks by vision-enabled LLMs.
Connect in 60 Seconds
Select your client or runtime to view the exact setup configuration.
// ~/.config/Claude/claude_desktop_config.json
{
"mcpServers": {
"thanksio": {
"url": "https://mcp.thanks.io/mcp",
"headers": {
"Authorization": "Bearer YOUR_THANKS_IO_API_TOKEN"
}
}
}
}Transparent Unit Economics vs Legacy Postal APIs
Legacy print APIs force you into $399–$450/month platform commitments before your first send. Thanks.io offers flat per-piece pricing with zero minimums.
| Provider | Monthly Plan Fee | 4×6 Postcard | 6×9 Postcard | Letter (1st Class) | Folded Notecard | Min Order | Hosted MCP |
|---|---|---|---|---|---|---|---|
| Thanks.io (Pro) | $199 / mo | $0.64 (Save 46%) | $0.99 | $0.96 | $1.89 | 1 Piece (Zero Minimums) | Hosted 57-Tool MCP + REST API |
| Thanks.io (Business) | $49 / mo | $0.77 | $1.15 | $1.15 | $2.09 | 1 Piece (Zero Minimums) | Hosted 57-Tool MCP + REST API |
| Thanks.io (Pay As You Go) | $0 / mo | $0.98 | $1.40 | $1.40 | $2.39 | 1 Piece (Zero Minimums) | Hosted 57-Tool MCP + REST API |
| Lob API | $399 / mo Minimum | $0.95 + platform fee | $1.45 + platform fee | $1.35 + platform fee | Not Supported | Volume Commitments | No Hosted MCP Server |
| Postalytics | $399 / mo (Pro Tier) | $0.89 + monthly fee | $1.39 + monthly fee | $1.49 + monthly fee | Not Supported | Account Quotas | No Hosted MCP Server |
| Handwrytten API | $0 / mo | Not Primary | Not Primary | Not Primary | $3.25 – $4.50 / piece | 1 Piece | No Hosted MCP Server |
* Rates include First-Class postage, premium heavy cardstock, and realistic handwriting styles. Updated November 2026.
Frequently Asked Questions
Everything developers and AI engineers ask when connecting Thanks.io to autonomous agent pipelines.
Give Your Autonomous Agents Real-World Physical Hands
Sign up today and get $10 in free developer sending credits. Connect the official 57-tool MCP server and start dispatching postcards directly from your terminal.