How to Use the Franchimp MCP in Vercel AI SDK

Q: How do I connect Franchimp to the Vercel AI SDK?

Install @ai-sdk/mcp and set up an HTTP transport. Call createMCPClient with your endpoint URL, then pass the resulting tools into your text generation function. Always close the client when the session ends.

Q: Can the Vercel AI SDK stream Franchimp investment stats to a Next.js app?

Yes. When your agent calls getinvestmentstats, the framework streams the resulting financial data directly to your React components. Users see the numbers populate instantly.

Stream live franchise investment stats and FDD metadata directly into your Next.js frontend using Franchimp and the Vercel AI SDK.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Franchimp MCP to Vercel AI SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Stream FDD Data to React with Vercel AI SDK

Your AI client uses `get_fdd_metadata` and `list_fdd_documents` to pull disclosure documents while the Vercel AI SDK streams the output straight to your frontend. Users watch registration dates and compliance metrics render instantly inside your Next.js application. No loading spinners. The data hits the DOM as soon as the server fetches it. You wire this up by passing the MCP tools into `streamText`. When a prospective buyer asks about a specific brand, the agent triggers `get_franchise_details` and pushes the franchisor metadata to your UI components in real-time. Edge function compatibility means these requests execute with minimal latency.

Build Live Franchisee Directories

`list_franchisees` and `get_franchisee_details` let your React application generate dynamic contact lists for specific markets. Your users request a breakdown of operators in a territory, and the Vercel AI SDK pipes the contact details directly into a data table component. You skip the tedious wait states. If a user needs to pinpoint a specific owner, the agent calls `find_franchisee_by_email` and renders the exact match immediately. You handle the auth via `authProvider` during the MCP client setup, keeping the connection secure while your frontend updates dynamically.

Real-Time Investment Analysis

Feed financial outcomes straight to your users by having your agent run `get_investment_stats` on target brands. The Vercel AI SDK handles the asynchronous stream, turning raw investment data into live charts or text summaries on your Svelte or Vue interface. You show them the money without making them wait. Before pulling heavy document loads, the agent checks `list_available_credits` to ensure your account has the bandwidth. Once cleared, it targets high-value prospects using `list_multi_unit_operators`. The end user gets actionable lead generation data appearing right before their eyes.

Setup guide

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

Install `@ai-sdk/mcp` and set up an HTTP transport. Call `createMCPClient` with your endpoint URL, then pass the resulting tools into your text generation function. Always close the client when the session ends.

Yes. When your agent calls `get_investment_stats`, the framework streams the resulting financial data directly to your React components. Users see the numbers populate instantly.

It does. The HTTP transport layer supports edge execution. Your agent can query the database from the edge, keeping latency low for end users.

Use the authentication provider option inside your client configuration. This manages tokens securely before your agent requests any protected data.

The server processes direct contact information, including names and email addresses from `find_franchisee_by_email`. Vinkius isolates this execution inside a zero-trust V8 sandbox that destroys itself immediately after the request completes. No trace of the contact data remains in memory.

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