How to Use the Forj MCP in Windsurf

Give Cascade direct access to your Forj community to manage groups and track member activity right inside Windsurf.

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 Windsurf

Create your Vinkius account to connect Forj to Windsurf 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 Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate community structures with Windsurf

The Forj MCP server gives Windsurf the ability to read and modify your community groups using `create_group` and `list_groups`. Cascade takes a broad goal like setting up a new cohort and handles the specific API calls without prompting. If you need to populate a fresh space, the agent pulls a list of target members and fires off `add_user_to_group` for each one. You watch the changes happen in the terminal output instead of clicking through a web interface.

Track user activity autonomously

You can check exactly what community members are doing by calling `get_user_activity` and `search_users` through this integration. Cascade strings these tools together to build an activity report based on a single request. Tell your agent to find dormant accounts by using `find_user` to grab IDs. It checks their recent logs and flags anyone who stopped logging in. That data lands straight in your editor.

Clear the pending request backlog

Managing an active community means dealing with access requests, which you can now handle via `list_pending_requests` and `list_invitations`. Cascade reads the queue, checks user details against your criteria, and processes the approvals. It also monitors system connections with `list_webhooks`. When something breaks, your agent figures out what dropped and drafts the fix right in your workspace.

Setup guide

Set up Forj MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Forj MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Forj payment history." If connected, Cascade will call the Forj tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "forj-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

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 Windsurf

Open your Windsurf settings and navigate to Cascade's MCP Servers UI. You can also edit `~/.codeium/windsurf/mcp_config.json` directly to add the endpoint.

Yes. Cascade can read the queue using the pending requests tool and match emails against an approved list. It acts on the logic you set.

The agent chains multiple tools together. It pulls the member list, checks individual activity logs, and formats a markdown report without asking for permission between steps.

You can query active connections. The server exposes a webhook listing tool so your agent knows exactly where community events are routing.

The server processes email addresses and member activity logs directly. Vinkius runs this MCP connection in an ephemeral V8 Isolate Sandbox, meaning your community data vanishes the moment the session ends.

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