4,000+ servers built on vurb.ts
Vinkius

SuperTokens MCP Server for WindsurfGive Windsurf instant access to 18 tools to Assign Role To User, Bulk Import Users, Create Or Update Role, and more

MCP Inspector GDPR Free for Subscribers

Windsurf brings agentic AI coding to a purpose-built IDE. Connect SuperTokens through Vinkius and Cascade will auto-discover every tool. ask questions, generate code, and act on live data without leaving your editor.

Ask AI about this MCP Server for Windsurf

The SuperTokens MCP Server for Windsurf is a standout in the Developer Tools category — giving your AI agent 18 tools to work with, ready to go from day one.

Built for AI Agents by Vinkius

Vinkius delivers Streamable HTTP and SSE to any MCP client

ClaudeClaude
ChatGPTChatGPT
CursorCursor
GeminiGemini
WindsurfWindsurf
VS CodeVS Code
JetBrainsJetBrains
VercelVercel
+ other MCP clients
Classic Setup·json
{
  "mcpServers": {
    "supertokens": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}
RecommendedModern Approach — Zero Configuration

Vinkius Desktop App

The modern way to manage MCP Servers — no config files, no terminal commands. Install SuperTokens and 4,000+ MCP Servers from a single visual interface.

Vinkius Desktop InterfaceVinkius Desktop InterfaceVinkius Desktop InterfaceVinkius Desktop Interface
Download Free Open SourceNo signup required
SuperTokens
Fully ManagedVinkius Servers
60%Token savings
High SecurityEnterprise-grade
IAMAccess control
EU AI ActCompliant
DLPData protection
V8 IsolateSandboxed
Ed25519Audit chain
<40msKill switch
Stream every event to Splunk, Datadog, or your own webhook in real-time

* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure

About SuperTokens MCP Server

Connect your SuperTokens Core instance to any AI agent to manage user lifecycles, session security, and Role-Based Access Control (RBAC) through natural language.

Windsurf's Cascade agent chains multiple SuperTokens tool calls autonomously. query data, analyze results, and generate code in a single agentic session. Paste Vinkius Edge URL, reload, and all 18 tools are immediately available. Real-time tool feedback appears inline, so you see API responses directly in your editor.

What you can do

  • User Management — Sign up new users, sign in existing ones, and retrieve detailed user profiles or link multiple accounts together.
  • Session Control — Create, refresh, and revoke sessions (JWT or database-backed) to maintain tight security over user access.
  • RBAC & Permissions — Create roles, define permissions, and assign them to users to manage authorization levels dynamically.
  • User Metadata — Store and update custom JSON metadata for users to track preferences or application-specific data.
  • Account Linking — Seamlessly link or unlink different recipe user IDs to a primary user identity.

The SuperTokens MCP Server exposes 18 tools through the Vinkius. Connect it to Windsurf in under two minutes — credentials fully managed, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.

All 18 SuperTokens tools available for Windsurf

When Windsurf connects to SuperTokens through Vinkius, your AI agent gets direct access to every tool listed below — spanning authentication, session-management, rbac, and more. Every call runs in a secure, isolated environment with full audit visibility. Beyond a simple connection, you get real-time monitoring of agent activity, enterprise governance, and optimized token usage.

assign

Assign role to user on SuperTokens

Assign a role to a user

bulk

Bulk import users on SuperTokens

Bulk import users

create

Create or update role on SuperTokens

Create or update a user role

create

Create or update tenant on SuperTokens

Create or update a tenant

create

Create session on SuperTokens

Create a new session for a user

delete

Delete user metadata on SuperTokens

Delete metadata for a user

get

Get tenant on SuperTokens

Get tenant details

get

Get user on SuperTokens

Get user details by ID

get

Get user metadata on SuperTokens

Get metadata for a user

link

Link accounts on SuperTokens

Link two user accounts together

list

List roles on SuperTokens

List all roles

list

List user roles on SuperTokens

List roles assigned to a user

refresh

Refresh session on SuperTokens

Refresh an existing session

remove

Remove session on SuperTokens

Remove/revoke a session

signin

Signin user on SuperTokens

Sign in a user

signup

Signup user on SuperTokens

Sign up a new user

unlink

Unlink accounts on SuperTokens

Unlink a user account

update

Update user metadata on SuperTokens

Update metadata for a user

Connect SuperTokens to Windsurf via MCP

Follow these steps to wire SuperTokens into Windsurf. The entire setup takes under two minutes — your credentials stay safe behind Vinkius.

01

Open MCP Settings

Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
02

Add the server

Paste the JSON configuration above into mcp_config.json
03

Save and reload

Windsurf will detect the new server automatically
04

Start using SuperTokens

Open Cascade and ask: "Using SuperTokens, help me...". 18 tools available

Why Use Windsurf with the SuperTokens MCP Server

Windsurf provides unique advantages when paired with SuperTokens through the Model Context Protocol.

01

Windsurf's Cascade agent autonomously chains multiple tool calls in sequence, solving complex multi-step tasks without manual intervention

02

Purpose-built for agentic workflows. Cascade understands context across your entire codebase and integrates MCP tools natively

03

JSON-based configuration means zero code changes: paste a URL, reload, and all 18 tools are immediately available

04

Real-time tool feedback is displayed inline, so you see API responses directly in your editor without switching contexts

SuperTokens + Windsurf Use Cases

Practical scenarios where Windsurf combined with the SuperTokens MCP Server delivers measurable value.

01

Automated code generation: ask Cascade to fetch data from SuperTokens and generate models, types, or handlers based on real API responses

02

Live debugging: query SuperTokens tools mid-session to inspect production data while debugging without leaving the editor

03

Documentation generation: pull schema information from SuperTokens and have Cascade generate comprehensive API docs automatically

04

Rapid prototyping: combine SuperTokens data with Cascade's code generation to scaffold entire features in minutes

Example Prompts for SuperTokens in Windsurf

Ready-to-use prompts you can give your Windsurf agent to start working with SuperTokens immediately.

01

"Get details for user ID 'user-123'."

02

"Assign the 'editor' role to user 'user-456'."

03

"List all available roles in the system."

Troubleshooting SuperTokens MCP Server with Windsurf

Common issues when connecting SuperTokens to Windsurf through Vinkius, and how to resolve them.

01

Server not connecting

Check Settings → MCP for the server status. Try toggling it off and on.

SuperTokens + Windsurf FAQ

Common questions about integrating SuperTokens MCP Server with Windsurf.

01

How does Windsurf discover MCP tools?

Windsurf reads the mcp_config.json file on startup and connects to each configured server via Streamable HTTP. Tools are listed in the MCP panel and available to Cascade automatically.
02

Can Cascade chain multiple MCP tool calls?

Yes. Cascade is an agentic system. it can plan and execute multi-step workflows, calling several tools in sequence to accomplish complex tasks without manual prompting between steps.
03

Does Windsurf support multiple MCP servers?

Yes. Add as many servers as needed in mcp_config.json. Each server's tools appear in the MCP panel and Cascade can use tools from different servers in a single flow.

Explore More MCP Servers

View all →