How to Use the PDF.co MCP in Vercel AI SDK

Stream PDF.co document data directly into your AI-SDK frontends without the wait.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect PDF.co MCP to Vercel AI SDK

Create your Vinkius account to connect PDF.co to Vercel AI SDK — we handle the hosting, security, and runtime updates so you don't have to. No server setup required.

GDPR Included with Plan

Setup PDF.co with Vercel AI SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Real-time document data streaming

Pipe extracted text and structured data straight into your UI components. When your app calls `pdf_to_json` or `pdf_to_text`, the data arrives in the stream immediately. Your users stop staring at loading spinners. The AI-SDK handles the incoming chunks, letting you render parsed document content the second it hits the edge.

Programmatic PDF manipulation

Automate file management tasks like `merge_pdfs` and `split_pdf` within your edge functions. It’s perfect for handling user-uploaded files that need quick cleanup before display. Keep your logic close to the data. You don't need a heavy backend when these tools handle the heavy lifting of document restructuring on the fly.

Automated document intelligence

Use `ocr_image` or `extract_pdf_meta` to pull insights from static files. It turns raw images into actionable JSON objects that your app can process instantly. Your AI client gets the context it needs to answer user questions about their documents. Just feed the output into your generation pipeline and watch it work.

Setup guide

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

Install the MCP client packages and point your transport to the server URL. You then pass the tool definitions directly into your generateText calls.

Yes. The tools are designed to work within lightweight environments, making them ideal for edge deployment.

Your documents are processed in an isolated sandbox. We clear all temporary files immediately after the job finishes to keep your sensitive data secure.

Absolutely. Because these tools return standard JSON or text, they integrate cleanly with the streaming patterns you already use.

The server returns a specific error code. You should implement a simple try-catch block to handle these cases and notify your user.

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