How to Use the Circle.so MCP in Vercel AI SDK

Q: Can the Vercel AI SDK read Circle.so member profiles?

Yes. The listcommunitymembers tool returns user details. You can stream this data directly into a Next.js dashboard using the standard useChat hook.

Q: How do I fetch specific Circle.so posts with Vercel AI SDK?

Call listcommunityposts through your initialized MCP client. The AI decides which parameters to pass based on the user prompt, then streams the fetched content back to your React frontend.

Build live community dashboards in React. Connect Vercel AI SDK to Circle.so and stream member data straight to the frontend.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Circle.so MCP to Vercel AI SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Stream Circle.so posts to your UI

Pipe `list_community_posts` through the Vercel AI SDK and watch text generate on screen exactly as the LLM processes it. Your users hate loading spinners. Next.js handles the edge streaming while the MCP Server pulls live discussion threads from your community. Call `list_post_comments` to let the AI summarize active debates and render the output directly into your React components. Building a custom member portal takes minutes instead of weeks. You skip writing custom polling logic entirely.

Build real-time member directories

Pass `list_community_members` to `streamText` to build real-time directories. Community managers need instant access to user data. Watch the AI filter, sort, and display your active participants live. Vue and Svelte frontends catch the chunks perfectly. Trigger `list_community_events` to populate upcoming schedules inside your application. Event tracking works the exact same way. The data arrives formatted, letting your UI components handle the rendering while Vinkius manages the connection state.

Map your MCP Server architecture

The `list_space_groups` tool grabs your top-level categories while the AI figures out how they relate. Navigating complex community hierarchies usually requires recursive API calls. This integration simplifies that mess by mapping the structure for you. Combine that with `list_community_spaces` to build dynamic navigation menus. The AI client reads the exact structure of your Circle instance and formats it for your frontend framework automatically. You get a perfect representation of your community layout.

Setup guide

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

Install @ai-sdk/mcp and initialize with createMCPClient. Point the HTTP transport URL to your Vinkius endpoint, then pass the resulting tools into your generateText call.

Yes. The list_community_members tool returns user details. You can stream this data directly into a Next.js dashboard using the standard useChat hook.

The Vinkius HTTP transport works perfectly on edge runtimes. You avoid heavy SDK dependencies and keep your serverless functions fast while querying community data.

Call list_community_posts through your initialized MCP client. The AI decides which parameters to pass based on the user prompt, then streams the fetched content back to your React frontend.

Vinkius runs your connection inside an ephemeral V8 Isolate. The instance processes member profiles and event schedules during the request, then immediately destroys the memory space. We never log your community data.

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