# Workload MCP MCP > Workload MCP gives your AI client full control over business automation and workflow orchestration. Use it to build visual automations that connect disparate apps, manage process lifecycles programmatically, and eliminate repetitive manual checks across complex operations. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** workflow-automation, process-orchestration, business-process, real-time-tracking, integration-platform ## Description This connector lets you stop manually checking dashboards for failed processes. Instead, your agent becomes the dedicated ops coordinator for all your automated workflows. You can pull a complete directory of active automations and track their detailed history—knowing exactly which steps succeeded or where they failed. Need to scale up? The MCP helps monitor account-level API connectivity and tracks overall orchestration volume so you never hit unexpected limits. Best part is that when you connect it via your preferred AI client, Vinkius AI Analytics gives you full visibility into every single tool call: what data moved, which workflows ran, and how much budget was used. You don't have to guess what your system is doing; the platform shows it all. ## Tools ### check_workload_status Checks if your Workload account's API connection is currently active and working. ### create_workflow Builds a new automated workflow based on your instructions. ### disable_workflow Pauses an existing workflow to prevent it from running until you reactivate it. ### enable_workflow Resumes a previously disabled or paused automated workflow. ### get_connection Retrieves detailed information about your current API connection settings. ### get_execution Pulls specific details about a single run of an automated process. ### get_workflow Gets the full definition and metadata for one particular workflow. ### list_executions_by_workflow Filters and lists all executions that belong to a specific named workflow. ### list_connections Shows all API connections you have set up within Workload. ### list_executions Provides a summary list of many completed or failed automated runs over time. ### list_logs Retrieves the detailed, step-by-step logs for one or more workflows. ### list_workflows Returns a full directory listing of all automated workflows you have created. ### retry_execution Forces the system to run an execution again, useful if it failed due to a temporary error. ## Prompt Examples **Prompt:** ``` List all active workflows in my Workload account. ``` **Response:** ``` I've retrieved your workflows. You currently have 10 active high-fidelity profiles, including 'CRM Sync' and 'Invoice Flow'. Would you like the detailed trigger metadata for any of them? ``` **Prompt:** ``` Show the execution history for the 'Invoice Flow' (ID: wf_123). ``` **Response:** ``` Execution intelligence orchestrated! For workflow wf_123, I've identified the last 5 high-fidelity runs. 4 were successful and 1 failed at 2:00 PM today. I've retrieved the technical error metadata for your review. Need help auditing the failure? ``` **Prompt:** ``` Check my Workload orchestration metrics for this month. ``` **Response:** ``` Operational monitoring complete! This month, your account has processed 1,000 high-fidelity workflow tasks, with a 98% success rate. Your API connection is healthy. Shall I retrieve the detailed execution breakdown by trigger? ``` ## Capabilities ### Manage workflow processes Create, enable, or disable entire automated business workflows using a conversation. ### Audit execution history Pull detailed records of past runs to check success rates and find specific errors from failed automations. ### Retrieve process metadata Get high-fidelity details about workflows, connections, or individual task executions for debugging and reporting. ### Track system health Verify your API connection status and monitor the current operational volume of automated processes. ### Rerun failed automations Manually initiate a retry for specific executions that previously encountered errors. ## Use Cases ### Debugging a failed billing sync A developer asks the agent to investigate a missed invoice. The agent first uses `list_executions_by_workflow` to find runs for 'Billing Sync', then calls `get_execution` on the suspicious ID, and finally retrieves specific error details using `list_logs`. This pinpoints the exact failure point in minutes. ### Onboarding a new automation An Ops Manager wants to build a new process. They start by calling `get_connection` to confirm API credentials, then use `create_workflow` with instructions, and finally run `list_workflows` to verify the new process appears in their directory. ### Auditing performance metrics A Growth Engineer needs quarterly reports. They ask the agent to list all workflows (`list_workflows`) and then request a summary of the last 50 runs using `list_executions` for compliance review. ### Scaling operations during peak load The team is scaling up. They use the agent to check if API limits are near by calling `get_workflow` on a critical process, ensuring it's ready before traffic spikes hit. ## Benefits - Instead of checking logs manually, you can use `list_logs` to get the detailed technical steps for any workflow run. - Need to stop a process immediately? Use `disable_workflow` when testing or maintenance is required. You'll know exactly how to restart it with `enable_workflow`. - If an automation fails, you don't wait. You can use `retry_execution` right through your agent to attempt the task again instantly. - You can get a high-level view of everything by using `list_workflows` to see all available processes at once. - Track system health and make sure everything is connected by running `check_workload_status` anytime. ## How It Works The bottom line is that your AI agent acts like an internal systems architect, talking directly to your automation platform instead of relying on manual dashboard clicks. 1. Connect your API Key to the Workload MCP from any compatible AI client. 2. Ask your agent to list all available workflows or check a specific process's status. 3. The agent pulls the required metadata and history, presenting you with actionable reports in natural language. ## Frequently Asked Questions **How do I see if my Workload API key is connected?** Run `check_workload_status` with your agent. This verifies connectivity and confirms that the credentials are working right now, preventing hours of debugging later. **Can I list all workflows using list_workflows?** Yes, running `list_workflows` gives you a comprehensive directory of every automated process available in your account. It's the starting point for auditing any system. **What is the difference between list_executions and list_executions_by_workflow?** `list_executions` shows you a general feed of all runs across all processes. Use `list_executions_by_workflow` when you only care about tracking the history for one specific, known workflow. **If an automation fails, how do I fix it with retry_execution?** First, find the failed run ID using `get_execution`, then tell your agent to execute `retry_execution` on that specific ID. This forces a clean attempt without manual intervention. **What steps do I follow when setting up a new automation using the `create_workflow` tool?** You provide the necessary parameters and structure for the flow. This tool lets you define the start trigger, intermediate actions, and end goals for your process. It’s how you build out an entirely new business routine within Workload. **How do I get granular error details using the `list_logs` tool?** The tool retrieves a detailed step-by-step log of the entire workflow run. You'll see exactly which action failed, what data was involved at that moment, and often the technical reason for the failure. **What kind of metadata can I retrieve about a specific automation using `get_workflow`?** You get all the high-level details about an existing workflow. This includes its defined triggers, associated connection IDs, and the full list of steps it's built from. **How do I audit my credentials by running `list_connections`?** This tool lists every single API key or service account connected to your Workload environment. It’s a quick way to see exactly which applications are linked and manage security scope. **How do I find my Workload API Key?** Log in to your account, navigate to **Settings** > **API**, and copy your unique Access Token from the credentials section. **Can I check workflow execution results via AI?** Yes! The `list_workflow_executions` tool allows your agent to retrieve high-fidelity success/failure metadata for all your automated runs. **How do I list my active workflows?** Use the `list_workload_workflows` tool to retrieve your complete high-fidelity directory along with the unique identifiers for all managed automations.