How do I connect this MCP to my AI client?

You connect it through the Vinkius platform. Once you add the Common Room MCP, you can link it to compatible clients like Claude, Cursor, or Windsurf with one click.

What do I need to get started?

You will need an API Token from your Common Room account. You can find this under Settings in the Common Room dashboard.

Can I add members to segments using my agent?

Yes. You can use the add_contact_to_segment capability to manually move contacts into specific cohorts via your AI client.

Is my community data secure?

Vinkius hosts the MCP and manages your credentials securely, so you don't have to handle the underlying connection logic yourself.

Which AI clients can I use with this?

This MCP works with any compatible client, including Claude, Cursor, Windsurf, and VS Code.

How do I get my Common Room API token?

Go to Settings > API Tokens in Common Room and generate a new token. Copy it and paste it into the field below.

What is a segment in Common Room?

A segment is a group of contacts or organizations defined by specific criteria or manually curated. They help you target and analyze subsets of your community.

Can I track custom activities?

Yes, but you first need to set up an API Signal in Common Room to receive custom activity data. Once configured, the agent can query those activities.

An astronaut overseeing a futuristic data hub

Download PDF Markdown Version

Connect Common Room to ChatGPT, Claude and Gemini

Set it up once and it works in ChatGPT, Claude, Cursor, and any other client you love. It all runs safely in the background, so you can relax and focus on what really matters. Control your community data directly from your AI client.

Ask AI about this Connector

Developed, maintained, and hosted by Vinkius.

MCP VERIFIED · PRODUCTION READY · VINKIUS GUARANTEED

Waiting for input…

Works with modern AI clients that support MCP, including ChatGPT, Claude, Cursor, and more.

Your AI does the work. We keep it safe and sound.

No other AI tool gives you this. Your workflow runs in the client you already love, your account stays protected, and you decide what the agent can and cannot do. It is the whole reason to make the switch.

Each Connector lives inside our infrastructure, the same place where your workflow runs. The three things below are already part of it, working quietly in the background so you never have to think about them. Nothing to add, nothing to set up, nothing to worry about.

V8 Isolate01

Each Connector runs inside its own sealed environment.

Each Connector runs inside its own sealed V8 runtime — no access to your files, your system, or other servers. A Connector never sees past its own request.

Kill Switch02

One switch stops every agent. Instantly.

One action deactivates every Connector, revokes every token, and ends every session at once. AI Governance keeps the record.

FinOps per User03

Spending limits that pause instead of surprise.

Every user keeps their own connections and credentials, isolated from everyone else. Anything that would cross your spending limit is held for your approval, not billed.

Three controls, built into the layer your AI connects through.

Curated set · 10 capabilities

We ship only the actions that matter.

Capability set01 / 03

01-04

4 capabilities in this set.

Part of 10 available through Common Room.

01
Add contact to segment
This capability manually places a contact into a designated segment.
02
Search contacts
This capability searches your Common Room database for specific members or contacts.
03
Get contact tags
Use this to see all the tags currently attached to a specific member.
04
Get contact by email
This capability retrieves a complete profile for a member using their email address.

Capability set02 / 03

05-07

3 capabilities in this set.

Part of 10 available through Common Room.

05
List segment members
Use this to get a list of every contact belonging to a specific segment.
06
Search organizations
This capability searches for organizations within your Common Room data.
07
Get organization details
This capability pulls specific information about an organization in your Common Room account.

Capability set03 / 03

08-10

3 capabilities in this set.

Part of 10 available through Common Room.

08
Get segment status
This capability provides the current status and total member count for a segment.
09
List activity types
This capability returns a list of all the different activity types tracked in your account.
10
List segments
Use this to see a full list of all segments you have created.

Real work

What teams actually run

Member Onboarding

Quickly verify a new user's details and add them to a welcome segment.

Contributor Identification

Find your most active users by checking their activity and tags.

Segment Auditing

Check member counts and segment status to ensure cohorts are accurate.

Organization Mapping

Search for organizations to understand which companies are most active in your community.

Automate a task

Put Common Room to work on one thing.

Step-by-step automations your AI runs through this Connector: the workflow, the prompts to start with, and the exact capabilities behind each move.

One connector, every AI

Common Room works with the most popular AI clients.

These are the most popular clients, each with a step-by-step guide: one link, set up once, with governance and visibility built in. And because everything runs on the MCP standard, the same connection also works in any other compatible client — nothing to rebuild.

Building your own app? The connector is yours to use.

You don't need a client to put Common Room to work: the same hosted connection plugs into your own applications and agent code, with the same governance on every request. Build with it, chat with it — one connection for both.

Observed, not estimated

843ms average. Fast in production.

Common Room is checked daily against the live service.

Daily averagePeak 1107ms

Oct 3Today

Fastest day: 700ms
Slowest day: 1107ms
14-day trend: Slowing+10%

Connect your client

One URL. Every client.

Activate the Connector, copy your link, and paste it into the client you already use. 10 capabilities arrive ready to run.

Preview access · not provider authentication

The vk_preview_* token belongs to Vinkius preview infrastructure. It lets Claude discover and display the capabilities of Common Room, so you can see the experience inside your AI.

It does not authenticate your account with Common Room. Actions requiring credentials or live account data may not run until you activate the Connector and authorize the service.

Common Room Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_IKrxCPx6lEPWctuoHr8ylMStkNoCktDEp1aNa6vt/mcp

Claude Desktop

Follow the steps below to connect in seconds.

1In Claude Desktop, open Settings → Connectors.
2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
3Click Add and start a new chat — Common Room capabilities are ready to use.

Configuration · claude_desktop_config.jsonCopy

{
  "mcpServers": {
    "common-room-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_IKrxCPx6lEPWctuoHr8ylMStkNoCktDEp1aNa6vt/mcp"
    }
  }
}

Claude
ChatGPT
Cursor
VS Code
Windsurf
Claude Code
JetBrains
Cline

Step-by-step instructions for each client are in the guide. How to connect

Guided setup for Claude? Set up Common Room in Claude and other AIs

See all the AI clients this connector works with ↑

Who it's for

Built for the work Common Room owners hand off.

This MCP is built for teams that manage large-scale communities and need quick access to member data.

01
Community Managers
They use the agent to find and segment members without opening the dashboard.
02
DevRel Teams
They use the agent to identify top contributors and track engagement.
03
Growth Teams
They use the agent to build targeted segments and monitor community signals.

FAQ

Questions Common Room owners ask.

01
How do I connect this MCP to my AI client?
You connect it through the Vinkius platform. Once you add the Common Room MCP, you can link it to compatible clients like Claude, Cursor, or Windsurf with one click.
02
What do I need to get started?
You will need an API Token from your Common Room account. You can find this under Settings in the Common Room dashboard.
03
Can I add members to segments using my agent?
Yes. You can use the add_contact_to_segment capability to manually move contacts into specific cohorts via your AI client.
04
Is my community data secure?
Vinkius hosts the MCP and manages your credentials securely, so you don't have to handle the underlying connection logic yourself.
05
Which AI clients can I use with this?
This MCP works with any compatible client, including Claude, Cursor, Windsurf, and VS Code.
06
How do I get my Common Room API token?
Go to Settings > API Tokens in Common Room and generate a new token. Copy it and paste it into the field below.
07
What is a segment in Common Room?
A segment is a group of contacts or organizations defined by specific criteria or manually curated. They help you target and analyze subsets of your community.
08
Can I track custom activities?
Yes, but you first need to set up an API Signal in Common Room to receive custom activity data. Once configured, the agent can query those activities.

Explore

More in Marketing Automation

Connect Common Room to Claude, Cursor, ChatGPT & more

Your AI does the work. We keep it safe and sound.

Each Connector runs inside its own sealed environment.

One switch stops every agent. Instantly.

Spending limits that pause instead of surprise.

We ship only the actions that matter.

01-04

Add contact to segment

Search contacts

Get contact tags

Get contact by email

05-07

List segment members

Search organizations

Get organization details

08-10

Get segment status

List activity types

List segments

What teams actually run

Member Onboarding

Contributor Identification

Segment Auditing

Organization Mapping

Building your own app? The connector is yours to use.

Common Room Connector

Claude Desktop

Community Managers

DevRel Teams

Growth Teams

How do I connect this MCP to my AI client?

What do I need to get started?

Can I add members to segments using my agent?

Is my community data secure?

Which AI clients can I use with this?

How do I get my Common Room API token?

What is a segment in Common Room?

Can I track custom activities?

Common Room AI Connector

Ometria Intelligence AI Connector

Customer.io AI Connector

Blueshift AI Connector

Suggestions

Customer.io AI Connector

Customer.io AI Connector

Customers.ai AI Connector

journy.io AI Connector