Skip to content
MCP server

quario

Validates JSON report definitions and renders them to PDF, Excel, Word, HTML or CSV

Runs locallyStatus and history
Install
Pricing
Freemium
Platforms
CLI, self-hosted
Runs
Locally
Version
0.3.0
Listing updated
2 days ago

About quario

quario is a freemium MCP server for files and documents. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Configuration

  • QUARIO_LICENSEThe license key. Leave it unset to evaluate, and the output carries a watermark.
  • QUARIO_DATA_ROOTThe directory a dataPath resolves in. Defaults to CLAUDE_PROJECT_DIR when set.
  • QUARIO_OUT_DIRThe directory rendered files are written to. Defaults to quario-mcp under the system temp dir.
  • QUARIO_LOCALEThe default locale for numbers and dates.
  • QUARIO_CURRENCYThe default currency, as an ISO 4217 code such as EUR.
  • QUARIO_TIME_ZONEThe default time zone for dates.

Tools this server provides (2)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Freemium, from $199 a month

Free evaluation with watermarked output; production license $199 per deployment, billed annually

Prices change. Check getquario.com before you buy.

quario 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 to quario

  1. ASTra

    MCP server

    Let agents read, edit, validate and undo Word .docx files with exact operations

    Runs locally
    • 5 tools
    • Freemium
    • Files and documents
  2. CARTESIAN ECU

    MCP server

    Check and repair ECU and TCU flash-file checksums from Claude (Ultimate plan)

    Not checked yet
    • 5 tools
    • Remote
    • Paid
    • Files and documents
  3. Invoices

    MCP server

    MCP server that reads supplier invoices and returns data plus DATEV, CSV or Excel files

    • 4 tools
    • Remote
    • Paid
    • Files and documents
  4. SigPen

    MCP server

    MCP server that drafts e-signature documents while you approve every send

    Not checked yet
    • 13 tools
    • Remote
    • Freemium
    • Files and documents
  5. Transcribe audio and video links from Claude or ChatGPT and read the results

    Not checked yet
    • 5 tools
    • Remote
    • Freemium
    • Design and media
  6. WhoScribe

    MCP server

    Search and read your WhoScribe audio and video transcripts from ChatGPT, read-only

    Not checked yet
    • Remote
    • Freemium
    • Design and media