Reportia MCP Server

by javalenciacaiio.github.javalenciacai/mcp-reportiav0.3.2

Reportia HTTP API as 66 curated MCP tools (accounting, mappings, SIIGO).

0Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active28d ago

Install Reportia MCP server

claude mcp add reportia -e REPORTIA_BASE_URL='<reportia-base-url>' -e REPORTIA_TOKEN='<reportia-token>' -e REPORTIA_COOKIE='<reportia-cookie>' -e REPORTIA_PASSWORD='<reportia-password>' -- npx -y @james.valencia/mcp-reportia

{
  "mcpServers": {
    "reportia": {
      "command": "npx",
      "args": [
        "-y",
        "@james.valencia/mcp-reportia"
      ],
      "env": {
        "REPORTIA_BASE_URL": "<reportia-base-url>",
        "REPORTIA_TOKEN": "<reportia-token>",
        "REPORTIA_COOKIE": "<reportia-cookie>",
        "REPORTIA_PASSWORD": "<reportia-password>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "reportia": {
      "command": "npx",
      "args": [
        "-y",
        "@james.valencia/mcp-reportia"
      ],
      "env": {
        "REPORTIA_BASE_URL": "<reportia-base-url>",
        "REPORTIA_TOKEN": "<reportia-token>",
        "REPORTIA_COOKIE": "<reportia-cookie>",
        "REPORTIA_PASSWORD": "<reportia-password>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "reportia": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@james.valencia/mcp-reportia"
      ],
      "env": {
        "REPORTIA_BASE_URL": "<reportia-base-url>",
        "REPORTIA_TOKEN": "<reportia-token>",
        "REPORTIA_COOKIE": "<reportia-cookie>",
        "REPORTIA_PASSWORD": "<reportia-password>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "reportia": {
      "command": "npx",
      "args": [
        "-y",
        "@james.valencia/mcp-reportia"
      ],
      "env": {
        "REPORTIA_BASE_URL": "<reportia-base-url>",
        "REPORTIA_TOKEN": "<reportia-token>",
        "REPORTIA_COOKIE": "<reportia-cookie>",
        "REPORTIA_PASSWORD": "<reportia-password>"
      }
    }
  }
}

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

Configuration

Variable	Required	Secret	Description
REPORTIA_BASE_URL	yes	—	Base URL of the Reportia API (without trailing slash). Example: https://reportia.example.com
REPORTIA_TOKEN	—	yes	Bearer token for M2M authentication. Mutually exclusive with REPORTIA_COOKIE; either can be paired with REPORTIA_EMAIL+REPORTIA_PASSWORD (session login) for cookie fallback.
REPORTIA_COOKIE	—	yes	Pre-issued Reportia session cookie (e.g. connect.sid=s%3A...). For upstream callers that already hold the resolved user's session and want the child to authenticate as that user without re-login. Mutually exclusive with REPORTIA_TOKEN. Skips /api/auth/login and /api/auth/logout.
REPORTIA_EMAIL	—	—	Email for cookie-session authentication.
REPORTIA_PASSWORD	—	yes	Password for cookie-session authentication.
REPORTIA_COMPANY_ID	—	—	Default companyId used when a tool accepts it as optional.
REPORTIA_TIMEOUT_MS	—	—	HTTP request timeout in milliseconds (default 30000).
REPORTIA_DOWNLOAD_DIR	—	—	Directory where downloaded Excel/PDF exports are saved (default ./downloads).
REPORTIA_USER_AGENT	—	—	Custom User-Agent header (default mcp-reportia/0.1.0).
REPORTIA_MAX_DOWNLOAD_BYTES	—	—	Maximum bytes for a single binary download (default 104857600 = 100MB).

Freshness

Active — last maintenance signal 28d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-09-12 · 28d ago · GitHub
Latest release
2026-09-12 · 28d ago · GitHub · v0.3.7
Package published
no data · npm/PyPI
Registry entry updated
2026-09-11 · 29d ago · official registry · v0.3.2

FAQ

›How do I install the Reportia MCP server in Claude Code?

Run: claude mcp add reportia -e REPORTIA_BASE_URL='<reportia-base-url>' -e REPORTIA_TOKEN='<reportia-token>' -e REPORTIA_COOKIE='<reportia-cookie>' -e REPORTIA_PASSWORD='<reportia-password>' -- npx -y @james.valencia/mcp-reportia. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Reportia require an API key?

Yes. It expects REPORTIA_BASE_URL, REPORTIA_TOKEN, REPORTIA_COOKIE, REPORTIA_PASSWORD, of which 3 are secrets.

›Can I use Reportia as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Reportia in the official MCP registry?

Yes, as io.github.javalenciacai/mcp-reportia.