How to Connect Rivile GAMA to Cursor via MCP

💡 No install? Use cloud.anythingmcp.com directly. Sign in, click Connectors → Rivile GAMA, paste your credentials, mint an MCP API key and you're done. No Docker, no git clone, no local server.

Rivile GAMA + Cursor

Connect Rivile GAMA, the Lithuanian ERP and accounting system, to Claude or ChatGPT through the Rivile API v2: clients, products, stock balances and prices, purchase and sales documents, debts and payments, ledger balances and the chart of accounts, with T-SQL filters. Edits ship switched off.

Prerequisites

See the full setup instructions baked into the connector (visible in the in-app store when you select the connector). The required environment variables for this connector are:

RIVILE_API_KEY

Step 1 — Get credentials

Setting up the connector takes a few minutes once Rivile has enabled API v2 for you. You need Rivile GAMA version 119 or later, an API access agreement with Rivile, the Manorivile-Gateway running next to your GAMA database, and the API key Rivile issued with the service.

1. Make sure the Manorivile-Gateway is installed on a computer or server that reaches your GAMA database. Your Rivile partner installs it. It must be running for any call to work.
2. Paste the API key Rivile gave you into RIVILE_API_KEY, alone, without quotes or spaces. It has the form user name, dot, secret, for example XW3CDDX.Bfnjvrurjygzuj....
3. Install the connector and run rivile_list_divisions: it lists your divisions (padaliniai), which shows that the key and the gateway both work.

The key works as a GAMA user: the part before the dot is the Rivile GAMA user the API acts as, so the AI sees what that user sees. Rivile also enables the methods per key in your API agreement: a method that is not enabled answers with the message "neturi leidimo vykdyti metodą".

Each call may be billed by Rivile: Rivile bills the API by the number of requests. So the AI prefers one well filtered call over many pages, and filters on the key of the last record it got instead of paging deep.

How Rivile names things: tables have a letter and two digits (N08 clients, N17 products and services, I06 purchase and sales documents with lines I07), and fields carry the table code plus a suffix: N08_KODAS_KS is the client code in table N08. Filters are T-SQL conditions without the word WHERE, such as n08_pav like '%ACME%' or a document date between two YYYY-MM-DD dates. Codes are upper case and decimals use a dot.

What it reads: client cards (customers and suppliers alike) with codes, VAT codes, address and payment terms; product and service cards; stock balances per product, division, object and series, including reserved quantities; prices per division; purchase and sales documents with their lines, also joined with division, client and product fields; internal operations such as transfers and write-offs; debts per document with due dates (the best source for an overdue list) and debt totals per client; debit and credit operations; bank and cash payments with the documents they settle; the receipts and payments register; ledger operations and account balances with turnover for a period; the chart of accounts, objects, purchase and sales codes, VAT classifiers (PVM klasifikatoriai), currencies, contracts and import and export batches. rivile_call_read_method reaches any other read method, for example price lists, units, fixed assets, CRM or employees.

Switched off at install: rivile_edit_client, rivile_edit_product, rivile_edit_document and rivile_create_document. Each call creates, updates or deletes one record in Rivile GAMA, and rivile_create_document posts a whole purchase or sales document with its lines to the books. An administrator turns on only what is needed, and even then the AI shows you the client, lines and totals and waits for your yes.

Limits: every list returns at most 100 records, and without a filter the first page of documents holds the newest. Rivile allows 10 requests a second per key; after a 429 the AI waits at least a second.

Common errors: 401 means the API key is wrong or expired. 502 means the Manorivile-Gateway is not running or cannot reach the database. 504 means the database answered too slowly: narrow the filter. 400 names the faulty field or filter with the database's message, or says the key may not run that method.

The connector has no write tools for payments, POS, gift cards or payroll, and no tool moves money.

Step 2 — Install the adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Step 3 — Add the connector in Cursor

Your server URL: in AnythingMCP, open MCP Servers → the server this connector is on, and copy its URL (https://cloud.anythingmcp.com/mcp/…). Use it wherever this guide shows YOUR_SERVER_ID.

Cursor reads MCP servers from ~/.cursor/mcp.json. Add this entry:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Create an MCP API key in AnythingMCP under MCP Servers → your server → API keys, and paste it in place of YOUR_MCP_API_KEY.
2. Save the file and restart Cursor.
3. Open Cursor → Settings → MCP and check that anythingmcp is listed and connected.
4. Start chatting: the agent can now call the Rivile GAMA tools.

Available tools

Example prompts

• "Which clients have debts more than 30 days overdue, and how much does each of them owe?"
• "How much of product 10045 do we have in each division, and how much of it is reserved?"
• "Show me this month's sales documents for UAB Statybų centras with totals and VAT."
• "Give me the ledger account balances and turnover for September, summed by account."
• "Which payments did we receive last week, and which invoices did they settle?"

FAQ

Does Cursor support custom MCP servers on the free tier? Yes, MCP is available on Hobby, Pro and Business plans.

Next steps

• Connector landing page
• Connect to Claude
• Connect to ChatGPT