# Common Room MCP for AI Agents MCP

> Common Room gives your AI agent direct access to community data, allowing it to manage contacts and segments in real time. Instead of manually digging through dashboards to find member details or segment counts, your agent can search for specific people by email, list all current cohorts, and even add members to targeted groups on demand. It's the central brain for community intelligence.

## Overview
- **Category:** marketing-automation
- **Price:** Free
- **Tags:** community-growth, contact-segmentation, customer-intelligence, identity-resolution, engagement-tracking

## Description

This MCP connects your AI client directly to Common Room, an intelligent platform built for growing online communities. What you get is immediate access to core relationship data—the kind of information that used to take hours of clicking and cross-referencing.

You can now ask your agent to find any member by email or name, instantly retrieving their profile details. Need to know who's engaged? Your agent can pull activity feeds to show you exactly when a user last contributed or what they were working on.

Want to target specific groups? You can list all available segments and even ask the agent to add contacts to new cohorts directly from your chat interface. This level of deep integration means you're not just looking at data; your AI agent is actively managing it. By connecting this Common Room MCP through Vinkius, you give your agent access to a centralized source for community signal data that changes what’s possible in day-to-day operations.

## Tools

### add_contact_to_segment
Manually adds a contact record to a specified community segment.

### get_contact_by_email
Retrieves full details about any member using their unique email address.

### get_contact_tags
Gets a list of metadata tags associated with a particular community member.

### get_organization_details
Retrieves detailed profile information for a specific organization in the network.

### get_segment_status
Checks and returns the current status and total member count for any given segment.

### list_activity_types
Provides a list of all types of activities that can be tracked within Common Room.

### list_segment_members
Lists every contact member belonging to a specific, designated segment.

### list_segments
Retrieves the complete list of all existing segments available in Common Room.

### search_contacts
Performs a broad search across your entire contact database to find members by various criteria.

### search_organizations
Searches and finds specific organizations within the Common Room platform.

## Prompt Examples

**Prompt:** 
```
I need a list of all my current segments and how many members are in each.
```

**Response:** 
```
Here’s a snapshot of your Common Room segments:

*   **Top Contributors:** 128 members
*   **Beta Testers:** 45 members
*   **Enterprise Leads:** 312 members
*   **New This Month:** 67 members
*   **Churned:** 23 members

You can ask me to filter this list or check the status of any specific segment.
```

**Prompt:** 
```
Find Alex Chen by email and tell me what groups he's in.
```

**Response:** 
```
**Member Found:** Alex Chen (dev@example.com)
**Segments:**
*   Top Contributors
*   Beta Testers
**Last Activity:** GitHub PR merged 2 days ago.

He is an active member and belongs to two key cohorts.
```

**Prompt:** 
```
Are there any contacts in the 'Enterprise Leads' segment who haven't been active lately?
```

**Response:** 
```
I checked the 'Enterprise Leads' segment. Here are 3 members whose activity feeds show low engagement (last activity over 45 days):

1.  Jane Doe (jane@example.com)
2.  Robert Smith (robert@corp.net)
3.  Sarah Connor (sconnor@domain.org)

Would you like me to pull their full profiles?
```

## Capabilities

### Find and Verify Community Members
Search for people using names, emails, or external IDs to get their complete profile details.

### Manage Member Groupings (Segments)
List all existing segments, check a segment’s current member count, and add specific contacts into targeted cohorts.

### Track Community Activity
Retrieve activity feeds to understand engagement patterns and identify key contributors across the community.

### Examine Organizations
Search for specific organizations within your network and retrieve their detailed profile information.

## Use Cases

### Identifying Key Contributors
A DevRel Lead needs to find their 10 most active users. They ask their agent, which uses 'search_contacts' and activity feeds, to compile a list of members who have shown high engagement in the last month.

### Onboarding New Leads into Cohorts
A Growth Marketer finds a promising new contact. They ask their agent to first 'get_contact_by_email' for verification, and then use 'add_contact_to_segment' to place them immediately into the 'Enterprise Leads' segment.

### Audit Segment Membership
A Community Manager suspects a segment is missing key members. They ask their agent to run 'list_segments', check the status of the target group with 'get_segment_status', and then use 'list_segment_members' to verify the roster.

### Researching Business Partners
A team needs background on a potential partner. They ask their agent to use 'search_organizations' and retrieve all details, including associated contacts, in one conversational step.

## Benefits

- Instant contact lookup: Use 'get_contact_by_email' to pull a member’s full profile history in seconds, eliminating manual research.
- Precise segmentation: Quickly list all available groups using 'list_segments,' then use 'get_segment_status' to see real-time member counts without navigating dashboards.
- Targeted action: Your agent can execute the 'add_contact_to_segment' tool, letting you update a user’s cohort status with a single command.
- Engagement insights: Pull activity feeds and use tools like 'list_activity_types' to understand exactly how and when members are contributing value.
- Efficient searching: Instead of using multiple filters, run a broad search across contacts with the 'search_contacts' tool for all your criteria at once.

## How It Works

The bottom line is that your AI client uses this MCP to speak directly to Common Room’s database, turning conversation into actionable community insights.

1. Connect the Common Room MCP to your AI client by providing your API token.
2. Use natural language commands, like 'Find all contacts in the Beta Testers segment,' allowing your agent to interpret complex requests.
3. Your agent executes the command and returns structured data, whether it's a list of segments or specific member details.

## Frequently Asked Questions

**How do I use the Common Room MCP if I don't know a member's email?**
You can search for contacts using keywords, names, or organization details via the 'search_contacts' tool. This lets you narrow down your results even without a specific email address.

**Can Common Room MCP help me update member groups automatically?**
Yes. You can use the agent to add contacts to segments using the 'add_contact_to_segment' tool, automating the process of cohort management based on new criteria.

**What kind of activity information can Common Room MCP provide?**
The MCP allows your agent to retrieve full activity feeds and list supported activity types. This gives you detailed insights into when members last engaged or what actions they performed in the community.

**Is this better than just using the Common Room web dashboard?**
It's faster because your agent speaks to the data directly. Instead of clicking through multiple tabs, you ask it a single question and get an immediate, structured answer, saving time on every research task.

**Does Common Room MCP help me manage my entire community database?**
It provides access to the core functions for managing contacts, segments, and organizations. You can list all segments and even check their current status and member counts instantly.