# Common Room MCP MCP > Common Room unifies user signals from Slack, Discord, GitHub, and social media into one place. It lets your agent track who's talking about you—or working with you—across every channel. You can build a real-time view of community health, spot high-value advocates, or manage member data for compliance. ## Overview - **Category:** collaboration - **Price:** Free - **Tags:** community-intelligence, identity-resolution, signal-processing, b2b-growth, customer-insights, cross-channel ## Description Your AI client connects to this MCP and acts like a dedicated relationship coordinator for your entire user base. It pulls in activity signals from all your platforms, giving you one consistent source of truth about who your members are and what they're doing. Instead of juggling separate dashboards or manually reading logs, your agent can list and update profiles using unified identity resolution across channels like Slack and GitHub. You can monitor specific community groups—like those marked 'Highly Engaged' or 'At Risk'—to understand the overall health of your user base. It also handles the messy stuff, letting you delete member records programmatically to meet privacy rules. Getting this connected through Vinkius means you don't have to build and maintain complex integrations; you just talk to it. It’s about taking control of relationship intelligence conversationally. You get a complete picture of your community members and their activity signals without writing a single line of integration code. ## Tools ### create_member Creates a brand-new community profile record for an individual user. ### create_webhook Configures and sets up a new outgoing data webhook connection to another system. ### delete_member Removes a member's profile from the system, fulfilling GDPR or privacy deletion requests. ### delete_webhook Deletes an existing webhook connection when it is no longer needed. ### get_member Retrieves all current details for a specific community member using their identifier. ### get_token_status Checks the operational status and validity of your API token credentials. ### ingest_activity Feeds new community activity signals, like a Slack post or social interaction, into a member's timeline. ### list_members Generates a full list of all active members currently in the system database. ### list_segments Retrieves a list and details of defined community segments, like 'At Risk' or 'Power User'. ### list_tags Lists all custom tags that have been assigned to members for grouping purposes. ### list_webhooks Shows a list of currently configured webhook connections and their status. ### update_member Modifies or updates specific pieces of information on an existing member's profile record. ## Prompt Examples **Prompt:** ``` List all members in the 'Highly Engaged' segment. ``` **Response:** ``` I've retrieved the 'Highly Engaged' segment. You have 15 members in this category, including top contributors from GitHub and Slack. Would you like the Person360 profiles for the top 3? ``` **Prompt:** ``` Get the community profile for 'john@example.com'. ``` **Response:** ``` I've located John's Person360 profile. He is active on Slack and GitHub (username: john_dev). His current sentiment is 'Positive' and he is tagged as a 'Power User'. Shall I check his latest activity signals? ``` **Prompt:** ``` Report a new Slack activity for member ID 'abc-123'. ``` **Response:** ``` Activity ingested! I've successfully registered the new Slack signal for member abc-123. The interaction is now visible in their community timeline and engagement score. Need help with other members? ``` ## Capabilities ### Profile Management Create, read, update, or delete individual member records using unified identity resolution across multiple platforms. ### Signal Aggregation Automatically ingest activity signals from social posts and internal tools to build a complete timeline for each user. ### Audience Segmentation List and analyze defined community groups, such as 'Highly Engaged' or 'At Risk', based on collective behavior metrics. ### Webhooks & Compliance Manage outgoing data feeds by configuring or deleting webhooks, and execute member deletions for compliance needs. ## Use Cases ### Identifying key advocates before an event A Product Manager needs a list of the top 50 contributors for a conference. They ask their agent to run `list_segments` and filter by 'Power User' tag, then use `get_member` on those results to get full contact details for outreach. ### Responding to sudden drop-off in activity The Ops team notices a spike in users going silent. They ask the agent to run `list_segments`, check for members flagged as 'At Risk', and then use `get_member` to determine which channels they were last active on. ### Onboarding new enterprise clients A Sales Engineer needs to provision 10 new accounts. They prompt the agent with a list of emails, triggering `create_member` for each one and immediately setting up an initial webhook using `create_webhook`. ### Auditing data retention compliance The legal team mandates removing all records associated with a departed employee. They instruct the agent to run `list_members`, identify the ID, and execute `delete_member` for full audit trail cleanup. ## Benefits - Stop manually checking logs. Use `ingest_activity` to feed new social interactions into a member's timeline, so your agent tracks community activity automatically. - Know who's worth talking to. You can use `list_segments` and `list_tags` to immediately filter for 'Highly Engaged' users or specific contributor groups. - Manage data compliance easily. When you need to fulfill a privacy request, the `delete_member` tool handles the removal programmatically. - Keep your systems talking. Use `create_webhook` and `list_webhooks` to manage automated data feeds between services without manual intervention. - Build accurate profiles fast. The agent can retrieve detailed member information using `get_member` and then update that profile via `update_member` in one go. ## How It Works The bottom line is, once connected, your agent has immediate access to all community data and management functions without needing manual setup. 1. First, you subscribe to this MCP via Vinkius. Next, retrieve your dedicated API Token from the Common Room settings. Finally, use your AI client to run commands that manage member profiles or ingest signals. ## Frequently Asked Questions **How do I check if my API token is working with Common Room MCP?** You use the `get_token_status` tool. This function immediately verifies your connection and tells you if your credentials are active, saving you from failed operations later. **Can I find all members who are 'At Risk' using Common Room MCP?** Yes, run the `list_segments` tool. This lets you filter and see exactly which users fall into defined behavioral groups like 'At Risk,' helping you prioritize outreach. **What is the best way to update a member's profile using Common Room MCP?** Use the `update_member` tool. This allows your agent to modify specific fields on an existing user record, ensuring all changes are tracked and applied correctly. **Does Common Room MCP handle data deletion for GDPR?** Yes. The `delete_member` tool executes the removal of member records programmatically, fulfilling compliance requirements by managing deletions through your agent. **How do I use the create_webhook tool to set up automated data synchronization?** You configure it by specifying the target URL and the data payload type. The MCP handles the handshake, sending real-time signals directly when a member profile changes or new activity is detected. **Is there a way to run the ingest_activity tool for large batches of historical records?** Yes. You can pass batch parameters detailing the source platform and date range. This lets you backfill your member timelines and update engagement scores across years of activity. **Can I use the list_members tool to filter users based on custom tags or groups?** Absolutely. When calling `list_members`, simply provide a tag ID or segment name. This narrows down results immediately, letting you focus only on 'Power Users' or specific project teams. **How do I safely remove an old integration using the delete_webhook tool?** Running `delete_webhook` requires confirming the webhook ID. This action removes the endpoint entirely, preventing any future data from being sent to that specific location. **How do I find my Common Room API Token?** Log in to your account, navigate to **Settings** > **API Tokens**, and generate a new Bearer Token for your integration. **What is the Person360™ engine?** Person360™ is Common Room's identity resolution engine that unifies data from multiple platforms into one single member profile. **Can the agent ingest custom social signals?** Yes! The `ingest_activity` tool allows you to push any user interaction into a member's community timeline programmatically.