Overview
What is Maxio MCP Implementation?
Maxio MCP Implementation is a Docker-based Model Context Protocol (MCP) server that integrates Claude with the Maxio (SaaSOptics) subscription billing platform. It allows developers and billing teams to manage customers, contracts, transactions, invoices, payments, items, and revenue data directly through Claude.
How to use Maxio MCP Implementation?
Install using the one-line install command (curl -s https://raw.githubusercontent.com/banner-dev/maxio-mcp/main/install.sh | bash) or run manually with docker run providing MAXIO_BASE_URL and MAXIO_API_TOKEN environment variables. In Claude, connect to http://localhost:3000/mcp-endpoint using Bearer token authentication with the same API token.
Key features of Maxio MCP Implementation
- Docker-based, one-line or manual installation
- Smithy-based API modeling and code generation
- Access to Customers, Contracts, Transactions, Invoices, Payments, Items, and Revenue resources
- Auto‑start and auto‑shutdown when used with Claude
- Automated health checks and container restart
- Configurable port, log level, and idle timeout
Use cases of Maxio MCP Implementation
- Create and manage customer records in Maxio via Claude
- Generate and retrieve invoices and line items on demand
- Query and analyze revenue entries from subscription data
- Automate transaction and payment recording with natural language commands
- Integrate contract management into an AI‑assisted workflow
FAQ from Maxio MCP Implementation
How do I get an API token for authentication?
Generate a token in the Maxio admin portal under Settings → API Keys, then copy it and set it as the MAXIO_API_TOKEN environment variable.
How can I verify the container is working?
Run docker ps | grep maxio-mcp to check status, docker logs maxio-mcp to view logs, or curl http://localhost:3000/health for a health JSON response.
What if port 3000 is already in use?
Change the port mapping when running the container (e.g., -p 8080:3000) and use http://localhost:8080/mcp-endpoint as the MCP URL in Claude.
What dependencies does the container need?
The standard Docker image uses curl for health checks and has no external dependencies. If you encounter nc: command not found errors, use the fixed version by running the build-fixed.sh script.
Does the container shut down automatically?
Yes, by default AUTO_SHUTDOWN is enabled and the container stops after 30 minutes of inactivity (IDLE_TIMEOUT). It also auto‑starts with Claude and auto‑shuts when Claude closes.
