How to Use the TeleSign MCP in Vercel AI SDK

Q: What happens if I need to switch from SMS to Push verification with TeleSign and Vercel AI SDK?

The MCP Server handles it. If sendsms fails, you can immediately try a different channel like sendpushverification. Your client logic just needs to call the next tool in sequence.

Q: Does TeleSign support various phone number types when integrated with Vercel AI SDK?

Absolutely. You use getphonetype to determine if the number is mobile, landline, or VOIP. This intelligence guides your overall verification strategy for maximum accuracy.

Verify identity in real time with Vercel AI SDK streaming support.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect TeleSign MCP to Vercel AI SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Deep Phone Identity Scoring

You get the unique identifier and risk score for any phone number using `get_phone_id` and `score_phone`. This lets you check if a user's number is suspicious or synthetic *before* they even submit credentials. You can also determine the physical characteristics of the number with `get_phone_type`.

Multi-Method User Verification

The system supports three ways to confirm a user's identity: SMS, Push, and Voice. Triggering these methods is simple; you just call the specific tool—like `send_sms` or `send_push_verification`—and wait for confirmation. This coverage lets your application adapt if one verification channel fails.

System Health Checks

Before running a full flow, you'll want to check the system status. Use `check_telesign_status` to verify API connectivity or run `check_verification` to see if an existing verification attempt succeeded or failed. If the number is deactivated, `check_deactivation` tells you right away.

Setup guide

Set up TeleSign 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 TeleSign 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 TeleSign 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 TeleSign. 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 TeleSign 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 TeleSign MCP in Vercel AI SDK

TeleSign provides real-time phone intelligence that scores a number's risk level. When your agent calls `score_phone`, it checks for synthetic patterns, allowing you to block high-risk signups before they hit the database.

The MCP Server handles it. If `send_sms` fails, you can immediately try a different channel like `send_push_verification`. Your client logic just needs to call the next tool in sequence.

Yes. While the MCP Server doesn't manage your local rate limits, it provides tools like `check_telesign_status` which confirms overall service uptime and connection health before you execute a high-volume flow.

Absolutely. You use `get_phone_type` to determine if the number is mobile, landline, or VOIP. This intelligence guides your overall verification strategy for maximum accuracy.

The server handles phone number data and the resulting confirmation codes (for SMS/Push). It's critical to remember that `get_phone_id` processes unique identifiers, not personally identifiable information outside of the given number.

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