Bring Cross Channel Marketing
to Pydantic AI
Create your Vinkius account to connect Cordial 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.
GDPR Free for SubscribersCompatible with every major AI agent and IDE
Gemini
What is the Cordial MCP Server?
Integrate Cordial, the cross-channel marketing platform, directly into your AI workflow. Manage your audience segments, trigger automated messages, and monitor campaign performance using natural language.
What you can do
- Audience Management — List and search for subscribers, and update profile attributes seamlessly.
- Campaign Monitoring — Track the performance of batch and transactional email/SMS campaigns.
- Automation Control — Monitor and manage active message automation workflows.
- Data Insights — Access supplementary data collections and account metadata via chat.
How it works
- Connect the Cordial integration to your AI assistant.
- Authorize using your Cordial API Key.
- Orchestrate your marketing operations through intuitive conversation.
Who is this for?
- CRM Managers — Quickly update subscriber data or check segment sizes.
- Email Marketers — Monitor real-time open and click rates for active campaigns.
- Marketing Operations — Audit automation workflows and supplementary data tables.
Built-in capabilities (10)
Resolves system-level account identifiers, plan configuration, and core platform settings. Get metadata about your Cordial account
Resolves granular profile data including custom attributes, device tokens, and list memberships. Get full profile and attributes for a subscriber
Resolves list identity properties such as segment IDs, names, and subscriber counts. List contact segments and audience groups
Resolves active automated message definitions and workflow status for triggered communications. List active automated message workflows
Resolves contact identity properties including email addresses, channel opt-ins, and attribute metadata across the Cordial system boundary. List subscribers in Cordial
Resolves campaign identity and status, including scheduling data and high-level performance indicators. List marketing campaigns and their performance
Resolves batch and transactional message definitions, including templates, subject lines, and sender profiles. List batch and transactional messages
Resolves metadata for custom data collections used for message personalization. List supplement collections (external data tables)
Resolves a subset of campaigns matching the name criteria across the platform boundary. Search for marketing campaigns by name
Creates or updates a profile with identity properties, channel preferences, and custom attributes. Create or update a subscriber profile
Why Pydantic AI?
Pydantic AI validates every Cordial 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 Cordial integration code
- —
Structured output guarantee: Pydantic AI ensures tool results conform to defined schemas, eliminating runtime type errors
- —
Dependency injection system cleanly separates your Cordial connection logic from agent behavior for testable, maintainable code
Cordial in Pydantic AI
Why run Cordial with Vinkius?
The Cordial 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 Cordial using Vinkius. You will never be left in the dark about what your AI agents are doing with your tools.
Cordial and 4,000+ other AI tools. No hosting, no code, ready to use.
Professionals who connect Cordial 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
Cordial for Pydantic AI
Every request between Pydantic AI and Cordial 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 get a Cordial API Key?
Log in to your Cordial account, go to Settings > API Keys, and create a new key. Ensure you have the necessary permissions to manage contacts and messages.
Can the agent trigger batch campaigns?
This integration currently focuses on listing and monitoring campaigns. To trigger sends, you should use the Cordial dashboard or specific automation workflows.
What profile attributes can the agent update?
The agent can update any custom attributes defined in your Cordial schema, as well as channel subscription preferences, as long as the API Key has write access.
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 Cordial 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 →
Sellsy
12 toolsEquip your AI agent with full read access to your Sellsy CRM to audit deals, generate invoices overviews, and prospect natively.
PokéAPI
20 toolsAccess Pokémon data, stats, abilities, types, and evolution chains via AI.
BCB Juros — Selic, CDI e Expectativas Focus
4 toolsBrazilian interest rates: Selic target rate (COPOM decisions), daily effective Selic rate, CDI (interbank deposit certificate rate), and Focus Survey market expectations for future Selic rates from Brazil's Central Bank.
Reportei
10 toolsGenerate marketing performance reports from Google, Facebook, and Instagram data in minutes for client presentations.