MCP Server | Rebillia Platform Help Center

Requirements

Node.js 18 or higher — Download Node.js
A Rebillia API key — see below

Step 1 - Get your API Key

Go to admin.rebillia.com
Open Settings in the left sidebar
Go to API / Integrations
Copy your API Token — you'll use this as REBILLIA_API_KEY in the next step

Step 2 — Add Rebillia to your AI client

Choose your AI client below and paste the config into the appropriate file. You do not need to install or clone anything - npx handles it automatically.

Cursor

Open (or create) the file ~/.cursor/mcp.json and add:

{
    "mcpServers": {
        "rebillia": {
            "command": "npx",
            "args": ["-y", "@rebilliaai/mcp-server"],
            "env": {
                "REBILLIA_API_KEY": "your_api_key_here",
                "REBILLIA_API_URL": "https://api.rebillia.com/v1"
            }
        }
    }
}

Then restart Cursor (or go to Settings → Cursor Settings → MCP and click Reload).

Claude Desktop

Open the Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Add the following:

{
    "mcpServers": {
        "rebillia": {
            "command": "npx",
            "args": ["-y", "@rebilliaai/mcp-server"],
            "env": {
                "REBILLIA_API_KEY": "your_api_key_here",
                "REBILLIA_API_URL": "https://api.rebillia.com/v1"
            }
        }
    }
}

Then fully quit and relaunch Claude Desktop.

VS Code (GitHub Copilot)

Create or open .vscode/mcp.json in your project and add:

{
    "servers": {
        "rebillia": {
            "command": "npx",
            "args": ["-y", "@rebilliaai/mcp-server"],
            "env": {
                "REBILLIA_API_KEY": "your_api_key_here",
                "REBILLIA_API_URL": "https://api.rebillia.com/v1"
            }
        }
    }
}

Then reload VS Code.

Step 3 — Try it

Once connected, open a chat in your AI client and try:

"List my active subscriptions"
"Show me unpaid invoices for customer ID 12345"
"Create a new customer named Jane Smith with email [email protected]"
"What gateways do I have configured?"
"Get the API docs overview"

What the MCP server can do

The Rebillia MCP server exposes 108 tools covering your full billing stack:

Category	Tools	What you can do
Customers	22	List, create, update, delete customers; manage addresses, payment methods, charges, and credits
Subscriptions	19	Create, update, and manage subscriptions; add/remove rate plans and charges
Products	8	Create and manage products; link to external platforms
Product Rate Plans	7	Create and configure billing plans per product
Rate Plan Charges	5	Configure pricing tiers, billing periods, and charge models
Invoices	8	Create, charge, void, and manage invoices
Transactions	4	List, refund, and void transactions
Gateways	9	Configure and test payment gateways; generate client tokens
Bill Runs	4	View and reschedule bill runs
Currencies	7	Manage company currencies and defaults
Integrations	8	Manage platform integrations and external products
Shipping	2	List services and calculate shipping costs
Filters	4	Create and manage saved filters
API Docs	1	Ask the AI to retrieve built-in API documentation

npm package

@rebilliaai/mcp-server

View on npm · View on GitHub

Troubleshooting

Q. The server doesn't appear in my AI client

Make sure you fully restarted the application after saving the config file. In Cursor you can also go to Settings → MCP to see connection status and any error messages.

Q. I get an authentication error

Double-check that your REBILLIA_API_KEY is correct and that there are no extra spaces or quotes around it in the config file.

Q. Node.js version error

The MCP server requires Node.js 18 or higher. Run node --version in your terminal to check. Download the latest version at nodejs.org.

Something else?