# Common Room MCP for AI Agents AI Agent Connect

> Common Room lets your AI agent manage community growth data without you having to jump between tabs. It connects your agent to your community member data, allowing it to search for specific people, manage membership segments, and track engagement across different platforms. It is built for teams who need to turn community activity into actionable growth insights.

## Overview
- **Category:** marketing-automation
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_IKrxCPx6lEPWctuoHr8ylMStkNoCktDEp1aNa6vt/ai-agent-connect
- **Tags:** community-growth, contact-segmentation, customer-intelligence, identity-resolution, engagement-tracking

## Description

Common Room connects your AI agent to your community growth data. Imagine trying to figure out who your most active contributors are or which members are ready for an enterprise upgrade. Usually, this involves digging through various spreadsheets, Discord logs, and email lists to piece together a coherent picture. With this Connector, your AI agent handles that heavy lifting for you. Instead of manual data entry, you can just ask your agent to find specific members or group them into new cohorts based on their behavior. It turns your community data into a live, queryable resource. Because Vinkius makes it easy to connect these types of specialized tools, you can set up this integration in minutes and start using natural language to manage your audience. It is about moving away from searching and toward knowing your community in real time. You can manage segments, track activity, and identify key contributors without ever leaving your chat interface. This means you spend less time on admin and more time on actual community building. You can quickly see who is engaging with your content, who is falling off, and who is ready for your next big launch. It replaces the constant tab-switching and manual data syncing with a single point of interaction where your agent does the work of a community operations team.

## Tools

### get_organization_details
Retrieve the specific data and details for a registered organization within your community. Perfect for B2B growth tracking.

### list_segments
Get a complete list of all the segments currently defined in your Common Room workspace. This is great for a quick audit.

### search_contacts
Search your entire community database for members based on various criteria. This is your primary way to find specific people.

### add_contact_to_segment
Add a specific member to a cohort like Beta Testers or Enterprise Leads instantly. This helps keep your segments accurate without manual updates.

### get_contact_by_email
Pull up a full profile for a community member using just their email address. Use this to get context on a user quickly.

### get_contact_tags
See all the labels and tags associated with a specific community member profile. This helps you see what they are interested in.

### search_organizations
Find specific organizations within your community using the search tool. This helps you manage B2B relationships more easily.

### get_segment_status
Check the current size and status of a specific membership segment. Use this to see how many people are in a cohort.

### list_activity_types
View the different types of community engagement actions supported by the platform. This helps you understand how users interact.

### list_segment_members
Pull a list of every contact currently belonging to a specific segment. Use this to see who is in a specific group.

## Prompt Examples

**Prompt:** 
```
Find the user with email dev@example.com and tell me what tags they have.
```

**Response:** 
```
I found the member **Alex Chen** (dev@example.com). They have the following tags:

*   **Beta_Tester**
*   **Contributor**
*   **Verified_User**

Would you like me to add them to any other segments?
```

**Prompt:** 
```
Show me all the segments we have and how many people are in them.
```

**Response:** 
```
Here are your current segments in Common Room:

| Segment Name | Member Count |
| :--- | :--- |
| Top Contributors | 142 |
| Beta Testers | 58 |
| Enterprise Leads | 310 |
| New Members | 89 |

Would you like to see the list of members for any of these?
```

**Prompt:** 
```
Add 'Alex Chen' to the 'Enterprise Leads' segment.
```

**Response:** 
```
I've successfully added **Alex Chen** to the **Enterprise Leads** segment. They are now part of 3 total segments.
```

## Capabilities

### Find community members by email
Retrieve full profile details for any member using their email address.

### Add members to segments
Move specific contacts into cohorts like Beta Testers or Enterprise Leads.

### Check segment member counts
Get the current size and status of any membership cohort instantly.

### Track engagement activity
View activity feeds to identify your most active contributors.

### Retrieve organization details
Pull specific data for organizations registered in your community.

### List all community segments
Get a complete list of every cohort currently defined in your workspace.

### Search for organizations
Locate specific organizations within your community database.

## Use Cases

### Identifying Beta Testers
A DevRel lead asks the agent to find users who have merged PRs and then uses add_contact_to_segment to put them in a Beta group.

### Segmenting Enterprise Leads
A growth marketer asks the agent to find organizations with over 50 members and then uses search_organizations to list them for a sales call.

### Member Onboarding
A community manager asks the agent to check a new member's tags using get_contact_tags to see if they have completed their profile.

### Engagement Analysis
A manager asks the agent to list all activity types and then queries list_segment_members to see who is active in the Power User cohort.

## Benefits

- Stop manual data entry by using add_contact_to_segment to group members automatically based on AI-detected behavior.
- Identify power users faster with list_segment_members and search_contacts to see who is actually moving the needle.
- Build smarter marketing lists by using list_segments to see every cohort you have available for targeting.
- Get instant context on any user by pulling their profile with get_contact_by_email and viewing their get_contact_tags.
- Monitor community health in real time by checking get_segment_status to see how many people are moving into new groups.
- Simplify organization research by using search_organizations and get_organization_details to manage B2B relationships.

## How It Works

The bottom line is you get a natural language interface for your entire community growth database.

1. Add the Common Room integration to your Vinkius dashboard.
2. Paste your API Token from the Common Room settings.
3. Ask your agent to find members, manage segments, or track engagement using natural language.

## Frequently Asked Questions

**Can I use Common Room MCP to find community members by their email?**
Yes, you can ask your agent to find any member using their email address. It will pull up their full profile and details instantly.

**How do I move people into different groups using Common Room?**
You can ask your agent to add or remove specific members from your segments. It handles the logic of moving them into the right cohort for you.

**Can this help me find my most active contributors?**
Definitely. Your agent can check activity feeds and segment member lists to help you identify who is most engaged with your community.

**Does Common Room MCP work for B2B organizations?**
Yes, it includes tools to search for organizations and retrieve specific details about them, making it great for B2B community growth.

**Can my AI agent see my community segments?**
Yes, your agent can list all your segments and even tell you exactly how many people are in each one.

**How do I get started with Common Room and my AI agent?**
Just connect the Connector through Vinkius, provide your API token from the Common Room settings, and start asking questions in plain English.

**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.