CAJAS MCP

CAJAS MCP connects AI clients to CAJAS accounting workflows through a standard MCP interface.

CommunityOnlineNo sign-inGlobalFreeRead-only

What it can do

  • Cajas.List Workspaces: Lists CAJAS workspaces/orgs available to the authenticated user. This read-only tool does not create, archive, restore, or switch workspaces.
  • Cajas.Search Raw Entries: Searches CAJAS RAW entries with pagination and filters. Supported status values are draft, queued, assembled, and voided. project and department are returned only when stored
  • Cajas.Search Events: Searches CAJAS accounting events. This read-only tool does not confirm, void, sign, approve, finalize, or alter events.

What data it sees

Do you need an account

No: the server works without sign-in

CAJAS MCP connects AI clients to CAJAS accounting workflows through a standard MCP interface.

It supports workspace discovery, RAW entry search, event search, RAW and CoA import preview flows, explainable Assembly recommendations, historical Assembly context, criterion/standard reference discovery, and optional community validation.

Authentication is required for CAJAS data access. Use CAJAS OAuth where supported, or provide a CAJAS MCP Personal Access Token as an Authorization header.

Recommendations are non-binding review signals and do not approve, finalize, sign, or mutate accounting judgments automatically.

How to connect

How to connect CAJAS MCP to Claude

The server address to paste into Claude settings:

https://cajas-mcp.run.tools

  1. Open Claude (claude.ai or the desktop app).
  2. Go to Settings → Connectors.
  3. Click Add custom connector.
  4. Paste the server address copied below into Remote MCP server URL and click Add.
  5. In a chat, click + → Connectors and switch the new connector on.

Custom connectors are available on Free, Pro, Max, Team and Enterprise plans (Free is limited to one). On Team and Enterprise an organization Owner adds the connector first under Organization settings → Connectors.

Authorization

After you click Add, a sign-in window for the service opens. Sign in with your own account and approve access. Claude never sees your password.

How to connect CAJAS MCP to ChatGPT

The server address to paste into ChatGPT settings:

https://cajas-mcp.run.tools

  1. Open ChatGPT in a browser (chatgpt.com). A Plus, Pro, Business, Enterprise or Edu plan is required.
  2. Turn on developer mode once: Settings → Apps → Advanced settings → Developer mode.
  3. Open Settings → Connectors and click Create.
  4. Fill in the form: Name (anything), Description (one line about what the service does), MCP server URL (copy it below).
  5. Under Authentication choose OAuth if the service requires sign-in, otherwise None. Click Create.
  6. In a new chat open + → Apps/Connectors and enable the connector.

OpenAI has renamed this section before (Connectors → Apps/Plugins). If the label differs, search settings for "developer mode". On Business/Enterprise workspaces an admin must allow custom connectors first.

Authorization

On first use ChatGPT opens the service's sign-in window. Sign in and approve access.

How to connect CAJAS MCP to Cursor

The server address to paste into Cursor settings:

https://cajas-mcp.run.tools

Fastest: click Open in Cursor below and confirm the prompt.

Manually:

  1. In Cursor open Settings → Cursor Settings → MCP and click Add new global MCP server.
  2. Paste the JSON copied below into ~/.cursor/mcp.json (per project: .cursor/mcp.json in the repo root).
  3. Save the file. The server appears in the MCP list; authorize it there if asked.

Authorization

If the service needs sign-in, an authorize button appears next to the server in the MCP list.

Server tool list (16)

Raw names from tools/list. Only developers need these.

cajas.list_workspacesLists CAJAS workspaces/orgs available to the authenticated user. This read-only tool does not create, archive, restore, or switch workspaces.
cajas.search_raw_entriesSearches CAJAS RAW entries with pagination and filters. Supported status values are draft, queued, assembled, and voided. project and department are returned only when stored by CAJAS; missing values are not inferred. created_by_name is a stored actor label and may differ from created_by_display profile identity. This read-only tool does not modify RAW status, create an Assembly, or create an Event.
cajas.search_eventsSearches CAJAS accounting events. This read-only tool does not confirm, void, sign, approve, finalize, or alter events.
cajas.get_eventReturns one CAJAS accounting event and CAJAS-provided judgment support context. This read-only tool does not confirm, void, sign, approve, finalize, or alter the event.
cajas.recommend_assemblyAnalyzes selected RAW entries and returns non-binding Assembly candidates for human review. The recommendation identifies RAW entries that may share an operational context. Community validation is opt-in only and uses public, untrusted operational context when requested. It does not create an Assembly, modify RAW status, create an Event, determine accounting treatment, approve accounting judgment, sign, finalize, or alter immutable CAJAS history.
cajas.inspect_raw_fileSafely inspects a CSV or XLSX file and returns sheet structure, headers, sample rows, warnings, and suggested CAJAS Smart Excel column mappings. This tool does not import or modify CAJAS data.
cajas.preview_raw_importValidates a previously inspected RAW file sheet against CAJAS Smart Excel import and the selected CoA profile. Returns unresolved accounts, conflicts, and a non-mutating preview. This tool does not create RAW entries.
cajas.import_raw_fileImports a previously validated RAW file preview into CAJAS using Smart Excel execute. This tool mutates CAJAS data by creating RAW entries/groups. It does not create Events, approve, sign, or finalize anything.
cajas.inspect_coa_fileInspects a CSV/XLSX Chart of Accounts file and proposes CAJAS CoA column mappings. This tool does not modify any CAJAS CoA profile.
cajas.preview_coa_importCompares a parsed CoA file with a selected CAJAS CoA profile and returns proposed additions, metadata updates, conflicts, blocked changes, and non-applied deactivate candidates. This tool does not modify the CoA.
cajas.import_coaApplies explicitly accepted ADD/UPDATE_METADATA operations from a successful CoA import preview. This tool mutates the selected CAJAS CoA profile. It does not replace the entire CoA or deactivate missing accounts.
cajas.find_criterion_groupSearches existing CAJAS Criterion Groups in standards. This read-only tool does not create or modify standards.
cajas.resolve_standard_referenceSearches supported authoritative-reference locator sources for accounting standard reference candidates. It does not return or store full standard text and does not create CAJAS criterion groups.
cajas.propose_criterion_groupCreates a non-mutating CAJAS Criterion Group proposal from a resolved external reference. The proposed title and description are CAJAS-authored, not official standard headings.
cajas.find_interpretationsSearches existing reusable CAJAS interpretations under a Criterion Group. This read-only tool does not create templates.
cajas.propose_interpretationCreates a non-mutating Interpretation proposal for a selected Criterion Group and judgment context. It does not create standard_templates, event_standard_links, approvals, or confirmations.