Server data from the Official MCP Registry
Generate PDF reports from ReportFlow templates via Claude and other AI agents.
Generate PDF reports from ReportFlow templates via Claude and other AI agents.
reportflow-mcp is a well-structured MCP server for PDF generation with proper OAuth2 PKCE authentication, secure token storage via OS keychains, and appropriate permission scoping. The codebase demonstrates good security practices including proper input validation, error handling, and no hardcoded secrets. Minor code quality observations exist but do not materially impact security. Supply chain analysis found 4 known vulnerabilities in dependencies (0 critical, 3 high severity). Package verification found 1 issue.
7 files analyzed · 9 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
This plugin requests these system permissions. Most are normal for its category.
Set these up before or after installing:
Environment variable: REPORTFLOW_CLIENT_ID
Environment variable: REPORTFLOW_AUTH_URL
Environment variable: REPORTFLOW_API_BASE_URL
Environment variable: REPORTFLOW_TOKEN_STORE
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-re-port-flow-reportflow-mcp": {
"env": {
"REPORTFLOW_AUTH_URL": "your-reportflow-auth-url-here",
"REPORTFLOW_CLIENT_ID": "your-reportflow-client-id-here",
"REPORTFLOW_TOKEN_STORE": "your-reportflow-token-store-here",
"REPORTFLOW_API_BASE_URL": "your-reportflow-api-base-url-here"
},
"args": [
"-y",
"reportflow-mcp"
],
"command": "npx"
}
}
}From the project's GitHub README.
An MCP (Model Context Protocol) server that turns your ReportFlow templates into PDF reports — invoices, contracts, statements, anything you've designed — straight from Claude or any other MCP-compatible AI agent.
Add the following to your config file (.mcp.json, claude_desktop_config.json, ~/.cursor/mcp.json, etc.):
{
"mcpServers": {
"reportflow": {
"command": "npx",
"args": ["-y", "reportflow-mcp"]
}
}
}
That's the whole setup. No env vars, no API keys, no secrets to manage.
Same JSON in .vscode/mcp.json.
npx)After reloading the MCP client, ask the AI:
Authenticate with ReportFlow
A browser window opens. Sign in → pick a workspace → consent, and you're done. Tokens are stored in your OS keychain (macOS Keychain / Windows Credential Manager / Linux libsecret) and refreshed automatically.
Using the invoice template, create a PDF for Acme Corp totalling $330.
The AI will look up the template via list_templates, fetch its parameter schema with get_design_parameters, fill in the values, and call generate_pdf_sync — returning a local file path.
| Command | Purpose |
|---|---|
/generate_pdf | Step-by-step recipe for a single PDF |
/generate_pdfs | Recipe for batch PDF generation |
/reportflow_help | Quick feature tour |
Output location is resolved in this order:
| Tool | Purpose |
|---|---|
authenticate | First-time / re-authentication |
list_templates | List available designs |
get_design_parameters | Fetch the parameter schema for a design |
generate_pdf_sync / _async | Generate one PDF (sync returns path; async returns request ID) |
generate_pdfs_sync / _async | Generate many PDFs (returns a ZIP) |
download_file / download_zip | Download artifacts produced by async tools |
suggest_params | Translate a natural-language brief into a params JSON via MCP Sampling (requires a Sampling-capable client) |
| URI | Contents |
|---|---|
reportflow://designs | List of available designs |
reportflow://designs/{designId}/parameters | Parameter schema for one design |
reportflow://errors | Catalog of error messages from the Content Service |
reportflow://server-info | Server feature overview |
/generate_pdf, /generate_pdfs, /reportflow_help — pass arguments and the AI follows the prepared workflow.
| Symptom | Fix |
|---|---|
Error containing re-authentication required | Ask the AI: "re-authenticate with ReportFlow" |
npx cannot find the package | npm cache clean --force then retry |
| No keychain available on Linux | Falls back automatically to a chmod-0600 file under $XDG_STATE_HOME/reportflow-mcp/ |
| Browser cannot open over SSH / remote shell | Authenticate once on a local machine; afterwards the cached token works on remote hosts |
MIT — see LICENSE.
Be the first to review this server!
by Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
by Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
by mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.