How to Use the TOTVS MCP in Cursor

Q: How do I query specific records using TOTVS and Cursor?

You use getrmdata directly in your editor. When you write a function that needs data, the agent calls this tool, and the live result is provided as a structured JSON object for your code to consume.

Q: Can I get employee lists with TOTVS and Cursor?

Yes. You can call listemployees to retrieve a list of all users in the HR module. This data is immediately available as a variable, letting you process it within your current coding session.

Q: How does MCP Server handle TOTVS document listing in Cursor?

The listdocuments tool pulls metadata from Fluig ECM. When writing code that processes documents, the agent provides this list so you can write functions that iterate over known file IDs.

Q: What data privacy measures are used with TOTVS and Cursor?

The server limits access to specific fields when calling getemployeedetails. You only receive the exact details required for your function, minimizing exposure of sensitive employee information.

Q: How can I check process status using TOTVS and Cursor?

You use listprocesses to find available workflows. Then, you write code that uses getprocessrequest to pull the current state of a specific request ID.

Write code against TOTVS APIs in Cursor, generating live data responses.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect TOTVS MCP to Cursor

Create your Vinkius account to connect TOTVS to Cursor and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup TOTVS with Cursor

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Query specific ERP records.

The tool `get_rm_data` lets your AI client query a precise record from any RM DataServer. You write the code; the agent fills in the data response for that record. This capability means you don't have to mock API calls anymore. The live TOTVS data gets injected straight into your function body, letting you build against real context.

List company and branch structures.

Need to know the full scope of a client? Use `list_companies` to get every legal entity and associated branch in the Protheus environment. This list is perfect for iterating over different operational units. When you write code that needs to target multiple subsidiaries, this tool provides the complete list structure your script requires.

Track financial accounts.

Your agent can handle both sides of accounting. Write a block that first calls `list_payments` and then uses `list_receipts`. This allows you to compare open payables against incoming receivables. It's perfect for building reconciliation scripts, letting your code work with accurate financial data from the TOTVS system.

Setup guide

Set up TOTVS MCP in Cursor

Prerequisites

Cursor installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP Settings

Go to Cursor Settings → MCP or open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and search for "MCP: Add Server".
2

Add the TOTVS MCP

Cursor will create or open .cursor/mcp.json in your project root. Paste the JSON snippet on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Enable Agent mode

Open Composer (Cmd+I / Ctrl+I) and switch to Agent mode using the dropdown at the top. MCP tools are only available in Agent mode.
4

Verify the connection

Ask Cursor something like "List my recent TOTVS transactions." If the MCP tools are loaded correctly, Cursor will call the TOTVS tools automatically. You can also check Settings → MCP for a green status indicator.

.cursor/mcp.json

{
  "mcpServers": {
    "totvs-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by TOTVS. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect TOTVS now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about TOTVS MCP in Cursor

You use `get_rm_data` directly in your editor. When you write a function that needs data, the agent calls this tool, and the live result is provided as a structured JSON object for your code to consume.

Yes. You can call `list_employees` to retrieve a list of all users in the HR module. This data is immediately available as a variable, letting you process it within your current coding session.

The `list_documents` tool pulls metadata from Fluig ECM. When writing code that processes documents, the agent provides this list so you can write functions that iterate over known file IDs.

The server limits access to specific fields when calling `get_employee_details`. You only receive the exact details required for your function, minimizing exposure of sensitive employee information.

You use `list_processes` to find available workflows. Then, you write code that uses `get_process_request` to pull the current state of a specific request ID.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript