quario — Claude Code MCP server: what it does, install
Validates JSON report definitions and renders them as PDF, Excel, Word, HTML, or CSV files. It helps agents turn structured data into reports.
claude mcp add --env QUARIO_LICENSE=<QUARIO_LICENSE> --env QUARIO_DATA_ROOT=<QUARIO_DATA_ROOT> --env QUARIO_OUT_DIR=<QUARIO_OUT_DIR> --env QUARIO_LOCALE=<QUARIO_LOCALE> --env QUARIO_CURRENCY=<QUARIO_CURRENCY> --transport stdio quario -- npx -y @quario/mcpWhat quario does
quario exposes two MCP tools. validate_report checks a report definition, while render_report writes the result to disk. The same JSON definition can target pdf, xlsx, docx, html, or csv. Validation problems include the path of the faulty field, so an agent can revise that part and try again.
The server runs locally over stdio and starts with npx -y @quario/mcp. A render response contains the output path and file size rather than file bytes. Existing filenames are preserved: the server appends -1, then -2, when needed.
Node 22 or later is required. Without QUARIO_LICENSE, the server still starts, but every rendered report carries an unlicensed mark. QUARIO_DATA_ROOT controls where dataPath can read from, while QUARIO_OUT_DIR selects the output directory. Query budgets and allowed link schemes also come from the launch environment, not from tool arguments. Without Node 22, the server will not start.
What it helps with
- validate a report definition before rendering
- turn JSON data into a PDF report
- export one definition to Excel, Word, HTML, or CSV
- locate a faulty field in a report definition
- write rendered files to a selected directory
Example prompts for the agent
- Validate this report definition for the requested output formats and list the fields that need fixing.
- Render these order records as a PDF with product and total columns, then return the file path.
- Create
xlsx,docx, andhtmlfiles from this JSON definition without overwriting existing outputs.
How to install quario
Platform CLI
claude mcp add --env QUARIO_LICENSE=<QUARIO_LICENSE> --env QUARIO_DATA_ROOT=<QUARIO_DATA_ROOT> --env QUARIO_OUT_DIR=<QUARIO_OUT_DIR> --env QUARIO_LOCALE=<QUARIO_LOCALE> --env QUARIO_CURRENCY=<QUARIO_CURRENCY> --transport stdio quario -- npx -y @quario/mcpReplace <…> with your own values. 1 more environment variable is in the server README
Platform CLI
codex mcp add quario --env QUARIO_LICENSE=<QUARIO_LICENSE> --env QUARIO_DATA_ROOT=<QUARIO_DATA_ROOT> --env QUARIO_OUT_DIR=<QUARIO_OUT_DIR> --env QUARIO_LOCALE=<QUARIO_LOCALE> --env QUARIO_CURRENCY=<QUARIO_CURRENCY> -- npx -y @quario/mcpReplace <…> with your own values. 1 more environment variable is in the server README
Config file
{
"mcpServers": {
"quario": {
"command": "npx",
"args": [
"-y",
"@quario/mcp"
],
"env": {
"QUARIO_LICENSE": "<QUARIO_LICENSE>",
"QUARIO_DATA_ROOT": "<QUARIO_DATA_ROOT>",
"QUARIO_OUT_DIR": "<QUARIO_OUT_DIR>",
"QUARIO_LOCALE": "<QUARIO_LOCALE>",
"QUARIO_CURRENCY": "<QUARIO_CURRENCY>"
}
}
}
}Replace <…> with your own values. 1 more environment variable is in the server README
Config file
{
"servers": {
"quario": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@quario/mcp"
],
"env": {
"QUARIO_LICENSE": "<QUARIO_LICENSE>",
"QUARIO_DATA_ROOT": "<QUARIO_DATA_ROOT>",
"QUARIO_OUT_DIR": "<QUARIO_OUT_DIR>",
"QUARIO_LOCALE": "<QUARIO_LOCALE>",
"QUARIO_CURRENCY": "<QUARIO_CURRENCY>"
}
}
}
}Replace <…> with your own values. 1 more environment variable is in the server README
Platform CLI
gemini mcp add -e QUARIO_LICENSE=<QUARIO_LICENSE> -e QUARIO_DATA_ROOT=<QUARIO_DATA_ROOT> -e QUARIO_OUT_DIR=<QUARIO_OUT_DIR> -e QUARIO_LOCALE=<QUARIO_LOCALE> -e QUARIO_CURRENCY=<QUARIO_CURRENCY> quario npx -y @quario/mcpReplace <…> with your own values. 1 more environment variable is in the server README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about quario
How do I install quario in Claude Code?
Run claude mcp add mcp -e QUARIO_LICENSE=<QUARIO_LICENSE> -- npx -y @quario/mcp, then restart Claude Code.
What does quario do?
It validates JSON report definitions and renders them as PDF, Excel, Word, HTML, or CSV files. The agent receives the path to the output instead of the file bytes.
Can quario run without a license key?
Yes. The server starts without QUARIO_LICENSE, but every rendered report includes an unlicensed mark.
