Skip to content
MCP server

MCP Reportia

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

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.3.2
Listing updated
4 days ago

About MCP Reportia

MCP Reportia is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Install

Run in a terminal

claude mcp add mcp-reportia --env REPORTIA_BASE_URL='<REPORTIA_BASE_URL>' --env REPORTIA_TOKEN='<REPORTIA_TOKEN>' --env REPORTIA_COOKIE='<REPORTIA_COOKIE>' --env REPORTIA_PASSWORD='<REPORTIA_PASSWORD>' -- npx -y @james.valencia/mcp-reportia

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp-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

{
  "mcpServers": {
    "mcp-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 .vscode/mcp.json

{
  "servers": {
    "mcp-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 ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-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 your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mcp-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>"
      }
    }
  }
}

Configuration

  • REPORTIA_BASE_URLBase URL of the Reportia API (without trailing slash). Example: https://reportia.example.comRequired
  • REPORTIA_TOKENBearer token for M2M authentication. Mutually exclusive with REPORTIA_COOKIE; either can be paired with REPORTIA_EMAIL+REPORTIA_PASSWORD (session login) for cookie fallback.
  • REPORTIA_COOKIEPre-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_EMAILEmail for cookie-session authentication.
  • REPORTIA_PASSWORDPassword for cookie-session authentication.
  • REPORTIA_COMPANY_IDDefault companyId used when a tool accepts it as optional.
  • REPORTIA_TIMEOUT_MSHTTP request timeout in milliseconds (default 30000).
  • REPORTIA_DOWNLOAD_DIRDirectory where downloaded Excel/PDF exports are saved (default ./downloads).
  • REPORTIA_USER_AGENTCustom User-Agent header (default mcp-reportia/0.1.0).
  • REPORTIA_MAX_DOWNLOAD_BYTESMaximum bytes for a single binary download (default 104857600 = 100MB).

Pricing

Open source

MCP Reportia FAQ

Is MCP Reportia free?

Yes. MCP Reportia is open source, so you can use and self-host it for free.

How do I add MCP Reportia to Claude Code?

Run this command in your terminal: claude mcp add mcp-reportia --env REPORTIA_BASE_URL='<REPORTIA_BASE_URL>' --env REPORTIA_TOKEN='<REPORTIA_TOKEN>' --env REPORTIA_COOKIE='<REPORTIA_COOKIE>' --env REPORTIA_PASSWORD='<REPORTIA_PASSWORD>' -- npx -y @james.valencia/mcp-reportia