How to Use the BulkSMS.com MCP in Vercel AI SDK

Q: Can I view BulkSMS.com message history in Vercel AI SDK?

Yes, just call listmessages. The data returns in your stream and you can map it to your React components effortlessly.

Q: How do I handle errors when sending texts?

Catch the tool output in your client logic. If sendbulksms fails, you can log the error or prompt your agent to try again.

Stream BulkSMS.com delivery updates directly into your Vercel AI SDK frontend for live user feedback.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect BulkSMS.com MCP to Vercel AI SDK

Create your Vinkius account to connect BulkSMS.com to Vercel AI SDK 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.com with Vercel AI SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Real-time SMS status in Vercel AI SDK

Your UI renders `get_delivery_status` results the second they arrive. Stop waiting for spinners and show users exactly when their message reaches a device. Use `send_bulk_sms` to push notifications from your edge functions. The SDK pipes the response into your stream so the interface updates instantly.

Manage BulkSMS.com contacts via SDK

Call `list_contacts` to pull your address book into your application state. You get raw data that maps straight to your frontend components. Adding new users happens through `create_contact`. Your code handles the input and the SDK ensures the record exists in your messaging account immediately.

Monitor BulkSMS.com credits in code

Check your balance using `get_credits` before firing off any campaigns. Your logic prevents overspending by verifying funds inside the application flow. Fetch your setup details with `get_profile`. This keeps your UI synced with your messaging plan settings without extra database lookups.

Setup guide

Set up BulkSMS.com MCP in Vercel AI SDK

Prerequisites

Node.js 18+ and a TypeScript project
ai + @modelcontextprotocol/sdk packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies

Run npm install ai @modelcontextprotocol/sdk plus your preferred model provider (e.g. @ai-sdk/openai).
2

Create the Streamable HTTP transport

Use StreamableHTTPClientTransport with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and use tools

Call mcpClient.tools() to auto-discover all BulkSMS.com tools. Pass them directly to generateText() or streamText() — no manual schema definitions needed.
4

Works with any model provider

Swap openai("gpt-4o") for any AI SDK provider — Anthropic, Google, Mistral. The MCP tools work identically across all supported models.

index.ts

import { experimental_createMCPClient as createMCPClient } from "ai";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp";
import { generateText } from "ai";
import { openai } from "@ai-sdk/openai";

const transport = new StreamableHTTPClientTransport(
  new URL("https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp")
);

const mcpClient = await createMCPClient({ transport });
const tools = await mcpClient.tools();

const { text } = await generateText({
  model: openai("gpt-4o"),
  tools,
  prompt: "List recent BulkSMS.com transactions",
});

console.log(text);
await mcpClient.close();

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.com. 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.com 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.com MCP in Vercel AI SDK

You pass the tool definitions to your streamText function. The SDK handles the execution of `send_sms` when your agent decides the time is right.

Yes, just call `list_messages`. The data returns in your stream and you can map it to your React components effortlessly.

It runs fine on the edge. The transport layer is lightweight enough to stay within your execution time limits.

Catch the tool output in your client logic. If `send_bulk_sms` fails, you can log the error or prompt your agent to try again.

All requests use encrypted transport. Your contact lists and message logs never touch our servers, staying strictly between your code and the messaging provider.

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