Bring Direct Mail
to Pydantic AI
Create your Vinkius account to connect Handwrytten to Pydantic AI and start using all 10 AI tools in minutes. Fully managed, enterprise secure, and ready to use without writing a single line of code. No hosting, no server setup — just connect and start using.
Compatible with every major AI agent and IDE
What is the Handwrytten MCP Server?
Connect your Handwrytten account to any AI agent and take full control of your physical outreach and relationship management through natural conversation.
What you can do
- Card Selection — Browse and list all available stationery and card categories for any occasion.
- Font Management — List and select from various realistic handwriting styles to personalize your notes.
- Order Automation — Send single or bulk handwritten cards with personalized messages directly from the chat.
- Address Book Access — Manage your saved recipients and retrieve address details for quick sending.
- Credit Monitoring — Instantly check your account credit balance to manage your outreach budget.
- Template Insights — Browse your message templates to maintain brand consistency in your physical mail.
How it works
- Subscribe to this server
- Enter your Handwrytten API Key (found in Settings > API Keys)
- Start sending handwritten notes from Claude, Cursor, or any MCP-compatible client
No more manual data entry or ordering through the web interface. Your AI assistant acts as a dedicated outreach coordinator or relationship manager.
Who is this for?
- Sales & Marketing Teams — automate personalized follow-ups and high-touch outreach campaigns.
- Customer Success Managers — send 'Thank You' or 'Birthday' cards to clients without leaving the CRM flow.
- Executive Assistants — manage the sending of physical holiday or appreciation cards effortlessly.
Built-in capabilities (10)
Check current account credit balance
Get details for a specific order
List recipients in your address book
List all available cards/stationery
List all card categories
List all available handwriting fonts
List available gifts that can be included with cards
List history of card orders
List message templates
Requires card_id, font_id, message, and recipient details. Send a single handwritten card
Why Pydantic AI?
Pydantic AI validates every Handwrytten tool response against typed schemas, catching data inconsistencies at build time. Connect 10 tools through Vinkius and switch between OpenAI, Anthropic, or Gemini without changing your integration code. full type safety, structured output guarantees, and dependency injection for testable agents.
- —
Full type safety: every MCP tool response is validated against Pydantic models, catching data inconsistencies before they reach your application
- —
Model-agnostic architecture. switch between OpenAI, Anthropic, or Gemini without changing your Handwrytten integration code
- —
Structured output guarantee: Pydantic AI ensures tool results conform to defined schemas, eliminating runtime type errors
- —
Dependency injection system cleanly separates your Handwrytten connection logic from agent behavior for testable, maintainable code
Handwrytten in Pydantic AI
Why run Handwrytten with Vinkius?
The Handwrytten connection runs on our fully managed, secure cloud infrastructure. We handle the hosting, maintenance, and security so you don't have to deal with servers or code. All 10 tools are ready to work instantly without any complex setup.
You stay in complete control of your data. Your AI only accesses the information you approve, keeping your sensitive passwords and private details completely safe. Plus, with automatic optimizations, your AI works faster and more efficiently.

* Every connection is hosted and maintained by Vinkius. We handle the security, updates, and infrastructure so you don't have to write code or manage servers. See our infrastructure
Over 4,000 integrations ready for AI agents
Explore a vast library of pre-built integrations, optimized and ready to deploy.
Connect securely in under 30 seconds
Generate tokens to authenticate and link external services in a single step.
Complete visibility into every agent action
Audit live requests, latency, success rates, and active security compliance policies.
Optimize spending and track token ROI
Analyze real-time token consumption and cost metrics detailed by connection.




Explore our live AI Agents Analytics dashboard to see it all working
This dashboard is included when you connect Handwrytten using Vinkius. You will never be left in the dark about what your AI agents are doing with your tools.
Handwrytten and 4,000+ other AI tools. No hosting, no code, ready to use.
Professionals who connect Handwrytten to Pydantic AI through Vinkius don't need to write code, manage servers, or worry about security. Everything is pre-configured, secure, and runs automatically in the background.
Raw MCP | Vinkius | |
|---|---|---|
| Ready-to-use MCPs | Find and configure each manually | 4,000+ MCPs ready to use |
| Connection Setup | Manual coding & server setup | 1-click instant connection |
| Server Hosting | You host it yourself (needs 24/7 uptime) | 100% hosted & managed by Vinkius |
| Security & Privacy | Stored in plaintext config files | Bank-grade encrypted vault |
| Activity Visibility | Blind execution (no logs or tracking) | Live dashboard with real-time logs |
| Cost Control | Runaway AI token spend risk | Automatic budget limits |
| Revoking Access | Must delete files or code to stop | 1-click disconnect button |
How Vinkius secures
Handwrytten for Pydantic AI
Every request between Pydantic AI and Handwrytten is protected by our secure gateway. We automatically keep your sensitive data private, prevent unauthorized access, and let you disconnect instantly at any time.
Frequently asked questions
How do I find my Handwrytten API Key?
Log in to your Handwrytten dashboard, go to Settings, and then to the API Keys section. You can generate a new key or copy your existing one from there.
Can I use realistic handwriting fonts?
Yes! Handwrytten uses robots with real pens. You can list all available styles using the list_fonts tool and specify the font_id when sending a card.
How do I check if my card was sent?
Use the list_orders tool to see your history of sent cards or get_order with a specific order ID to check its current fulfillment status.
Is it possible to include gifts with the cards?
Yes, Handwrytten offers various gifts. You can list available items using the list_gifts tool and include the gift ID in your order request.
How does Pydantic AI discover MCP tools?
Create an MCPServerHTTP instance with the server URL. Pydantic AI connects, discovers all tools, and generates typed Python interfaces automatically.
Does Pydantic AI validate MCP tool responses?
Yes. When you define result types as Pydantic models, every tool response is validated against the schema. Invalid data raises a clear error instead of silently corrupting your pipeline.
Can I switch LLM providers without changing MCP code?
Absolutely. Pydantic AI abstracts the model layer. your Handwrytten MCP integration works identically with OpenAI, Anthropic, Google, or any supported provider.
MCPServerHTTP not found
Update: pip install --upgrade pydantic-ai
Explore More MCP Servers
View all →
Strava Social
10 toolsExplore Strava activities feed, kudos, comments, clubs, and discover new segments.

Cyberimpact
12 toolsEmail marketing automation with Cyberimpact.

Easemob / 环信
10 toolsPioneer massive scale IM Chat SDK and API — manage users, groups, and real-time messaging via AI.

Reportei
10 toolsGenerate marketing performance reports from Google, Facebook, and Instagram data in minutes for client presentations.
