# reportflow-mcp

reportflow-mcp builds PDF documents from Re:port Flow templates directly inside agent chats. Helpful when you want invoices or agreements generated on demand.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 869 installs · ★ 1 repo stars
- Author: re-port-flow
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/re-port-flow/reportflow-mcp
- Updated: 2026-10-23
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/reportflow-mcp

## What it does

This server connects your AI assistant to Re:port Flow designs. The model retrieves template lists with `list_templates`, checks input schemas via `get_design_parameters`, and compiles PDF files. It handles individual documents as well as multi-file batches downloaded together inside a ZIP archive.

A Re:port Flow account is required. Keep in mind that `generate_pdf_sync` cuts off with a 504 error after 60 seconds, which makes `generate_pdfs_async` mandatory for larger documents. Running the server locally via `npx` needs Node.js 22.23.4 or newer alongside a web browser for OAuth authorization.

## Requirements
- Remote server: `https://reportflow-mcp--re-port-flow.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http reportflow-mcp https://reportflow-mcp--re-port-flow.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add reportflow-mcp --url https://reportflow-mcp--re-port-flow.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "reportflow-mcp": {
            "url": "https://reportflow-mcp--re-port-flow.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "reportflow-mcp": {
            "type": "http",
            "url": "https://reportflow-mcp--re-port-flow.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http reportflow-mcp https://reportflow-mcp--re-port-flow.run.tools
```

## When to use it
- render PDF invoices and contracts from natural instructions
- export multi-document batches into a single ZIP file
- feed template parameter schemas into the model context
- write generated files straight into the current workspace

## Example prompts
- Generate an invoice for Acme Corp totaling $500 using the invoice template
- Create statement PDFs for our active client list and bundle them into a ZIP
- Inspect parameter requirements for the standard contract template

## Similar
- [k2f-invoice](https://affpapa.org/en/nevibecode/skills/k2f-invoice.md) — skill · 698 installs
- [FavCRM — Agentic CRM](https://affpapa.org/en/nevibecode/mcp/favcrm-agentic-crm.md) — MCP server · 8514 installs
- [mistral-mcp](https://affpapa.org/en/nevibecode/mcp/mistral-mcp.md) — MCP server · ★ 15 repo stars
- [vc-industry-research](https://affpapa.org/en/nevibecode/skills/vc-industry-research.md) — skill · ★ 4719 repo stars
- [pdf-report-generator](https://affpapa.org/en/nevibecode/skills/pdf-report-generator.md) — skill · 132 installs
- [Aiwyn Tax](https://affpapa.org/en/nevibecode/mcp/aiwyn-tax.md) — MCP server · 6395 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
