How to Use the Clearscope MCP in Vercel AI SDK

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

You'll use the @ai-sdk/mcp package. Just instantiate createMCPClient with your unique Vinkius endpoint URL. The client handles authentication and makes all the Clearscope tools available to your generateText or streamText calls.

Stream Clearscope SEO data directly into your UI with the Vercel AI SDK. Forget loading spinners—your users see results as they happen.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Clearscope MCP to Vercel AI SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Build Live SEO Dashboards

Stop making users wait for a full page reload to see their SEO data. With this MCP Server, you can use the Vercel AI SDK to stream Clearscope results directly into your application's components. Kick off a new analysis with `create_report`, then feed the output of `get_report_details` right into your UI, building tables and charts in real time. Your user gets immediate feedback. They see keyword opportunities from `get_keyword_research` and competitor lists from `list_competitors` appear on the screen the moment the data is available. It's a completely different experience from the usual request-and-wait cycle.

Real-Time Content Grading

Give your users a content editor that grades their work as they type. Hook up a text area to your AI client and use the `grade_content` tool. As the user writes, you can stream the content score and term frequency data from `list_terms` directly back to the interface. This lets you build features that show a live, updating content score or highlight missing keywords on the fly. You're not just showing a final grade; you're guiding the writing process interactively, all powered by Clearscope's NLP engine and the AI SDK's streaming capabilities.

Your Clearscope MCP Server

This isn't just another API wrapper. It's a direct, authenticated connection between your AI agent and Clearscope's core functions. You can manage your entire content lifecycle without leaving your app. Use `list_workspaces` to select the right context, then `list_reports` to see what's already been done. Because it's an MCP Server, setup is minimal. You point the AI SDK to a single Vinkius URL with your token, and all the tools are instantly available. No complex OAuth flows or SDKs to manage. Just pure SEO functionality, ready to be integrated.

Setup guide

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

You'll use the `@ai-sdk/mcp` package. Just instantiate `createMCPClient` with your unique Vinkius endpoint URL. The client handles authentication and makes all the Clearscope tools available to your `generateText` or `streamText` calls.

Yes, that's a perfect use case. You can stream the results of the `grade_content` tool directly into your UI to provide a content score that updates in real time as the user types.

You can stream keyword research data, competitor lists, content outlines, and detailed report metrics. The tools are designed to feed data directly into your front-end components for a live, interactive experience.

This isn't a replacement for Clearscope's own interface. It's for developers who want to embed Clearscope's data and logic directly into their own custom applications, powered by an AI agent.

Your content drafts and SEO report data are processed in an ephemeral sandbox. Vinkius uses a zero-trust model, and this MCP server never stores your data after a request is complete. The entire operation is stateless.

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