Common Room MCP. Manage contacts and segment data via natural language.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
Search for contacts, manage segments, and track activity using the Common Room MCP Server. This tool lets your AI agent find community members by email or name, view segment membership counts, and monitor engagement patterns.
It gives you a single point of access to build targeted segments and track who's contributing.
What your AI agents can do
Add contact to segment
Adds a specific contact to a designated segment.
Get contact by email
Retrieves full details for a member using only their email address.
Get contact tags
Gets all tags associated with a specific member.
Finds community members using email, name, or external identity by running a search against the Common Room database.
Lists all available segments, checks a segment's current member count, and allows the agent to add or remove contacts from specific cohorts.
Gets detailed information about a specific member using their email address, or retrieves all associated tags for that member.
Retrieves detailed information about a specific organization connected to the platform.
Pulls activity feeds to show engagement patterns and identify key contributors within the community.
Ask AI about this MCP
Supported MCP Clients
Gemini Waiting for input…
Common Room MCP Server: 10 Tools for Community Data Ops
Use these tools to search for contacts, check segment status, list members, and track activity feeds directly through your AI agent.
019d7578add contact to segment
Adds a specific contact to a designated segment.
019d7578get contact by email
Retrieves full details for a member using only their email address.
019d7578get contact tags
Gets all tags associated with a specific member.
019d7578get organization details
Retrieves detailed information about a specific organization.
019d7578get segment status
Checks the status and total member count for a specified segment.
019d7578list activity types
Lists all supported activity types available in Common Room.
019d7578list segment members
Lists all contacts belonging to a specified segment.
019d7578list segments
Retrieves a complete list of all segments in your Common Room account.
019d7578search contacts
Searches for contacts or members across your entire Common Room database.
019d7578search organizations
Searches for organizations within the Common Room platform.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Common Room, then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
What you can do with this MCP connector
Search and Identify Contacts: Your AI agent finds community members using search_contacts by running a search against the Common Room database using names, emails, or external IDs. To get a full member profile, use get_contact_by_email with just an email address. You can also find all tags associated with a specific member using get_contact_tags. Manage Segment Membership: Your agent can see a complete list of every segment in your Common Room account using list_segments.
You can check the current member count and status of any specified segment with get_segment_status. To see who belongs to a segment, run list_segment_members for a specific group. You can also add a specific contact to a segment using add_contact_to_segment. Retrieve Organization Data: You can pull detailed info on an organization using get_organization_details and search for other organizations using search_organizations. Analyze Activity Feeds: You can list all supported activity types using list_activity_types and pull activity feeds to see engagement patterns and identify key contributors within the community. General Search: Your agent can search for organizations using search_organizations.
How Common Room MCP Works
- 1 Add the Common Room integration to your AI toolset on Vinkius. You'll need your API Token, found in the Common Room settings.
- 2 Your AI client calls a tool function (e.g.,
search_contacts) with a natural language prompt. - 3 The Common Room API executes the function, returning structured data (e.g., member lists, segment counts, or activity summaries) directly to your agent.
The bottom line is: your agent uses your natural language commands to talk to Common Room's database, getting back structured data without you touching a web UI.
Who Is Common Room MCP For?
Community Managers, DevRel Leads, and Growth Marketing Specialists use this. You're the person who needs to know why a contact is active or who is in the 'Top Contributors' group, but you don't want to spend an hour clicking through dashboards. You need actionable data, fast.
Uses the agent to quickly search for members by name or email, and to check if a contact belongs to a key segment before running a campaign.
Uses the agent to track engagement across channels, identifying top contributors or key users by pulling activity feeds and contact tags.
Uses the agent to define and monitor targeted segments, adding contacts to cohorts like 'Enterprise Leads' based on defined criteria.
What Changes When You Connect
- Instantly find who you need. Instead of navigating search filters, your agent uses
search_contactsorget_contact_by_emailto locate a member and pull all relevant data in a single call. - Automate segment updates. Use
add_contact_to_segmentto move contacts into new cohorts, eliminating manual assignment and ensuring data consistency across your user base. - Get a full picture of members. Check a member's activity and tags by running
get_contact_tagsor viewing activity feeds, giving context beyond just their profile details. - Maintain segment visibility. Quickly see the count and status of any group using
get_segment_statusorlist_segments, without having to manually count members in the dashboard. - Cross-reference data points. When you find a contact, you can immediately get their associated organization details using
get_organization_detailsfor richer context. - Understand user engagement. Use the activity tracking tools to pull activity feeds, which helps you spot key contributors and understand what content resonates.
Real-World Use Cases
Finding a high-value prospect
A Growth Specialist needs to find all contacts who fit the 'Enterprise Lead' profile. They prompt their agent: 'Search for contacts in the 'Enterprise Leads' segment who are also connected to a company in the tech sector.' The agent chains list_segment_members and search_contacts to provide a filtered list, saving hours of manual dashboard filtering.
Re-engaging an inactive contributor
A Community Manager notices a top contributor hasn't been active in weeks. They ask the agent to 'Get the details and tags for member X and check their last activity.' The agent uses get_contact_by_email and activity tracking to provide the context needed to build a targeted outreach message.
Auditing segment assignments
A DevRel Lead needs to know exactly who is in the 'Beta Testers' segment and if anyone was accidentally left out. They prompt the agent: 'List all members in the Beta Testers segment and check if their organization details are complete.' The agent runs list_segment_members and get_organization_details to give a complete audit report.
Building a new targeted group
A Growth Specialist wants to move a key contact into a new segment. They tell the agent: 'Move Alex Chen to the 'Platinum Tier' segment.' The agent executes add_contact_to_segment automatically, confirming the status change.
The Tradeoffs
Copying data between sheets
Exporting segment data to CSV, manually filtering the list, and then updating the contacts in the Common Room dashboard. This is slow, prone to human error, and data gets outdated.
→
Use the agent to directly manage the data. Run list_segments to see all cohorts, then use add_contact_to_segment to assign members programmatically. The system updates instantly.
Calling tools one by one
Calling get_contact_by_email for a contact, then manually looking up their tags, and then running a separate query for their organization details. This breaks flow and requires multiple context switches.
→
Tell the agent to 'Get the full profile for this user.' The agent runs get_contact_by_email and then pulls the associated tags and organization details in a single, cohesive response.
Assuming data completeness
Trusting that a contact found via search_contacts has the latest organizational data. You might miss a recent company merge or name change.
→
Always verify critical details. After searching for a contact, run get_organization_details to ensure you have the most current company information before making any decisions.
When It Fits, When It Doesn't
Use this if your primary need is data intelligence: you need to find people, see who belongs where, or change a person's status based on their activity. You're modeling a community lifecycle. Don't use this if you just need to read a single field from a single record (e.g., just the name). For that, a simple database query tool is better. This server excels at managing relationships and states, allowing you to combine tools like search_contacts, get_contact_tags, and add_contact_to_segment into one workflow. If your process is 'Find X, then check Y, then do Z,' this is the right tool.
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.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 10 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
Manually tracking segment membership is a nightmare.
Today, figuring out who belongs where means jumping between the dashboard, running reports, and manually cross-referencing names. If you want to know which contacts are in the 'Platinum Tier' segment, you run the report, download the CSV, open Excel, and start manually checking names against other lists. It's tedious, and you're always working with stale data.
With the Common Room MCP Server, you just ask your agent. 'List all contacts in the Platinum Tier segment.' The agent runs `list_segment_members` and delivers a clean, structured list right into your workflow. You get the list, not a dashboard screenshot.
Common Room MCP Server: Get contact and segment status.
Before, checking a contact meant logging in, searching by email, and then clicking tabs to see tags, organization info, and segment assignments. You’d spend minutes just gathering the basic profile data.
Now, your agent runs `get_contact_by_email`. It returns the full profile—including tags and organization details—in one go. You get the full context, instantly.
Common Questions About Common Room MCP
How do I use the `search_contacts` tool? +
The search_contacts tool lets you search for members across Common Room using general criteria (name, email, etc.). You just need to tell your agent what you're looking for, and it runs the search.
Can I use `add_contact_to_segment`? +
Yes, you can. This tool adds a specific contact to a segment. You must provide both the contact's identifier and the exact name of the target segment.
Does `get_segment_status` tell me everything about a segment? +
No, get_segment_status gives you the segment's current status and total member count. To see who is in the segment, you must use the list_segment_members tool.
What is the difference between `search_contacts` and `get_contact_by_email`? +
Use search_contacts when you know general criteria (like 'all people in marketing'). Use get_contact_by_email when you know the exact email address and need the full profile.
How do I check the latest data on a member's company? +
Run get_organization_details and pass the relevant organization ID. This ensures you get the most current corporate information linked to the contact.
What is the purpose of the `list_segments` tool, and how does it help with segmentation? +
The list_segments tool retrieves a list of all existing segments. This lets your agent know which cohorts are available before you try to add or list members from them.
If I run `get_contact_by_email` and it fails, what kind of error information will I receive? +
The API returns a clear error code and a descriptive message detailing the failure. This helps your agent understand if the email is invalid or if the contact simply doesn't exist.
Can I use `list_activity_types` to understand what kind of data I can track? +
Yes, list_activity_types provides a definitive list of all supported activity types in Common Room. This ensures your agent only attempts to retrieve data for types that are actually supported.
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.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
MailerSend
Send transactional and marketing emails with templates, analytics, and deliverability tools built for developers and businesses.
CONSENSUS
Share interactive product demos with prospects that track engagement and reveal which features matter most to each buyer.
Braze
Manage customer engagement via Braze — track users, list campaigns, and trigger canvases directly from any AI agent.
You might also like
Colossyan
Automate AI video creation via Colossyan — generate videos from templates, manage avatars, and track rendering jobs directly from any AI agent.
Bugcrowd
Manage crowdsourced security via Bugcrowd — track submissions, programs, and targets directly from any AI agent.
Voyage AI (AI Embeddings API)
Generate high-quality text, multimodal, and contextualized embeddings, plus high-precision reranking for RAG workflows.