# TOTVS MCP for AI Agents AI Agent Connect > TOTVS lets you connect your AI agent to Brazil's largest ERP system. It handles HR, finance, and BPM workflows across Protheus, RM, and Fluig environments. You can pull employee profiles, track payments, and move business processes forward without switching tabs. ## Overview - **Category:** industry-titans - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_GbCPU18oBAMDKEVimgDQpHFBN3i97zwlitpVYxEc/ai-agent-connect - **Tags:** totvs, erp-integration, protheus, totvs-rm, fluig, hr-management, financial-control ## Description TOTVS lets you connect your AI agent to the largest technology company in Brazil and Latin America. Instead of jumping between different tabs for HR data, financial reports, or process statuses, you can just ask your agent to do the heavy lifting. It pulls from the Protheus, RM, and Fluig ecosystems to give you a single point of truth for your organization. You can check who's on leave, find a specific payment record, or see where a requisition is stuck in the workflow. It's about moving from manual data hunting to direct action. When you use this through the Vinkius catalog, you're connecting your agent once to get access to a wide array of enterprise tools. It handles the messy details of multi-system orchestration so you can focus on the actual decisions. This means your agent can pull employee profiles, monitor accounts payable and receivable, and even advance Fluig process requests. You no longer have to navigate complex menus or remember which system holds which specific record. It consolidates your HR orchestration, financial control, and BPM workflows into one interface. You get a clear view of your companies and branches, your documents, and your active processes without the usual friction of switching between different software suites. ## Tools ### get_employee_details Pull a full profile for a specific worker from the HR system. Use this to get contact info or job titles quickly. ### list_payments View all accounts payable records for your finance team. It gives you a clear list of what needs to be paid. ### list_processes See every active BPM process currently running in Fluig. Use this to monitor all ongoing workflows at once. ### list_receipts View all accounts receivable records to track incoming money. This helps you see which customers still owe a balance. ### move_process_request Push a Fluig process request to its next state in the workflow. This lets your agent advance a request without manual clicking. ## Prompt Examples **Prompt:** ``` Show me all active employees in the RM system. ``` **Response:** ``` I've pulled the employee list from your RM environment. Here is the summary: | Total Employees | Active Roles | Department Coverage | | :--- | :--- | :--- | | 142 | 12 | Operations, HR, Finance | Would you like me to pull the full profile for a specific person or list them by department? ``` **Prompt:** ``` What is the status of the purchase request for the new office equipment? ``` **Response:** ``` Checking Fluig process requests... **Request #402: Office Equipment Purchase** * **Current Status:** Pending Approval * **Current Step:** Department Manager Review * **Last Updated:** 2 hours ago Would you like me to move this to the next state? ``` **Prompt:** ``` List all the pending payments we have for this month. ``` **Response:** ``` Retrieving accounts payable from your finance module... I found **24 pending payments** totaling **R$ 45,200.00**. * **Overdue:** 4 items * **Due this week:** 12 items * **Due next week:** 8 items I can provide a detailed list of the overdue items if you'd like. ``` ## Capabilities ### Pull employee profiles Get specific details for any staff member in the HR module. ### Track payment statuses View all accounts payable and receivable records in one go. ### Advance workflow requests Move a Fluig process to its next required state. ### Query RM records Fetch specific data points from your RM DataServer. ### List organizational branches See all companies and branches within the Protheus environment. ## Use Cases ### HR Audit and Staff Overview An HR manager asks the agent to list all employees and then requests the detailed profile of a specific worker to check their job title. ### Monthly Finance Reconciliation A controller asks for a summary of all pending payments and then asks the agent to list all receipts from the previous month. ### Workflow Bottleneck Resolution A manager sees a stuck purchase requisition in Fluig and asks the agent to move it to the next state immediately. ### Organizational Branch Audit An analyst wants to see every company and branch in the Protheus environment to verify that all branches are correctly registered. ## Benefits - Stop manual data entry for HR by using list_employees to get staff lists instantly. - Spot overdue payments faster by using list_payments and list_receipts to see all balances. - Clear workflow bottlenecks by using move_process_request to push tasks forward. - Access multi-system data without switching apps by using get_rm_data and list_companies. - Find specific documents in seconds using list_documents instead of searching the Fluig ECM manually. ## How It Works The bottom line is you get a unified way to manage complex Brazilian ERP data through natural language. 1. Get your credentials from the TOTVS Portal and your ERP's API settings. 2. Input your username, password, and Base URL into your connection setup. 3. Ask your agent to query specific data or perform actions across the ERP. ## Frequently Asked Questions **Can the TOTVS MCP connect to my Protheus environment?** Yes, it connects directly to your Protheus, RM, and Fluig instances to pull data and manage workflows. **How do I use the TOTVS MCP for HR tasks?** You can ask your agent to list all employees or pull specific profile details to quickly handle HR requests. **Can this help with my Fluig business processes?** Yes, it allows your agent to track active processes and move requests to the next state automatically. **Does the TOTVS MCP handle my financial data?** It can list both accounts payable and accounts receivable, letting you monitor payments and receipts easily. **Is the TOTVS MCP compatible with my AI client?** It works with any MCP-compatible client like Claude, Cursor, or Windsurf. **How do I set up the TOTVS MCP?** You'll need your TOTVS Portal credentials and the Base URL from your ERP's API settings to connect. **Which TOTVS systems are compatible with this Connector?** This Connector is designed to work with standard REST APIs from Protheus, RM, and Fluig. Ensure your specific instance has the relevant API modules enabled. **How do I find my TOTVS Base URL?** The Base URL is the address of your ERP or Fluig web service (e.g., `https://erp.mycompany.com:8080/rest`). You can find this in your system's technical documentation or environment settings. **Can I automatically advance a Fluig process request?** Yes! Use the `advance_process` tool with the specific Process Instance ID. Your agent will trigger the workflow transition based on the logic defined in Fluig. **Which TOTVS systems are compatible with this MCP?** This MCP is designed to work with standard REST APIs from Protheus, RM, and Fluig. Ensure your specific instance has the relevant API modules enabled.