# Interact Software MCP MCP > Interact Software MCP connects your agent directly to internal corporate knowledge. It lets you query employee records, map departmental structures, and pull content history from any existing intranet system via the Interact API. Need to know who works where or what the latest policy update is? This gives your AI client full read access to your organization's directory, news feed, and group data. ## Overview - **Category:** collaboration - **Price:** Free - **Tags:** intranet, internal-communications, employee-engagement, knowledge-retrieval, corporate-news, group-management ## Description Need to figure out if a new hire needs access to the finance department files? Or maybe you just need to check which teams were involved in last quarter’s product launch? With this MCP, your agent goes straight to the source. It accesses employee records, maps out groups and departments, pulls up the latest news feed, and even checks usage stats for specific content—all from one place. You don't have to juggle multiple integrations; everything talks through this connector. By connecting it via Vinkius, you give your AI client a single pane of glass view of all corporate data. It’s ideal for automating internal communications and knowledge retrieval when context matters. ## Tools ### get_analytics Pulls usage statistics about how people interact with the corporate intranet content. ### get_person Retrieves specific details for one user, including their role and contact information. ### list_content Lists all available general content items published on the intranet. ### list_departments Provides a full list of every department recognized by the company structure. ### list_events Lists all upcoming or past internal events scheduled on the intranet. ### list_groups Provides a comprehensive list of every defined collaboration group within the organization. ### list_locations Lists all physical office locations or operational sites for the company. ### list_news Retrieves a feed of the latest published articles and corporate updates. ### list_people Lists every user account registered in the intranet directory. ### search Searches simultaneously across content, people profiles, and group names for a keyword. ## Prompt Examples **Prompt:** ``` List all people in the 'Marketing' department. ``` **Response:** ``` I'll fetch the list of users in the marketing department for you. ``` **Prompt:** ``` Show me the latest news articles on the intranet. ``` **Response:** ``` I'll retrieve the latest news articles and updates from your corporate intranet. ``` **Prompt:** ``` Search for 'remote work policy' in Interact. ``` **Response:** ``` I'll perform a global search for that policy across the intranet. ``` ## Capabilities ### Query User Details Retrieve specific profile information or organizational roles for any employee. ### Map Organizational Structure List all departments, groups, and physical locations used across the company. ### Search Corporate Knowledge Perform a global search across content, people, and collaboration groups simultaneously. ### Track Content & News List all published news articles or general intranet content items available to users. ### Analyze Usage Metrics Pull specific analytics related to how the intranet is being used overall. ## Use Cases ### Onboarding a new Project Lead A manager needs to know who all the stakeholders are for a new project. They ask their agent: 'Who is in departments A, B, and C?' The agent uses `list_people` and `list_departments` to build a complete roster, saving hours of manual cross-referencing. ### Checking Policy Compliance The compliance team needs to audit who has access to sensitive documents. They use the MCP to check group memberships via `list_groups` and verify which users are linked to those groups, ensuring nobody has excess privileges. ### Planning a Company Town Hall The internal communications team needs an agenda that covers current company priorities. They ask their agent to pull the `list_news` and `list_events` for the last month, guaranteeing they hit all key topics. ### Understanding Product Scope A developer is starting work on a legacy system and needs to know who developed it. They ask their agent to 'Search for the initial owners of Project X,' using the `search` tool across people, groups, and content. ## Benefits - No more manual lookups. Instead of checking multiple systems for user data, one call to `get_person` gives you a person's entire profile and department in one go. - Stay current with company announcements. Use `list_news` to instantly pull the latest policy changes or corporate updates without navigating deep into the news feed. - Quickly scope out organizational complexity. By running `list_departments`, your agent maps the full hierarchy, letting you understand reporting lines fast. - Find people faster than ever. The combination of `list_people` and `search` means you can locate a contact by name, department, or project group immediately. - Audit usage patterns with ease. Running `get_analytics` gives you objective data on which parts of the intranet are getting used most often. ## How It Works The bottom line is that you get accurate, real-time organizational context without having to manually navigate departmental directories or search multiple systems. 1. Your agent identifies a need, for instance, 'Find all users in the Product department.' 2. The MCP calls the necessary functions, such as `list_people`, and filters the results based on your criteria. 3. It returns structured data containing names, roles, group memberships, and other details to your AI client. ## Frequently Asked Questions **How does list_people work with get_person?** The `list_people` tool provides a directory of everyone registered. Use it to find the ID or name, then pass that specific identifier to `get_person` to pull detailed profile information for just one person. **Can I use search to find old content?** The `search` tool is best for general keywords. If you need a list of all available corporate articles, it's safer and more direct to run `list_content` first. **Which tool lists the departments?** The dedicated function for this is `list_departments`. It provides an organized view of every defined division in your company structure. This avoids ambiguity found with a general search. **Do I need to use list_groups if I want to find teams?** Yes, `list_groups` is the specific tool for collaboration groups. It gives you an organized view of defined working units separate from the official departmental structure. **What data schema should I expect when running list_content?** The output provides structured metadata for every item. You'll get the content title, author ID, publication date, and a full text summary field. This helps you determine if the piece is relevant before fetching the full body. **Are there rate limits or throttling rules when I call get_analytics?** Yes, the API enforces standard usage limits to ensure stability for all users. It's best practice to cache results from analytics calls and only refresh data every few hours in your agent workflow. **Do I need special permissions or scopes to use get_person?** You must authenticate with the appropriate API key that includes 'read user profile' scope. Without this, the tool won't be able to retrieve any details for a person. **Does list_locations only return physical office sites?** No, it returns all registered organizational locations. This includes both physical addresses and virtual headquarters or departmental hubs that are tracked in the system. **How do I get Interact API credentials?** You need to generate an API Key within your Interact intranet administration settings. You also need your tenant identifier and application ID (appid). **What is the 'appid'?** The appid is the unique ID of the application or connector you created in Interact. You can find it in the URL when editing the connector. **Can I search across the intranet?** Yes, the search tool allows you to perform global searches for content, people, and groups within your Interact intranet.