How to Use the Common Room MCP in CrewAI

Q: How do I configure a CrewAI agent to use Common Room MCP tools?

Pass your Vinkius endpoint URL directly into the agent's mcps list. The agent automatically discovers tools like getmember and starts using them.

Q: Can I restrict which Common Room MCP tools my CrewAI agents can access?

Yes. Use MCPServerHTTP from crewai.mcp and apply a toolfilter to limit access, ensuring agents can't run deletemember without permission.

Q: How do CrewAI agents collaborate using Common Room data?

Agents share context dynamically. One agent can call listtags to understand your organization, then pass those tags to a colleague to categorize a member.

Deploy a crew of autonomous agents to monitor, tag, and engage your Common Room community using CrewAI.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Common Room MCP to CrewAI

Create your Vinkius account to connect Common Room to CrewAI 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 Common Room with CrewAI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Multi-Agent Community Monitoring

Deploy a specialized crew where one agent monitors activity and another manages profiles. The research agent calls `list_members` to find active users, while the admin agent updates profiles using `update_member`. This collaborative setup lets your crew build a shared memory of your community health. They can track who is contributing without constantly re-querying the database.

Autonomous Segment and Tag Management

Let your agents organize your community database autonomously. One agent reads your current setup with `list_segments` while another applies tags to key users. By exposing this MCP Server to your crew, they can instantly identify highly engaged advocates. They coordinate their actions to keep your member records clean and categorized.

Automated Event Ingestion with CrewAI

Keep your community timeline updated by letting your crew handle incoming signals. An agent can ingest external chat or social interactions using `ingest_activity` on behalf of members. The crew can verify their access token state using `get_token_status` before starting their run. This prevents your autonomous agents from running into authentication dead-ends.

Setup guide

Set up Common Room 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 Common Room tools as needed.

crew.py

from crewai import Agent, Task, Crew

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

task = Task(
    description="List recent Common Room 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="Common Room Analyst",
        goal="Access and analyze Common Room data via MCP.",
        backstory="Expert analyst with direct Common Room access.",
        tools=mcp_tools,
    )

    task = Task(
        description="List recent Common Room 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 Common Room. 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 Common Room 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 Common Room MCP in CrewAI

Pass your Vinkius endpoint URL directly into the agent's `mcps` list. The agent automatically discovers tools like `get_member` and starts using them.

Yes. Use `MCPServerHTTP` from `crewai.mcp` and apply a `tool_filter` to limit access, ensuring agents can't run `delete_member` without permission.

Agents share context dynamically. One agent can call `list_tags` to understand your organization, then pass those tags to a colleague to categorize a member.

CrewAI supports stdio, SSE, and Streamable HTTP. It negotiates the best connection automatically to let your agents read webhooks via `list_webhooks`.

The framework executes your commands within Vinkius's ephemeral MCP sandbox. Sensitive operations like `delete_member` are run securely, and no member profiles are cached or saved permanently.

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