How to Use the Middesk MCP in Vercel AI SDK

Verify business identities in real-time by streaming Middesk verification data directly into your Vercel AI SDK frontend.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Middesk MCP to Vercel AI SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Live Business Identity Autocomplete

Your AI client uses `autocomplete_identity` to fill out business details in your Next.js input forms before the user even finishes typing. This Vercel AI SDK integration feeds state registry matches directly to your UI components without making the user wait for a full page reload. Instead of waiting for a slow backend queue, you pass the tool directly to the streaming UI. Your frontend displays matching entities instantly as the MCP Server fetches them, cutting registration drops by matching legal names live.

Instant Secretary of State Document Retrieval

The `get_document` tool retrieves official state filing PDFs and streams the document metadata straight to your React components. This means your Vercel AI SDK application renders download links and status updates the second the state database responds. You configure the client to call `list_documents` when a compliance team member inspects an account. Because this MCP Server works on Edge Functions, your UI updates with zero server-side latency.

On-the-Fly Tax Registration Checks

The `get_tax_registration` tool pulls state tax IDs and status records directly into your streaming UI. Your Vercel AI SDK application triggers this check during onboarding to verify if a business is registered to pay taxes. By calling `list_tax_registrations` within your text generation loop, you display verified tax statuses side-by-side with user inputs. It eliminates the standard loading spinner by showing raw data chunks as they arrive.

Setup guide

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

Set up the client with an HTTP transport using createMCPClient and handle errors inside your streamText catch block. Since the MCP Server runs in an isolated V8 sandbox, you get clean execution without clogging your main Next.js API routes.

Yes, the MCP Server is fully compatible with Edge runtimes because it relies on lightweight HTTP transports. You initialize the client, call prefill_business, and stream the results to the user with low latency.

Your React frontend captures the user input and passes it to the AI client, which triggers create_business with the required legal name. The tool output streams directly back to your state-managed UI components.

Always call mcpClient.close() inside your cleanup functions or after your streaming generator completes. This prevents socket leaks and keeps your serverless functions from hanging.

This MCP Server processes business legal names and tax registrations inside an ephemeral V8 sandbox that destroys all data upon request completion. No business tax IDs or state filing documents are cached or stored on Vinkius servers.

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