How to Use the BulkSMS MCP in Pydantic AI

Q: Can Pydantic AI send BulkSMS messages?

Your agent invokes sendsms or sendbulksms as a tool. The request is validated before it hits the BulkSMS gateway to ensure everything is correct.

Q: Does Pydantic AI support BulkSMS group tools?

Your agent uses listgroups and listgroupmembers to fetch data. The resulting lists are validated against your types before the agent performs any further processing.

Use Pydantic AI to send verified SMS messages via the BulkSMS MCP server.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect BulkSMS MCP to Pydantic AI

Create your Vinkius account to connect BulkSMS to Pydantic AI and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup BulkSMS with Pydantic AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Pydantic AI validates BulkSMS responses

Every message sent via `send_sms` is validated against your Pydantic schemas. If the API returns a malformed response, your agent crashes before it can act on bad data. This type-safe approach ensures `send_bulk_sms` operations always follow your strict formatting rules. You get absolute confidence that your agent isn't hallucinating message parameters.

Track BulkSMS status in Pydantic AI

Your agent calls `get_message` to retrieve status updates for specific notifications. Because Pydantic AI enforces strict typing, the returned status is guaranteed to match your expected model. Monitoring `list_messages` allows your agent to audit your sent history. It flags discrepancies immediately if the returned message structure deviates from your defined schema.

Pydantic AI manages BulkSMS accounts

The `get_profile` tool provides your agent with a validated credit balance. Your agent refuses to run if the returned balance doesn't conform to your strict float or integer expectations. Using `get_account_info` provides metadata about your setup. Your agent uses this data to update its internal state, ensuring your messaging logic stays aligned with your actual BulkSMS account settings.

Setup guide

Set up BulkSMS MCP in Pydantic AI

Prerequisites

Python 3.10+ installed
pydantic-ai-slim[fastmcp] package
Active Vinkius subscription with a valid endpoint token

1

Install Pydantic AI with FastMCP
Run pip install "pydantic-ai-slim[fastmcp]". The FastMCP toolset replaces the deprecated MCPServerHTTP class with full protocol support.
2

Configure the FastMCPToolset
Pass a JSON-style config dict to FastMCPToolset with your Vinkius URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. Supports Streamable HTTP, SSE, and Stdio transports.
3

Create and run your agent
Pass the toolset to Agent(toolsets=[toolset]) and call agent.run(). Swap openai:gpt-4o for any supported model — Anthropic, Google, Mistral, or Groq.

agent.py

from pydantic_ai import Agent
from pydantic_ai.toolsets.fastmcp import FastMCPToolset

toolset = FastMCPToolset({
    "mcpServers": {
        "bulksms-mcp": {
            "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
        }
    }
})

agent = Agent(
    "openai:gpt-4o",
    toolsets=[toolset],
    system_prompt="You have access to BulkSMS tools.",
)

result = await agent.run("List recent BulkSMS transactions")
print(result.output)

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by BulkSMS. 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.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect BulkSMS now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about BulkSMS MCP in Pydantic AI

Every tool output is passed through a Pydantic model. If the BulkSMS response doesn't match your schema, the agent throws a validation error.

Your agent invokes `send_sms` or `send_bulk_sms` as a tool. The request is validated before it hits the BulkSMS gateway to ensure everything is correct.

Your agent uses `list_groups` and `list_group_members` to fetch data. The resulting lists are validated against your types before the agent performs any further processing.

You connect via an HTTP or SSE transport provided by Vinkius. Your agent uses this managed connection to talk to the server without needing hardcoded keys.

Your credentials are shielded by the Vinkius platform. The server only exposes the specific tools you need, and all data exchange is ephemeral, protecting your account details from unauthorized access.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript