Skip to main content
The Sintropix MCP server lets an AI assistant that speaks the Model Context Protocol (MCP), such as Claude or ChatGPT, read your books. You ask in plain language, for example “What do my customers owe me?”, and the assistant answers from your Sintropix data. The server reads your books. It can’t create, change, or delete anything in them. The one thing it sends is feedback about Sintropix itself, which changes no data.

​
Connect

1

Add the server to your assistant

In your assistant’s settings, add a custom connector (or custom MCP server) and paste the server URL https://mcp.sintropix.com/mcp. The server uses OAuth, so you don’t need an API key or any other secret.
2

Sign in to Sintropix

The assistant opens Sintropix in your browser. Sign in with your password and second factor. If you haven’t set up two-step verification yet, Sintropix asks you to do it first.
3

Pick the Organization

Choose the Organization the assistant will read (Elige la empresa). If you hold a Membership in only one Organization, Sintropix skips this screen.
4

Approve

Check the request: the app name, the domain it returns you to (Te devolverá a), the Organization, and the access, which is Solo lectura. Click Permitir. The assistant is now connected.
Each connection reads one Organization, and every company (Entity) in it. To read another Organization, approve the assistant again and pick that Organization. Each approval appears as its own row in Tu cuenta > Apps conectadas. The assistant registers itself with Sintropix the first time you connect. An assistant that returns to a custom scheme with a host, such as cursor://, can’t register, so it can’t connect. See the redirect URIs an app can register.

​
Access

  • The assistant reads as you, in the Organization you approved, with your Role there. Any Role can read, so staff, client, and viewer Users can all connect.
  • If you lose your Membership in the Organization, the connection ends.
  • Revoke the connection at any time from Tu cuenta > Apps conectadas in the Sintropix app. The assistant loses access at once, and asks you to sign in again the next time it needs Sintropix.
  • The access token lasts 1 hour, and the assistant renews it on its own. If the assistant goes 30 days without renewing it, it asks you to sign in again.
See Connect an app with OAuth for the full rules of connected apps.

​
Tools

The server exposes six tools. Five read your books, and leave_feedback tells the Sintropix developers what got in the assistant’s way. Each one answers a question, rather than mirroring an API endpoint. Amounts come back as decimal text in the company’s functional currency, and accounts and Partners come back with their names.

​
list_entities

Lists the companies the connection reads. Each item has entityId, name, taxId, country, currency, and organization (the Organization’s name). The assistant calls it first to find the entityId the other tools take.

​
get_receivables and get_payables

List the open lines of each receivable or payable Ledger Account of the company, oldest first. Each line has its date, due date, Partner, invoice, memo, and open amount. A positive open amount is owed to the company in get_receivables, and owed by the company in get_payables. get_payables also lists what the company owes people on approved Expense Claims, under its Rendición por pagar accounts.
  • A line with no invoice is an Unapplied Item, such as a payment received on account. The assistant reports it beside what is owed, never netted against it.
  • Each account returns up to 100 open lines. openLinesNotShown counts the rest.
  • These tools read the accounts whose Sub-type is receivable or payable in the chart of accounts. If the company marks no account with that Sub-type, the answer has no accounts and a note that says so. It doesn’t mean nothing is owed: the assistant reads the balances with get_balance_sheet instead.

​
get_income_statement

Returns the income statement (Estado de Resultados) for a period: income, cost of goods sold, operating expenses, other income, and other expenses, each with its accounts and total. It also returns the gross profit, the operating result, the operating margin (a ratio, null with no income), and the net result.

​
get_balance_sheet

Returns the balance sheet (Balance General) on a date: assets, liabilities, and equity, each with its accounts and total. The equity section also carries the result of prior Fiscal Years and the result of the Fiscal Year up to the date. The Fiscal Year is the Entity’s own (see The Fiscal Year in reports), and the answer names the day it starts.

​
leave_feedback

Sends Feedback to the people who build Sintropix: a bug, an answer that confused the assistant, a possible improvement, a papercut, a nit, or something it wanted to do and couldn’t, with what it did instead. The assistant sends it on its own, right when it hits the problem, one problem per call. It doesn’t need to tell you or ask you first, because Feedback is about the product, not about your books. Feedback changes nothing in your books, so a Solo lectura connection sends it too. The tool asks the assistant to keep client data out: it sends ids and requestIds, not names, amounts, or document contents. See Keep client data out. The inputs follow the same rules as POST /api/feedback. The tool answers feedbackId, the id of the stored Feedback. If an input breaks a rule, the tool answers an error that names each field and says what to fix, for example kind must be one of: bug, improvement, papercut, nit, missing_capability, and sends nothing.

​
Example questions

  • “Which of my companies can you see?”
  • “What does Acme SpA’s customer list owe us, oldest first?”
  • “Which bills of Acme SpA are past due?”
  • “What was Acme SpA’s net result from January to June?”
  • “Show me Acme SpA’s balance sheet at the end of last month.”

Connect an App with OAuth

Scopes, tokens, approvals, and how to list and revoke connected apps.