How to Use the Forj MCP in Vercel AI SDK

Q: Can I build a real-time activity feed for my Forj community using the AI SDK?

Yes. The getuseractivity tool is perfect for this. You can have your agent call it and stream the activity log directly into a timeline component in your Next.js or Svelte application, updating live.

Build live community admin UIs with Forj. Your Vercel AI SDK streams user and group data directly into your React or Svelte components.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Forj MCP to Vercel AI SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Stream a Live User Directory

Stop building admin panels that rely on loading spinners. With the Vercel AI SDK, you can pipe results from Forj's `search_users` tool directly into your UI, updating the view as data arrives. Your user types a name or email, your agent calls the tool, and the list populates in real-time. Combine it with `get_user_activity` to show a live feed of member actions right next to their profile. It's a faster, more responsive experience for your community managers.

Manage Groups Without Page Reloads

Give your admins the power to manage communities instantly. When they add a member, your agent calls `add_user_to_group`, and the member list component updates on the spot. No waiting for a full page refresh to confirm the action worked. Use the `list_groups` and `list_group_members` tools to build a two-pane view of your entire community structure. Clicking a group streams its member list. This is how modern dashboards should work.

Build a Real-Time Forj Admin with this MCP Server

Connect your AI client to Forj to handle all your community operations. This MCP Server gives you 12 distinct tools to work with, from creating groups with `create_group` to checking on pending join requests with `list_pending_requests`. Because you're using the AI SDK, you can build interfaces that feel alive. An admin can see new join requests appear in a queue automatically, then approve them with a single click that fires off the right tool.

Setup guide

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

You connect the Vercel AI SDK to the Forj server endpoint. Then you pass the tools, like `find_user` or `create_group`, to the `streamText` function. The SDK handles calling the tool and streaming the results back into your UI components.

Yes. The `get_user_activity` tool is perfect for this. You can have your agent call it and stream the activity log directly into a timeline component in your Next.js or Svelte application, updating live.

The main benefit is the real-time UI updates. Instead of making an API call and waiting, you stream the tool's output directly into your interface. This makes for a much faster and more fluid user experience for your admins.

This server includes 12 tools for managing your Forj community. It covers user management, group administration, and monitoring for things like invitations and webhooks.

The server processes user account details and activity logs from your Forj community. Vinkius runs each tool call in a separate, sandboxed environment that is destroyed after the request. The data only exists for the duration of the stream to your Vercel Edge Function.

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