Skip to content
MCP server

Maxio MCP

Open, local revenue-intelligence CLI for Maxio Advanced Billing - MRR waterfalls

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

About Maxio MCP

Maxio MCP 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 maxio-mcp --env MAXIO_API_KEY='<MAXIO_API_KEY>' --env MAXIO_PASSWORD='<MAXIO_PASSWORD>' --env MAXIO_SITE='<MAXIO_SITE>' --env MAXIO_USERNAME='<MAXIO_USERNAME>' --env MAXIO_MCP_HTTP_TOKEN='<MAXIO_MCP_HTTP_TOKEN>' --env PRINTING_PRESS_CLIENT_PROFILE='<PRINTING_PRESS_CLIENT_PROFILE>' -- npx -y https://github.com/Servosity/msp-skills/releases/download/maxio-v0.1.13/maxio-mcp.mcpb

Add to claude_desktop_config.json

{
  "mcpServers": {
    "maxio-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/maxio-v0.1.13/maxio-mcp.mcpb"
      ],
      "env": {
        "MAXIO_API_KEY": "<MAXIO_API_KEY>",
        "MAXIO_PASSWORD": "<MAXIO_PASSWORD>",
        "MAXIO_SITE": "<MAXIO_SITE>",
        "MAXIO_USERNAME": "<MAXIO_USERNAME>",
        "MAXIO_MCP_HTTP_TOKEN": "<MAXIO_MCP_HTTP_TOKEN>",
        "PRINTING_PRESS_CLIENT_PROFILE": "<PRINTING_PRESS_CLIENT_PROFILE>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "maxio-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/maxio-v0.1.13/maxio-mcp.mcpb"
      ],
      "env": {
        "MAXIO_API_KEY": "<MAXIO_API_KEY>",
        "MAXIO_PASSWORD": "<MAXIO_PASSWORD>",
        "MAXIO_SITE": "<MAXIO_SITE>",
        "MAXIO_USERNAME": "<MAXIO_USERNAME>",
        "MAXIO_MCP_HTTP_TOKEN": "<MAXIO_MCP_HTTP_TOKEN>",
        "PRINTING_PRESS_CLIENT_PROFILE": "<PRINTING_PRESS_CLIENT_PROFILE>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "maxio-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/maxio-v0.1.13/maxio-mcp.mcpb"
      ],
      "env": {
        "MAXIO_API_KEY": "<MAXIO_API_KEY>",
        "MAXIO_PASSWORD": "<MAXIO_PASSWORD>",
        "MAXIO_SITE": "<MAXIO_SITE>",
        "MAXIO_USERNAME": "<MAXIO_USERNAME>",
        "MAXIO_MCP_HTTP_TOKEN": "<MAXIO_MCP_HTTP_TOKEN>",
        "PRINTING_PRESS_CLIENT_PROFILE": "<PRINTING_PRESS_CLIENT_PROFILE>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "maxio-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/maxio-v0.1.13/maxio-mcp.mcpb"
      ],
      "env": {
        "MAXIO_API_KEY": "<MAXIO_API_KEY>",
        "MAXIO_PASSWORD": "<MAXIO_PASSWORD>",
        "MAXIO_SITE": "<MAXIO_SITE>",
        "MAXIO_USERNAME": "<MAXIO_USERNAME>",
        "MAXIO_MCP_HTTP_TOKEN": "<MAXIO_MCP_HTTP_TOKEN>",
        "PRINTING_PRESS_CLIENT_PROFILE": "<PRINTING_PRESS_CLIENT_PROFILE>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "maxio-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/maxio-v0.1.13/maxio-mcp.mcpb"
      ],
      "env": {
        "MAXIO_API_KEY": "<MAXIO_API_KEY>",
        "MAXIO_PASSWORD": "<MAXIO_PASSWORD>",
        "MAXIO_SITE": "<MAXIO_SITE>",
        "MAXIO_USERNAME": "<MAXIO_USERNAME>",
        "MAXIO_MCP_HTTP_TOKEN": "<MAXIO_MCP_HTTP_TOKEN>",
        "PRINTING_PRESS_CLIENT_PROFILE": "<PRINTING_PRESS_CLIENT_PROFILE>"
      }
    }
  }
}

Configuration

  • MAXIO_API_KEYSingle-secret Maxio credential, sent as the HTTP Basic username with the constant 'x' as the password. Use this or the MAXIO_USERNAME + MAXIO_PASSWORD pair.Required
  • MAXIO_BASE_URLFull API base URL. Leave blank: the CLI builds it from MAXIO_SITE. Set it only to point at a different host.
  • MAXIO_PASSWORDSet the MAXIO_PASSWORD credential for the Maxio MCP server.
  • MAXIO_SITESet the MAXIO_SITE credential for the Maxio MCP server.Required
  • MAXIO_USERNAMESet the MAXIO_USERNAME credential for the Maxio MCP server.
  • MAXIO_MCP_READ_ONLYOptional. Set to exactly 1 to expose only read-only tools and refuse any non-GET execute call. Leave blank to expose every tool; a call that changes Maxio still needs confirm set to true.
  • MAXIO_NO_LOCAL_DATAOptional. Set to 1 to keep no local copy of API responses: reads go to the API, nothing is written to the local store, and sync and the revenue commands that read it refuse to run. Leave blank to keep the local store.
  • MAXIO_MCP_HTTP_TOKENRequired only when running the MCP server with --transport http. Callers must send a matching Authorization: Bearer header. Not needed for the default stdio transport.
  • MAXIO_USER_AGENTOverrides the User-Agent the CLI sends on Maxio requests. Leave blank to use the CLI's own built-in User-Agent.
  • PRINTING_PRESS_CLIENT_PROFILEOnly for tenant-gated multi-client deployments: binds the MCP server to an existing Printing Press client profile. Leave blank for a single-tenant install.

Pricing

Open source

Maxio MCP FAQ

Is Maxio MCP free?

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

How do I add Maxio MCP to Claude Code?

Run this command in your terminal: claude mcp add maxio-mcp --env MAXIO_API_KEY='<MAXIO_API_KEY>' --env MAXIO_PASSWORD='<MAXIO_PASSWORD>' --env MAXIO_SITE='<MAXIO_SITE>' --env MAXIO_USERNAME='<MAXIO_USERNAME>' --env MAXIO_MCP_HTTP_TOKEN='<MAXIO_MCP_HTTP_TOKEN>' --env PRINTING_PRESS_CLIENT_PROFILE='<PRINTING_PRESS_CLIENT_PROFILE>' -- npx -y https://github.com/Servosity/msp-skills/releases/download/maxio-v0.1.13/maxio-mcp.mcpb