How to Use the SuperTokens MCP in Cursor

Q: How do I test user roles in my code using SuperTokens and Cursor?

You call listuserroles directly within your coding context. The AI uses the live returned list to check permissions, ensuring your generated code is accurate against real system rules.

Q: Can I manage user signups from inside Cursor with SuperTokens?

Yes. Your agent can call signupuser and immediately use the resulting ID in subsequent code blocks to verify that the new account object exists before writing any consuming logic.

Q: How does SuperTokens help structure my API endpoints when I'm coding in Cursor?

The tools like getuser and updateusermetadata provide concrete, typed inputs that the AI uses. This forces your code to respect the real data model rather than relying on abstract stubs.

Q: If I need to unlink accounts for a test, what should I use with SuperTokens in Cursor?

Use the unlinkaccounts tool. The AI understands that this action modifies relationships between user IDs and generates code that correctly handles the post-unlinking state.

Inject live identity context into your code with Cursor.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect SuperTokens MCP to Cursor

Create your Vinkius account to connect SuperTokens to Cursor — we handle the hosting, security, and runtime updates so you don't have to. No server setup required.

GDPR Included with Plan

Setup SuperTokens with Cursor

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Build auth logic using real data.

You're writing a component and need to know if the user is an admin? Don't use mock data. Let the AI call `list_user_roles` first. The resulting JSON—the live list of roles—gets injected right into your function scope for immediate use. Alternatively, if you just need basic identifying info, running `get_user` provides a clean object that you can immediately reference in your code's type definitions.

Manage accounts and sessions programmatically.

Need to simulate an account linking flow? The AI generates the necessary boilerplate by calling `link_accounts`. It handles the logic of associating two disparate IDs into a single user profile, giving you real-time feedback. When testing session handling, call `create_session` before your test block. Then, if you need to revoke it for cleanup, use `remove_session`. The code works perfectly because the tool output is live.

Test role assignment and changes.

When developing RBAC features, you can't afford fake data. Use `assign_role_to_user` to grant a test user the 'editor' role right before running your unit test. The AI code then verifies that the resource is only accessible by users with that specific token. If you need to change global permissions for all future tests, call `create_or_update_role`. This updates the schema and ensures subsequent function calls use the correct access logic.

Setup guide

Set up SuperTokens MCP in Cursor

Prerequisites

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

1

Open MCP Settings

Go to Cursor Settings → MCP or open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and search for "MCP: Add Server".
2

Add the SuperTokens MCP

Cursor will create or open .cursor/mcp.json in your project root. Paste the JSON snippet on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Enable Agent mode

Open Composer (Cmd+I / Ctrl+I) and switch to Agent mode using the dropdown at the top. MCP tools are only available in Agent mode.
4

Verify the connection

Ask Cursor something like "List my recent SuperTokens transactions." If the MCP tools are loaded correctly, Cursor will call the SuperTokens tools automatically. You can also check Settings → MCP for a green status indicator.

.cursor/mcp.json

{
  "mcpServers": {
    "supertokens-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 SuperTokens. 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 SuperTokens 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 SuperTokens MCP in Cursor

You call `list_user_roles` directly within your coding context. The AI uses the live returned list to check permissions, ensuring your generated code is accurate against real system rules.

Yes. Your agent can call `signup_user` and immediately use the resulting ID in subsequent code blocks to verify that the new account object exists before writing any consuming logic.

The tools like `get_user` and `update_user_metadata` provide concrete, typed inputs that the AI uses. This forces your code to respect the real data model rather than relying on abstract stubs.

Use the `unlink_accounts` tool. The AI understands that this action modifies relationships between user IDs and generates code that correctly handles the post-unlinking state.

The server manages user roles, account linkages, and user metadata. This means your generated code must respect these boundaries when handling user identity.

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