# AlisQI MCP > AlisQI connects your AI agent directly to your Quality Management System (QMS) for full data auditing and result orchestration. You can list, retrieve, and store quality results, check metadata definitions across analysis sets, and monitor webhooks—all through natural conversation. This MCP lets you manage complex compliance data without leaving your chat interface. ## Overview - **Category:** erp-operations - **Price:** Free - **Tags:** quality-management, qms, manufacturing, data-auditing, workflow-automation, compliance ## Description Manually auditing technical reports or tracing a specific field's definition can be a headache. AlisQI gives your AI agent the keys to your entire quality operation. You stop copying and pasting between tabs; instead, you simply ask questions like, “Show me all results for lot 45 that failed moisture testing.” Your agent handles the query, pulls the data, and presents it in plain language. It lets you look up technical metadata for fields, list every active webhook monitoring non-conformities, or even write new quality records if they've been manually verified. This level of operational visibility is huge. When you connect AlisQI via Vinkius, your agent doesn't just read data; it orchestrates the entire workflow—from schema discovery to final result storage—all from one place. ## Tools ### list_analysis_sets Provides a list of every configured analysis set within your account. ### get_analysis_set_details Retrieves specific metadata for a defined analysis set. ### list_results Finds and lists quality results, supporting filtering by various criteria. ### get_result_details Retrieves the full details of one specific quality result entry. ### store_results Creates or updates a specific quality result entry in the system. ### list_fields Lists all dynamic fields defined within an analysis set to understand the schema. ### list_choice_lists Retrieves the available options from selection menus used in quality data entry. ### get_result_attachments Lists and provides technical metadata for documents attached to a quality result. ### list_active_webhooks Lists all currently active system triggers or webhooks for monitoring events. ### get_api_info Checks the current operational status of the API connection. ## Prompt Examples **Prompt:** ``` List all analysis sets available in my AlisQI instance. ``` **Response:** ``` I've retrieved your analysis sets. You have 5 sets configured, including 'Raw Material Inspection', 'Final Product Audit', and 'Environmental Monitoring'. Would you like to see the field definitions for any of them? ``` **Prompt:** ``` Show the last 5 quality results for 'Raw Material Inspection'. ``` **Response:** ``` I've retrieved the latest 5 entries for Raw Material Inspection. All results were within specification limits, except for entry #98765, which showed a minor deviation in moisture content. Would you like the full details for that entry? ``` **Prompt:** ``` Check if there are any active webhooks for non-conformities. ``` **Response:** ``` I've checked your integration settings. You have 1 active webhook (ID: wh_123) configured to trigger when a non-conformity is detected. It is currently sending data to your incident management system. There are no reported errors. ``` ## Capabilities ### Audit Quality Records Retrieve and analyze specific quality results or list all available analysis sets in your system. ### Understand Data Structure List and audit the field definitions within any analysis set to understand exactly what data is being tracked. ### Manage Compliance Documents Get technical metadata for attached documents, helping you track quality documentation integrity. ### Monitor System Triggers List active webhooks to confirm that critical events, like detected non-conformities, are correctly triggering downstream systems. ### Write and Update Data Create or modify quality results directly through the chat interface for immediate compliance logging. ## Use Cases ### Auditing Material Batch Compliance A Quality Manager needs to check if all environmental monitoring reports for the last quarter passed inspection. They ask their agent, which uses `list_results` and then `get_result_details`, pulling up every necessary entry so they can sign off quickly. ### Investigating a Schema Discrepancy A Data Engineer notices that the 'Batch ID' field is missing from a new set of reports. They use `get_analysis_set_details` and then cross-reference it with `list_fields` to confirm if the metadata definition was updated correctly. ### Confirming Workflow Alerts An Operations Lead wants assurance that when a temperature deviation happens, an alert gets sent immediately. They run `list_active_webhooks` to verify the webhook ID and check if it's pointing to the right incident management system. ### Logging Immediate Corrective Action A Lab Technician finds a minor deviation during testing. Instead of filling out paper forms, they use `store_results` through their agent, logging the exact details and attaching relevant metadata in minutes. ## Benefits - Instead of manually navigating through tabs to see available audit templates, you can use `list_analysis_sets` to get a full list instantly. This saves time when starting a new compliance check. - When you need to know what fields are available for data entry, running `list_fields` tells you the exact schema without having to consult documentation or guess at API endpoints. - If a critical process needs an automated alert (like a failed non-conformity), use `list_active_webhooks` to confirm that the trigger is set up and sending data correctly. - Need to audit records? You can run `list_results`, using filters to narrow down thousands of entries, then pull specific details with `get_result_details`. It’s powerful filtering without the spreadsheet work. - When a result needs correcting or logging, you don't need another system. Use `store_results` directly through your agent to write and update data while maintaining a clear audit trail. ## How It Works The bottom line is you talk to it like a teammate and get structured quality data back instantly. 1. First, subscribe to this MCP and provide your AlisQI Instance URL and Bearer Token. 2. Next, your AI client uses these credentials to connect to the quality management API. 3. After connecting, you can immediately use natural language prompts to ask questions about results, metadata, or workflow status. ## Frequently Asked Questions **How do I check if my webhooks are working with the `list_active_webhooks` tool?** You simply ask your agent to list active webhooks. It confirms which ID is running and whether there are any reported errors, letting you know instantly if your non-conformity triggers are live. **Can I use `list_results` to find specific data points?** Yes. You tell the agent what criteria you're looking for, and it uses advanced filtering on `list_results`. It doesn't just give you a list; it narrows down complex datasets based on your input. **What is the difference between `get_analysis_set_details` and `list_analysis_sets`?** Use `list_analysis_sets` to see *all* available sets in the system. Use `get_analysis_set_details` when you want deep, specific metadata about one single set. **I need to update a result. Which tool should I use? Is it `store_results`?** Yes, `store_results` is the correct tool for creating or updating entries. You just tell your agent which fields you're changing and what the new values are. **How do I find out what documents relate to a result using `get_result_attachments`?** You provide the specific result ID, and the tool returns all technical metadata for every attached document. This helps you track compliance documentation without manually checking folders. **I need to understand my data structure; what does `list_fields` show me?** It provides a complete list of all dynamic fields available in your system. This is crucial for auditing your full data model, showing you every possible field definition that quality results can contain. **Before running any reports, how do I check the API connection status using `get_api_info`?** This tool confirms the current operational status of your AlisQI instance. Use it to verify connectivity and ensure all core services are accessible through the MCP before initiating data retrieval or write operations. **If I want to audit standardized vocabularies, how do I use `list_choice_lists`?** It retrieves a list of every predefined choice menu used in your quality reports. This helps you verify the controlled vocabulary—like material grades or test types—ensuring data consistency across all records. **How do I find my AlisQI Bearer Token?** Log in to AlisQI, navigate to **Menu** > **Management** > **Integration Hub**. You can generate and manage your API tokens there. Each token inherits the permissions of the associated user account. **Is the data model the same for everyone?** No, AlisQI uses a dynamic, user-defined data model. This means field names and analysis sets are specific to your company's configuration. Use the `list_analysis_sets` tool to discover your unique structure. **Can I attach files to quality results via the agent?** Currently, the agent can retrieve metadata for existing attachments using the `get_result_attachments` tool. For uploading new files, we recommend using the AlisQI web interface or specific integration endpoints.