thanks.io MCP Server

Send real handwritten mail (postcards, letters, notecards) from any AI agent via thanks.io's API.

View on thanks.io

Documentation

Built for Autonomous AI Agents

Give Your AI Agents The Power To Send Real Physical Mail

The direct mail automation toolkit purpose-built for AI agents. REST API, MCP server, webhooks, and real-time tracking.

Used by AI agents built on OpenClaw, Viktor, and other autonomous platforms to send handwritten postcards, letters, and gift cards without human intervention.

Get API Key & $10 FreeExample OpenClaw SkillRead the Docs

Why AI Agents Need Physical Mail

Email inboxes are crowded. Digital ads get ignored. Physical mail gets a 90%+ open rate and sits on desks for weeks. Your AI agents can now access the highest-converting channel available.

90%+

Open Rate

Physical mail gets opened. Email averages 20%.

5-9x

Response Rate

Direct mail response rates vs. digital channels.

17 days

Lifespan

Average time a mailpiece stays in the home.

Three Ways To Connect Your AI Agents

Whether your AI agents speak REST, MCP, or use an automation platform, thanks.io has you covered.

REST API

Full OpenAPI spec. Send mail, manage lists, track orders. Works with any language or framework.

View API Docs

MCP Server

Connect thanks.io directly to Claude, OpenClaw, or any MCP-compatible AI agents with a single URL.

Add MCP Server

Zapier / Make / n8n

No-code connectors for AI agents that orchestrate through automation platforms. 8,000+ app integrations.

Browse Integrations

Send Mail in Minutes

A single API call is all your AI agents need. Full OpenAPI spec available for automatic tool generation.

REST API - Send a Postcard

curl -X POST "https://api.thanks.io/api/v2/send/postcard" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "recipients": [{
      "name": "Jane Smith",
      "address": "123 Main St, Austin, TX 78701"
    }],
    "message": "Hi %FIRST_NAME% - Thanks for being a loyal customer!",
    "front_image_url": "https://your-image-url.com/front.png"
  }'

MCP Server - Connect Your Agent

// Add thanks.io MCP server to your agent
// Remote URL:
https://docs.thanks.io/mcp

// Or install locally:
npx mint-mcp add thanksio

OpenClaw & Viktor AI agents can connect directly via the MCP server URL or REST API. Your AI agents get full access to send postcards, letters, notecards, manage mailing lists, and track deliveries.

Everything Your AI Agents Need

A complete toolkit for sending, tracking, and automating physical mail. All accessible via API.

Send Any Mailpiece

Postcards, letters, notecards, and more. Your AI agents pick the format, write the message, and send it via a single API call.

POST /api/v2/send/postcard

Mailing List Management

Create and manage mailing lists, add recipients, and trigger automated campaigns. The easiest integration path for AI agents.

POST /api/v2/recipients

AI Realistic Handwriting

Proprietary handwriting engine creates notes that recipients believe are personally written. Includes authentic crossouts for maximum believability.

message parameter with handwriting styles

Dynamic QR Tracking

Generate unique QR codes per recipient. Track scans in real-time and let AI agents trigger follow-up actions when a recipient engages.

Automatic with every mailpiece

Gift Card Enclosures

Include physical or digital gift cards with any mailpiece. Starbucks, Amazon, Visa, and more. Perfect for customer win-back flows.

gift_card parameter on send

Webhooks & Events

Get real-time notifications for QR scans, delivery confirmations, and failures. AI agents can react instantly to physical mail events.

Configurable webhook URLs

What Your AI Agents Can Do

Real workflows that autonomous AI agents are running today with thanks.io.

Lead Follow-Up

AI agents detect a new lead, send a handwritten postcard within minutes. No human intervention needed.

1

CRM triggers lead event

2

AI agents call thanks.io API

3

Handwritten card arrives in 3-5 days

4

Webhook notifies on QR scan

Customer Win-Back

AI agents identify churned customers and automatically send a gift card with a personal note.

1

AI agents query inactive accounts

2

Select gift card + message

3

Send via thanks.io API

4

Track engagement via webhooks

Post-Purchase Thank You

After every order, your AI agents send a handwritten thank-you note to drive repeat business.

1

Order completion triggers AI agents

2

Agents personalize message

3

Notecard sent automatically

4

QR code tracks recipient response

Event-Driven Campaigns

Birthday cards, anniversaries, contract renewals. AI agents never forget a date.

1

AI agents monitor date triggers

2

Select appropriate template

3

Add personalization tokens

4

Mail sent on schedule automatically

Works With The AI Agents You Already Use

Whether you're building with OpenClaw, Viktor, or your own custom AI agents, thanks.io integrates seamlessly.

šŸ¦ž

OpenClaw

Autonomous Personal AI Agent

OpenClaw AI agents run autonomously across WhatsApp, Slack, Discord, and more. Connect the thanks.io MCP server and your OpenClaw AI agents can send handwritten mail, manage recipient lists, and track delivery status without any human in the loop.

  • MCP server integration
  • Send mail from any chat channel
  • Autonomous follow-up workflows
  • Real-time webhook notifications

Viktor

AI Coworker in Slack

Viktor lives in your Slack workspace and executes tasks autonomously. Connect thanks.io and Viktor can send direct mail to leads, customers, and prospects directly from Slack conversations. Tell Viktor to send a thank-you card and it handles the rest.

  • REST API integration via tools
  • Send mail from Slack commands
  • Connects to 3,000+ other tools
  • Persistent memory across sessions

Your Custom AI Agents

Building your own AI agents? The thanks.io REST API and OpenAPI spec make it simple to add direct mail as a tool. Any AI agents that can make HTTP requests can send physical mail in minutes.

Get Your AI Agents Sending Mail in 5 Minutes

1

Create a thanks.io Account & API Key

Sign up at thanks.io and generate your API key from the dashboard. Enable test mode to send test orders while building.

2

Connect Your AI Agents

Add the MCP server URL, configure the REST API as a tool, or connect through Zapier/Make/n8n. Full OpenAPI spec available for automatic tool generation by AI agents.

3

Send Your First Mailpiece

Your AI agents call the API with a recipient address and message. We handle printing, handwriting, postage, and USPS delivery. Track everything via webhooks.

What Your AI Agents Can Send

Real handwritten mail, printed and sent by USPS. Your AI agents control every detail.

Our proprietary engine creates handwritten postcards, letters, and notecards that recipients believe are personally written. The "realism" mode includes authentic crossouts for maximum believability.

Your AI agents select the handwriting style via the API

Postcards & Letters

4x6 and 6x9 postcards, multi-page letters with envelopes. Your AI agents specify the format, message, and front image via a single API call.

Postcards from $1.13Letters from $2.49

Include Starbucks, Amazon, Visa, and other gift cards with any mailpiece. Perfect for win-back, thank-you, and referral campaigns.

90%+ open ratesNotecards from $2.09

Automated Campaigns

Add recipients to mailing lists via API and let thanks.io handle the campaign logic, scheduling, and multi-touch sequences automatically.

Fully automated workflows

Hyper-Personalization

Use dynamic variables for names, addresses, custom fields, and even recipient-specific images. Your AI agents can personalize every detail.

AI-powered personalization

Ready To Give Your AI Agents Superpowers?

Join the growing number of teams using AI agents with thanks.io to bridge the digital-physical gap. Get started with $10 free credit.

Get API Key & $10 FreeRead the DocsSchedule API Consult