Rebillia MCP Server

Model Context Protocol (MCP) server for the Rebillia Public API. It exposes tools to call the API and resources with API documentation so AI assistants can manage customers, products, rate plans, and understand the API.

Features

• Tools – Call Rebillia endpoints from your MCP client (e.g. Cursor, Claude Desktop):
  • Customers (22 tools) – List, get, create, update, delete; invoices (including unpaid), subscriptions, logs; addresses and payment methods; charges/credits
  • Products (8 tools) – List, get, create, update, delete; update status; link/unlink external products
  • Product rate plans (7 tools) – List by product, get, create, update, delete; update status; sync
  • Product rate plan charges (5 tools) – List by product rate plan, get, create, update, delete (with chargeType, chargeModel, billingPeriod, billingTiming enums and chargeTier array)
  • Subscriptions (19 tools) – List, get, create, update, delete; status; next bill, upcoming charges, invoices, logs, external invoices; subscription rate plans and rate plan charges (add/update/remove)
  • Invoices (8 tools) – List, get, create, update, delete; charge (card/online with paymentType), charge_external (offline), void
• Transactions (4 tools) – List (customerId, invoiceId, status, type, dateFrom/dateTo, companyGatewayId, orderBy/sortBy, pagination), get, refund (amount in cents), void (before settlement only)
  • Bill runs (4 tools) – List (filter by completed/pending/error), get, update (newDateTime, ISO 8601; pending only), get bill run invoices
• Gateways (9 tools) – List global gateways (discover gblGatewayId and required setting keys), list company gateways, get, create, update, delete, test gateway, get client token, create setup intent
• Currencies (7 tools) – List, get, create, update, delete, get/set default currency
• Integrations (8 tools) – List, get config, get/list by key; external invoices, products, order statuses
• Shipping (2 tools) – List shipping services, calculate shipping
• Filters (4 tools) – List filters (section required), create filter, list filter fields, remove filter
• Documentation (1 tool) – get_api_docs returns overview or other API docs as markdown (no external fetch)
• Resources – API docs via MCP resources (rebillia://docs/*): overview, models, subscription-statuses, charge-types, gateways. Country list at rebillia://globals/countries (id, code, name) for address tools. Global gateways at rebillia://globals/gateways (gblGatewayId, requiredFields) for gateway creation. All docs are self-contained; use these or the tool instead of fetching external URLs.
• Types – TypeScript types aligned with the Rebillia Public API response shapes

Requirements

• Node.js 18+
• A Rebillia API key (see below)

Getting Your API Key

1. Go to Rebillia setup / welcome.
2. Select a plan and continue.
3. Sign up (create an account) or log in if you already have a Rebillia account.
4. After you’re in your company, open the dashboard.
5. In the dashboard, copy your API Token and use it as REBILLIA_API_KEY in your environment or MCP client config.

Setup

1. Clone and install

   cd /path/to/rebillia-mcp-server
   npm install
   

2. Configure environment

   Copy the example env file and set your API key and optional base URL:

   cp .env.example .env
   

   Edit .env:

   REBILLIA_API_KEY=your_api_key_here
   REBILLIA_API_URL=https://api.rebillia.com/v1
   

   • REBILLIA_API_KEY – Required. Used as X-AUTH-TOKEN for all requests.
   • REBILLIA_API_URL – Optional. Defaults to https://api.rebillia.com/v1 (include /v1 for the Public API).

3. Build

   npm run build
   

Usage

Running the server

Development (no build step):

npm run dev

Production:

npm run build
npm start

Or run the binary:

./node_modules/.bin/rebillia-mcp-server

The server uses stdio transport: it reads JSON-RPC from stdin and writes responses to stdout. MCP clients connect to it as a subprocess.

Configuring Claude Desktop

1. Build the server (if you haven’t already):

   npm run build
   

2. Open the Claude Desktop MCP config file:

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

3. Add the Rebillia server under mcpServers:

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

4. Restart Claude Desktop. The Rebillia tools and resources (including get_api_docs) will appear. You can ask Claude to use the Rebillia API or to “get the API docs” for overview information.

Configuring Cursor

1. Build the server:

   npm run build
   

2. Open Cursor MCP settings:

   • Settings → Cursor Settings → MCP, or
   • Open the MCP config file directly:
     • macOS/Linux: ~/.cursor/rebillia-mcp-server.json or project-level .cursor/mcp.json

• Windows: %USERPROFILE%\.cursor\rebillia-mcp-server.json

3. Add the Rebillia server in the MCP config. Example:

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

4. Restart Cursor or reload the MCP servers. Rebillia tools and resources will be available in the AI chat (e.g. “List customers”, “Get API docs”).

Tools

Responses are JSON from the Rebillia Public API (paginated for list endpoints, single object for get).

Customers (22 tools)

Products (8 tools)

Product rate plans (7 tools)

Product rate plan charges (5 tools)

Subscriptions (19 tools)

Invoices (8 tools)

Transactions (4 tools)

Bill runs (4 tools)

Gateways (9 tools)

Gateway creation example flow: (1) Call list_global_gateways (no args). (2) Pick a gateway (e.g. Stripe, Braintree) and note its gblGatewayId and requiredFields. (3) Build a setting object with those keys and your credential values. (4) Call create_gateway with that gblGatewayId and setting. See rebillia://docs/gateways or get_api_docs with doc: "gateways" for full details.

Currencies (7 tools)

Integrations (8 tools)

Shipping (2 tools)

Filters (4 tools)

Documentation (1 tool)

Resources

API documentation is exposed as MCP resources under rebillia://docs/*. Use resources/list then resources/read with the URI, or call the get_api_docs tool. All docs are self-contained; do not fetch external URLs.

Project structure

src/
├── index.ts              # MCP server entry, tools + resources handlers
├── client.ts             # HTTP client for Rebillia API (X-AUTH-TOKEN)
├── types.ts              # Rebillia API types (customers, invoices, etc.)
├── services/             # API call layer (used by tools)
│   ├── customerServices.ts
│   ├── productServices.ts
│   ├── productRatePlanServices.ts
│   ├── productRatePlanChargeServices.ts
│   ├── subscriptionServices.ts
│   ├── invoiceServices.ts
│   ├── transactionServices.ts
│   ├── billRunServices.ts
│   ├── gatewayServices.ts
│   ├── globalGatewayService.ts
│   ├── countryResolverService.ts
│   ├── currencyServices.ts
│   ├── integrationServices.ts
│   ├── shippingServices.ts
│   └── filterServices.ts
├── tools/
│   ├── index.ts          # Tool registry, getToolDefinitions(), executeTool()
│   ├── types.ts          # Tool definition and handler types
│   ├── customers/        # Customer tools (22)
│   ├── products/         # Product tools (8)
│   ├── product_rate_plans/         # Product rate plan tools (7)
│   ├── product_rate_plan_charges/  # Product rate plan charge tools (5)
│   ├── subscriptions/    # Subscription tools (19)
│   ├── invoices/         # Invoice tools (8)
│   ├── transactions/     # Transaction tools (4)
│   ├── bill_runs/        # Bill run tools (4)
│   ├── gateways/         # Gateway tools (9)
│   ├── currencies/       # Currency tools (7)
│   ├── integrations/     # Integration tools (8)
│   ├── shipping/         # Shipping tools (2)
│   ├── filters/          # Filter tools (4)
│   └── docs/             # get_api_docs (1)
├── resources/
│   ├── index.ts          # listResources(), readResource()
│   └── api-docs.ts       # registerResources(), doc resources, getDocContent()
├── prompts/              # (reserved for MCP prompts)
└── types/
    └── addressInput.ts

Scripts

License

MIT