# quario

> quario is a freemium MCP server for files and documents. Validates JSON report definitions and renders them to PDF, Excel, Word, HTML or CSV. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $199 a month
- **Platforms:** CLI, self-hosted
- **Website:** https://getquario.com
- **Repository:** https://github.com/getquario/mcp
- **MCP Registry name:** com.getquario/mcp
- **Categories:** files and documents
- **Listing updated:** 2026-11-15

## About

The design rule here is that the model never writes a number. An agent drafts a JSON report definition with sections, bindings and expressions, and quario computes every total from your data. Expressions are parsed into safe closures, with no eval or generated code, and markup in a definition is escaped as text, which matters because an agent's output can carry a prompt injection.

Two tools do the work. `validate_report` returns every problem with the path it sits at, such as an unknown sort direction, so the agent can fix that spot before anything renders. `render_report` writes the file to disk and returns the path and size rather than the bytes, so a large report costs one line of context. Names that already exist get -1, -2 and so on instead of being overwritten.

The host stays in charge: query budgets, link schemes, the data root and output directory come from environment variables, not tool arguments. It runs locally over stdio and needs Node 22 or later. The MCP package is Apache-2.0, but the quario engine it installs is commercial. Without a license key every render carries an "unlicensed" mark; a production license is $199 per deployment, billed annually.

## Features

- **Path-level validation:** Each problem names the exact path in the definition so the agent can repair it.
- **Five output formats:** One definition renders to PDF, XLSX, DOCX, HTML or CSV.
- **Totals from your data:** The model declares formulas; quario computes every figure from supplied data.
- **File path results:** Rendered files are written to disk and only the path and size return.
- **Host-set limits:** Data root, output directory, locale, currency and time zone come from configuration.
- **No eval:** Expressions are parsed into safe closures with no generated code.

## Good for

- Have an agent produce an invoice PDF from order data
- Export a workbook where numbers stay numbers
- Generate a Word report from a JSON definition
- Let an assistant fix a malformed report definition from specific error paths

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp --env QUARIO_LICENSE='<QUARIO_LICENSE>' -- npx -y @quario/mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@quario/mcp"
      ],
      "env": {
        "QUARIO_LICENSE": "<QUARIO_LICENSE>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@quario/mcp"
      ],
      "env": {
        "QUARIO_LICENSE": "<QUARIO_LICENSE>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@quario/mcp"
      ],
      "env": {
        "QUARIO_LICENSE": "<QUARIO_LICENSE>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@quario/mcp"
      ],
      "env": {
        "QUARIO_LICENSE": "<QUARIO_LICENSE>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@quario/mcp"
      ],
      "env": {
        "QUARIO_LICENSE": "<QUARIO_LICENSE>"
      }
    }
  }
}
```

## Tools

- `validate_report`: Checks a report definition and returns every problem at its path.
- `render_report`: Renders a definition to pdf, xlsx, docx, html or csv and returns the file path and size.

## FAQ

### Can I try it without a license?

Yes. Evaluation is free and unlimited, but output carries an unlicensed watermark.

### Does the model compute the totals?

No. It writes the formulas and quario computes every figure from your data.

### What does a license cost?

$199 per production deployment per year; dev, staging and CI are free and users, agents and renders are not counted.

### Which Node version is needed?

Node 22 or later.

### Is quario free?

quario has a free plan, with paid plans for more usage or features. Paid plans start at $199 a month.

### How do I add quario to Claude Code?

Run this command in your terminal: claude mcp add mcp --env QUARIO_LICENSE='<QUARIO_LICENSE>' -- npx -y @quario/mcp

### What are the best alternatives to quario?

The closest alternatives to quario are ASTra, CARTESIAN ECU, Invoices, SigPen and ConvertAudioToText.

## Alternatives

- [ASTra](https://ai-powered.com/mcp/astra): ASTra is a freemium MCP server for files and documents.
- [CARTESIAN ECU](https://ai-powered.com/mcp/cartesian-ecu): CARTESIAN ECU is a paid MCP server for files and documents.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.
- [SigPen](https://ai-powered.com/mcp/sigpen): SigPen is a freemium MCP server for files and documents.
- [ConvertAudioToText](https://ai-powered.com/mcp/convertaudiototext): ConvertAudioToText is a freemium MCP server for design and media.
- [WhoScribe](https://ai-powered.com/mcp/whoscribe): WhoScribe is a freemium MCP server for design and media.
- [filex](https://ai-powered.com/mcp/filex): filex is an open-source MCP server for files and documents.
- [DocJacket](https://ai-powered.com/mcp/docjacket): DocJacket is a freemium MCP server for productivity.

---
Source: https://ai-powered.com/mcp/quario
