io.github.javalenciacai/mcp-reportia MCP Server

Name: io.github.javalenciacai/mcp-reportia MCP Server
Author: io.github.javalenciacai

io.github.javalenciacai/mcp-reportia

Repository Registry

What is the io.github.javalenciacai/mcp-reportia MCP server?

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

How to install io.github.javalenciacai/mcp-reportia

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

REPORTIA_BASE_URL
required
Base URL of the Reportia API (without trailing slash). Example: https://reportia.example.com
REPORTIA_TOKEN
secret
Bearer token for M2M authentication. Mutually exclusive with REPORTIA_EMAIL+REPORTIA_PASSWORD.
REPORTIA_EMAIL
Email for cookie-session authentication.
REPORTIA_PASSWORD
secret
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).

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mcp-reportia": {
      "command": "npx",
      "args": [
        "-y",
        "@james.valencia/mcp-reportia"
      ],
      "env": {
        "REPORTIA_BASE_URL": "<YOUR_REPORTIA_BASE_URL>",
        "REPORTIA_TOKEN": "<YOUR_REPORTIA_TOKEN>",
        "REPORTIA_EMAIL": "<YOUR_REPORTIA_EMAIL>",
        "REPORTIA_PASSWORD": "<YOUR_REPORTIA_PASSWORD>",
        "REPORTIA_COMPANY_ID": "<YOUR_REPORTIA_COMPANY_ID>",
        "REPORTIA_TIMEOUT_MS": "<YOUR_REPORTIA_TIMEOUT_MS>",
        "REPORTIA_DOWNLOAD_DIR": "<YOUR_REPORTIA_DOWNLOAD_DIR>",
        "REPORTIA_USER_AGENT": "<YOUR_REPORTIA_USER_AGENT>",
        "REPORTIA_MAX_DOWNLOAD_BYTES": "<YOUR_REPORTIA_MAX_DOWNLOAD_BYTES>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-reportia": {
      "command": "npx",
      "args": [
        "-y",
        "@james.valencia/mcp-reportia"
      ],
      "env": {
        "REPORTIA_BASE_URL": "<YOUR_REPORTIA_BASE_URL>",
        "REPORTIA_TOKEN": "<YOUR_REPORTIA_TOKEN>",
        "REPORTIA_EMAIL": "<YOUR_REPORTIA_EMAIL>",
        "REPORTIA_PASSWORD": "<YOUR_REPORTIA_PASSWORD>",
        "REPORTIA_COMPANY_ID": "<YOUR_REPORTIA_COMPANY_ID>",
        "REPORTIA_TIMEOUT_MS": "<YOUR_REPORTIA_TIMEOUT_MS>",
        "REPORTIA_DOWNLOAD_DIR": "<YOUR_REPORTIA_DOWNLOAD_DIR>",
        "REPORTIA_USER_AGENT": "<YOUR_REPORTIA_USER_AGENT>",
        "REPORTIA_MAX_DOWNLOAD_BYTES": "<YOUR_REPORTIA_MAX_DOWNLOAD_BYTES>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-reportia": {
      "command": "npx",
      "args": [
        "-y",
        "@james.valencia/mcp-reportia"
      ],
      "env": {
        "REPORTIA_BASE_URL": "<YOUR_REPORTIA_BASE_URL>",
        "REPORTIA_TOKEN": "<YOUR_REPORTIA_TOKEN>",
        "REPORTIA_EMAIL": "<YOUR_REPORTIA_EMAIL>",
        "REPORTIA_PASSWORD": "<YOUR_REPORTIA_PASSWORD>",
        "REPORTIA_COMPANY_ID": "<YOUR_REPORTIA_COMPANY_ID>",
        "REPORTIA_TIMEOUT_MS": "<YOUR_REPORTIA_TIMEOUT_MS>",
        "REPORTIA_DOWNLOAD_DIR": "<YOUR_REPORTIA_DOWNLOAD_DIR>",
        "REPORTIA_USER_AGENT": "<YOUR_REPORTIA_USER_AGENT>",
        "REPORTIA_MAX_DOWNLOAD_BYTES": "<YOUR_REPORTIA_MAX_DOWNLOAD_BYTES>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "mcp-reportia": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@james.valencia/mcp-reportia"
      ],
      "env": {
        "REPORTIA_BASE_URL": "<YOUR_REPORTIA_BASE_URL>",
        "REPORTIA_TOKEN": "<YOUR_REPORTIA_TOKEN>",
        "REPORTIA_EMAIL": "<YOUR_REPORTIA_EMAIL>",
        "REPORTIA_PASSWORD": "<YOUR_REPORTIA_PASSWORD>",
        "REPORTIA_COMPANY_ID": "<YOUR_REPORTIA_COMPANY_ID>",
        "REPORTIA_TIMEOUT_MS": "<YOUR_REPORTIA_TIMEOUT_MS>",
        "REPORTIA_DOWNLOAD_DIR": "<YOUR_REPORTIA_DOWNLOAD_DIR>",
        "REPORTIA_USER_AGENT": "<YOUR_REPORTIA_USER_AGENT>",
        "REPORTIA_MAX_DOWNLOAD_BYTES": "<YOUR_REPORTIA_MAX_DOWNLOAD_BYTES>"
      }
    }
  }
}

Claude Code

claude mcp add mcp-reportia --env REPORTIA_BASE_URL=<YOUR_REPORTIA_BASE_URL> --env REPORTIA_TOKEN=<YOUR_REPORTIA_TOKEN> --env REPORTIA_EMAIL=<YOUR_REPORTIA_EMAIL> --env REPORTIA_PASSWORD=<YOUR_REPORTIA_PASSWORD> --env REPORTIA_COMPANY_ID=<YOUR_REPORTIA_COMPANY_ID> --env REPORTIA_TIMEOUT_MS=<YOUR_REPORTIA_TIMEOUT_MS> --env REPORTIA_DOWNLOAD_DIR=<YOUR_REPORTIA_DOWNLOAD_DIR> --env REPORTIA_USER_AGENT=<YOUR_REPORTIA_USER_AGENT> --env REPORTIA_MAX_DOWNLOAD_BYTES=<YOUR_REPORTIA_MAX_DOWNLOAD_BYTES> -- npx -y @james.valencia/mcp-reportia

Related MCP servers

io.github.javalenciacai/siigo-pyme-mcp

Active

SIIGO Pyme as MCP tools: the 47 ExcelSIIGO functions, plus company discovery.

TypeScript

MIT

View repository →