How to Use the SuperTokens MCP in CrewAI

Q: How does SuperTokens assist CrewAI with user creation?

The agent team uses signupuser for initial account setup. If the user already exists, they can use getuser to verify credentials before proceeding, avoiding duplication.

Q: Can CrewAI manage roles and permissions?

Yes. One agent can call listroles to get all available roles, while another uses assignroletouser to assign the correct role based on the user's department.

Q: Does SuperTokens support account linking for CrewAI?

Absolutely. The team can use linkaccounts and unlinkaccounts tools sequentially, allowing them to manage complex identity graphs autonomously without human input.

Q: If we need to check tenant scope, what data type should we expect from SuperTokens using CrewAI?

You'll be dealing with tenant details. This ensures that even when multiple agents are running in parallel, they are all operating within the correct, isolated organizational boundary.

Automate complex operations across specialized AI teams using CrewAI.

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 CrewAI

Create your Vinkius account to connect SuperTokens to CrewAI — 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 CrewAI

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Process Bulk User Imports

A dedicated agent can manage massive data loads by calling `bulk_import_users`. This tool handles the ingestion of hundreds or thousands of records in one go, which is perfect for onboarding new clients. A separate team member might use `get_user` to verify that specific users from the bulk import already exist before updating their profiles.

Manage User Account Linkages

For a complex account setup, one agent uses `link_accounts` to tie together multiple identifiers (like linking an email to a phone number). Another agent handles cleanup using `unlink_accounts` when those connections are no longer valid. The whole process respects the data integrity by keeping track of which accounts belong to whom.

Enrich User Profiles

If a user profile is missing key information, an enrichment agent calls `update_user_metadata` to fill in gaps. This might include adding department codes or team identifiers. Alternatively, if the data needs cleaning up, calling `delete_user_metadata` removes specific fields entirely, ensuring compliance.

Setup guide

Set up SuperTokens MCP in CrewAI

Prerequisites

Python 3.10+ installed
crewai package (pip install crewai)
Active Vinkius subscription with a valid endpoint token

1

Install CrewAI
Run pip install crewai to install the framework. MCP support is built-in via the mcps parameter.
2

Add the MCP URL to your agent
Pass your Vinkius endpoint directly to the mcps list. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. CrewAI handles tool discovery and caching automatically.
3

Kick off your crew
Create a Crew with your agent and tasks. Call crew.kickoff() — the agent will automatically invoke SuperTokens tools as needed.

crew.py

from crewai import Agent, Task, Crew

agent = Agent(
    role="SuperTokens Analyst",
    goal="Access and analyze SuperTokens data via MCP.",
    backstory="Expert analyst with direct SuperTokens access.",
    mcps=[
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ],
)

task = Task(
    description="List recent SuperTokens transactions",
    agent=agent,
    expected_output="A summary of recent activity",
)

crew = Crew(agents=[agent], tasks=[task])
result = crew.kickoff()
print(result)

Get your connection token →

Prerequisites

Python 3.10+ installed
crewai + crewai-tools packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run pip install crewai crewai-tools. The MCPServerAdapter handles lifecycle management and tool conversion.
2

Connect with MCPServerAdapter
Use MCPServerAdapter as a context manager with SseServerParameters pointing to your Vinkius endpoint. The adapter automatically manages connection lifecycle.
3

Assign tools and run
Pass the returned mcp_tools to your agent's tools parameter. The adapter converts MCP tools to native BaseTool objects compatible with all CrewAI agents.

crew.py

from crewai import Agent, Task, Crew
from crewai_tools import MCPServerAdapter
from mcp import SseServerParameters

server_params = SseServerParameters(
    url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
)

with MCPServerAdapter(server_params) as mcp_tools:
    agent = Agent(
        role="SuperTokens Analyst",
        goal="Access and analyze SuperTokens data via MCP.",
        backstory="Expert analyst with direct SuperTokens access.",
        tools=mcp_tools,
    )

    task = Task(
        description="List recent SuperTokens transactions",
        agent=agent,
        expected_output="A summary of recent activity",
    )

    crew = Crew(agents=[agent], tasks=[task])
    result = crew.kickoff()
    print(result)

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 CrewAI

The agent team uses `signup_user` for initial account setup. If the user already exists, they can use `get_user` to verify credentials before proceeding, avoiding duplication.

Yes. One agent can call `list_roles` to get all available roles, while another uses `assign_role_to_user` to assign the correct role based on the user's department.

Absolutely. The team can use `link_accounts` and `unlink_accounts` tools sequentially, allowing them to manage complex identity graphs autonomously without human input.

This MCP server deals heavily with user identities. The most common resource types your agents will touch include `user metadata` and individual account records.

You'll be dealing with `tenant details`. This ensures that even when multiple agents are running in parallel, they are all operating within the correct, isolated organizational boundary.

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