@rhinosaas/rebillia-mcp-server 1.0.6

package/CHANGELOG.md

@@ -0,0 +1,16 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.0.0] - 2025-02-18
+
+### Added
+
+- MCP server for the Rebillia subscription billing API
+- Tools: customers, products, rate plans, rate plan charges, subscriptions, invoices, transactions, bill runs, gateways, currencies, integrations, shipping, filters, documentation
+- Resources: API docs (overview, models, subscription-statuses, charge-types)
+- `get_api_docs` tool for documentation without external fetch
+- Vitest tests: client, customer tools, subscription tools, integration (MCP protocol)

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) Rebillia
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,415 @@
+# Rebillia MCP Server
+
+Model Context Protocol (MCP) server for the [Rebillia Public API](https://apiguide.rebillia.com/). 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** (21 tools) – List, get, create, update, delete; invoices, 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** (20 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, get, refund (amount in **cents**), void (before settlement only)
+  - **Bill runs** (4 tools) – List (filter by completed/pending/error), get, update (newDateTime, ISO 8601), 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](https://admin.rebillia.com/setup/welcome?source=dev).
+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**
+
+   ```bash
+   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:
+
+   ```bash
+   cp .env.example .env
+   ```
+
+   Edit `.env`:
+
+   ```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**
+
+   ```bash
+   npm run build
+   ```
+
+## Usage
+
+### Running the server
+
+Development (no build step):
+
+```bash
+npm run dev
+```
+
+Production:
+
+```bash
+npm run build
+npm start
+```
+
+Or run the binary:
+
+```bash
+./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):
+   ```bash
+   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`:
+
+   ```json
+   {
+     "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:**
+   ```bash
+   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:
+
+   ```json
+   {
+     "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 (21 tools)
+
+| Tool | Description |
+|------|-------------|
+| `list_customers` | List customers (pageNo, itemPerPage, query, status, sortBy, orderBy, include, filterId). |
+| `get_customer` | Get customer by ID (optional include). |
+| `create_customer` | Create customer (firstName, lastName, email, optional fields). |
+| `update_customer` | Update customer by ID. |
+| `delete_customer` | Delete customer by ID. |
+| `get_customer_invoices` | Get invoices for a customer. |
+| `get_customer_subscriptions` | Get subscriptions for a customer. |
+| `get_customer_logs` | Get logs for a customer. |
+| `list_customer_addresses` | List address book entries for a customer. |
+| `get_customer_address` | Get address by ID. |
+| `create_customer_address` | Create address (name, contactName, street1, city, state, zip, countryCode (ISO 3166-1 alpha-2), type, …). |
+| `update_customer_address` | Update address by ID. Required: customerId, addressId, street1, city, state, zip, countryCode. Optional: name, contactName, street2, company, contactEmail, contactPhone, type. |
+| `delete_customer_address` | Delete address by ID. |
+| `list_customer_payment_methods` | List payment methods for a customer. |
+| `get_customer_payment_method` | Get payment method by ID. |
+| `create_customer_payment_method` | Create payment method (gateway-agnostic). Required: companyGatewayId, type, **paymentMethodNonce**, billingAddress (countryCode, …). Get client credential via get_client_token; use your payment UI to produce paymentMethodNonce. No raw card data or gateway-specific fields. |
+| `update_customer_payment_method` | Update payment method billing address (gateway-agnostic). Required: customerId, paymentMethodId, billingAddress (countryCode, …). No payment or gateway-specific fields. |
+| `delete_customer_payment_method` | Delete payment method by ID. |
+| `list_customer_charges_credits` | List charges/credits (optional status, type). |
+| `create_customer_charge_credit` | Create charge/credit (amount in **cents**, description, type, companyCurrencyId, category, …). |
+| `delete_customer_charge_credit` | Delete charge/credit by ID. |
+
+#### Products (8 tools)
+
+| Tool | Description |
+|------|-------------|
+| `list_products` | List products (include, orderBy, sortBy, itemPerPage, pageNo). |
+| `get_product` | Get product by ID. |
+| `create_product` | Create product (name, category, optional description, sku). |
+| `update_product` | Update product by ID. |
+| `delete_product` | Delete product by ID (cascades to product rate plans). |
+| `update_product_status` | Update status (published, archived, disabled). |
+| `link_external_product` | Link external product (productId, companyIntegrationId, external productId, settings). |
+| `unlink_external_product` | Unlink external product by ID. |
+
+#### Product rate plans (7 tools)
+
+| Tool | Description |
+|------|-------------|
+| `list_product_rate_plans` | List product rate plans for a product (GET /products/{productId}/product-rateplans). |
+| `get_product_rate_plan` | Get product rate plan by ID. |
+| `create_product_rate_plan` | Create product rate plan (productId, name, type: contract\|ongoing\|prepaid). |
+| `update_product_rate_plan` | Update product rate plan by ID. |
+| `delete_product_rate_plan` | Delete product rate plan by ID. |
+| `update_product_rate_plan_status` | Update status (published, archived, disabled, discontinue). |
+| `sync_product_rate_plan` | Sync product rate plan (POST …/sync). |
+
+#### Product rate plan charges (5 tools)
+
+| Tool | Description |
+|------|-------------|
+| `list_product_rate_plan_charges` | List product rate plan charges for a product rate plan (GET …/product-rateplan-charges). |
+| `get_product_rate_plan_charge` | Get product rate plan charge by ID. |
+| `create_product_rate_plan_charge` | Create product rate plan charge (ratePlanId, name, chargeType, chargeModel, billCycleType, category, **chargeTier** array, taxable, weight, endDateCondition, …). Enums: chargeType (oneTime, recurring, usage), chargeModel (flatFeePricing, perUnitPricing, tieredPricing, volumePricing), billingPeriod (day, week, month, year), billingTiming (inAdvance, inArrears). |
+| `update_product_rate_plan_charge` | Update product rate plan charge by ID. |
+| `delete_product_rate_plan_charge` | Delete product rate plan charge by ID. |
+
+#### Subscriptions (20 tools)
+
+| Tool | Description |
+|------|-------------|
+| `list_subscriptions` | List subscriptions (include, status, query, orderBy, sortBy, itemPerPage, pageNo). |
+| `get_subscription` | Get subscription by ID. |
+| `create_subscription` | Create subscription (customerId, name, companyCurrencyId, effectiveStartDate, ratePlan array). |
+| `update_subscription` | Update subscription by ID. |
+| `delete_subscription` | Delete subscription by ID. |
+| `update_subscription_status` | Update status (e.g. archived). |
+| `get_subscription_next_bill` | Preview next bill. |
+| `get_subscription_upcoming_charges` | Upcoming charges. |
+| `get_subscription_invoices` | Invoices for subscription. |
+| `get_subscription_logs` | Logs for subscription. |
+| `get_subscription_external_invoices` | External invoices. |
+| `list_subscription_rate_plans` | Rate plans on subscription. |
+| `get_subscription_rate_plan` | Get rate plan by ID. |
+| `add_subscription_rate_plan` | Add rate plan to subscription. |
+| `update_subscription_rate_plan` | Update rate plan (effectiveStartDate, etc.). |
+| `remove_subscription_rate_plan` | Remove rate plan from subscription. |
+| `get_subscription_rate_plan_charge` | Get rate plan charge by ID. |
+| `add_subscription_rate_plan_charge` | Add charge to rate plan. Required: subscriptionId, ratePlanId, quantity, name, category (physical\|digital), chargeModel (flatFeePricing\|perUnitPricing\|tieredPricing\|volumePricing), billCycleType, chargeTier (array: currency, price required; optional startingUnit, endingUnit, priceFormat, tier), chargeType (oneTime\|recurring\|usage), endDateCondition (subscriptionEnd\|fixedPeriod), taxable (boolean), weight. When chargeType is recurring, billingPeriodAlignment is also required. |
+| `update_subscription_rate_plan_charge` | Update rate plan charge. Required: subscriptionId, chargeId, quantity, name, chargeModel, billCycleType, chargeTier (currency, price), chargeType, endDateCondition, taxable, weight. When chargeType is recurring, billingPeriodAlignment required. |
+| `remove_subscription_rate_plan_charge` | Remove charge from rate plan. |
+
+#### Invoices (8 tools)
+
+| Tool | Description |
+|------|-------------|
+| `list_invoices` | List invoices (include, status, query, orderBy, sortBy, filterId, itemPerPage, pageNo). |
+| `get_invoice` | Get invoice by ID. |
+| `create_invoice` | Create invoice. Required: companyCurrencyId, companyGatewayId, customerId, paymentMethodId, detail. Optional billingAddress/shippingAddress use countryCode (ISO 3166-1 alpha-2). Amount can be '41.00' (dollars) or 4100 (cents); tool always sends cents to publicAPI. |
+| `update_invoice` | Update invoice (only posted/requestPayment). |
+| `delete_invoice` | Delete invoice by ID. |
+| `charge_invoice` | Charge invoice (card/online). Required: invoiceId, amount (cents), paymentType (e.g. thirdPartyPaymentProvider). |
+| `charge_invoice_external` | Charge via offline (cash/check/wire). Required: invoiceId, amount (cents). |
+| `void_invoice` | Void invoice (irreversible). |
+
+#### Transactions (4 tools)
+
+| Tool | Description |
+|------|-------------|
+| `list_transactions` | List transactions (orderBy, sortBy, itemPerPage, pageNo). |
+| `get_transaction` | Get transaction by ID. |
+| `refund_transaction` | Refund transaction. Required: transactionId, amount (**in cents**, e.g. 250 = $2.50). |
+| `void_transaction` | Void transaction (before settlement only). |
+
+#### Bill runs (4 tools)
+
+| Tool | Description |
+|------|-------------|
+| `list_bill_runs` | List bill runs. Optional: include (e.g. invoice), query (completed/pending/error), orderBy, sortBy, itemPerPage, pageNo. |
+| `get_bill_run` | Get bill run by ID. |
+| `update_bill_run` | Update bill run schedule. Required: billRunId, newDateTime (ISO 8601, e.g. 2026-02-26T20:05:00Z). |
+| `get_bill_run_invoices` | Get invoices for a bill run. |
+
+#### Gateways (9 tools)
+
+| Tool | Description |
+|------|-------------|
+| `list_global_gateways` | List available global gateway types (e.g. Stripe, Braintree). Returns **gblGatewayId**, name, keyName, **requiredFields** (setting keys), and fieldDetails. Call this before `create_gateway` to discover valid gateway IDs and which keys to pass in `setting`. |
+| `list_gateways` | List company gateways. |
+| `get_gateway` | Get gateway by ID. |
+| `create_gateway` | Create gateway. Required: **gblGatewayId** (from `list_global_gateways`), **setting** (object with keys from that gateway’s `requiredFields`). Optional: displayName, card, paymentMethod. Use `list_global_gateways` first to get gblGatewayId and required credential field names. |
+| `update_gateway` | Update gateway by ID. |
+| `delete_gateway` | Delete gateway by ID. |
+| `test_gateway` | Test gateway connection. |
+| `get_client_token` | Get the gateway client credential to initialize your payment integration and produce a **paymentMethodNonce** for create_customer_payment_method. Gateway-agnostic. Required: gatewayId. Optional: customerId; **required for PayFabric**, optional for others. |
+| `create_setup_intent` | Create/retrieve a setup intent via `/gateways/{companyGatewayId}/customers/{customerId}/setup_intent`. Use setupIntent.id as **paymentMethodNonce** for create_customer_payment_method (gateway-agnostic payment flow). |
+
+**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)
+
+| Tool | Description |
+|------|-------------|
+| `list_currencies` | List company currencies. |
+| `get_currency` | Get currency by ID. |
+| `create_currency` | Create company currency. |
+| `update_currency` | Update currency by ID. |
+| `delete_currency` | Delete currency by ID. |
+| `get_default_currency` | Get default company currency. |
+| `set_default_currency` | Set default currency by ID. |
+
+#### Integrations (8 tools)
+
+| Tool | Description |
+|------|-------------|
+| `list_integrations` | List company integrations. |
+| `get_integration_config` | Get integration config by ID. |
+| `get_integration_by_key` | Get integration by key. |
+| `list_integrations_by_key` | List integrations by key. |
+| `list_external_invoices` | List external invoices. |
+| `list_external_products` | List external products (productName required). |
+| `get_external_product` | Get external product by ID. |
+| `list_order_statuses` | List order statuses. |
+
+#### Shipping (2 tools)
+
+| Tool | Description |
+|------|-------------|
+| `list_shipping_services` | List shipping services. |
+| `calculate_shipping` | Calculate shipping (companyCurrencyId, fromZip, fromCountry, zip, country, weight, orderAmount, etc.). |
+
+#### Filters (4 tools)
+
+| Tool | Description |
+|------|-------------|
+| `list_filters` | List company filters. Required: section (e.g. subscriptions, invoices, customers, products, orders, billRuns). |
+| `create_filter` | Create filter (section, displayName, rules). |
+| `list_filter_fields` | List filter fields for a section. |
+| `remove_filter` | Delete a company filter by ID (DELETE /companies/filters/{filterId}). |
+
+#### Documentation (1 tool)
+
+| Tool | Description |
+|------|-------------|
+| `get_api_docs` | Get Rebillia API documentation as markdown. Default: overview (base URLs, auth, pagination, dates, amounts). Optional: doc = overview \| models \| subscription-statuses \| charge-types \| gateways. Use this so Claude can read docs without fetching external URLs. |
+
+### 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.
+
+| URI | Description |
+|-----|-------------|
+| `rebillia://docs/overview` | Overview documentation – base URLs, auth, pagination, date format, amount handling (read this first) |
+| `rebillia://docs/models` | Domain model hierarchy and relationships |
+| `rebillia://docs/subscription-statuses` | Subscription statuses: active, paused, archived, requestPayment |
+| `rebillia://docs/charge-types` | chargeType, chargeModel, billingPeriod, billingTiming enums |
+| `rebillia://docs/gateways` | Gateway creation flow: use `list_global_gateways` to discover gblGatewayId and requiredFields, then build `setting` and call `create_gateway` |
+| `rebillia://globals/gateways` | Global gateways list (when client provided): gblGatewayId, name, keyName, requiredFields, fieldDetails – use with `create_gateway` |
+
+## Project structure
+
+```
+mcp/
+├── src/
+│   ├── index.ts              # MCP server entry, registerResources(), 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
+│   │   ├── 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 (21)
+│   │   ├── 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 (20)
+│   │   ├── invoices/         # Invoice tools (8)
+│   │   ├── transactions/     # Transaction tools (4)
+│   │   ├── bill_runs/        # Bill run tools (4)
+│   │   ├── gateways/         # Gateway tools (8)
+│   │   ├── 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() (legacy apiResources)
+│   │   └── api-docs.ts       # registerResources(), docResources (rebillia://docs/*), getDocContent()
+│   └── prompts/              # (reserved for MCP prompts)
+├── .env.example
+├── package.json
+├── tsconfig.json
+└── README.md
+```
+
+## Scripts
+
+| Script | Command | Description |
+|--------|---------|-------------|
+| build | `npm run build` | Compile TypeScript to `dist/` |
+| start | `npm start` | Run `node dist/index.js` |
+| dev | `npm run dev` | Run with `tsx` (no build) |
+| test | `npm test` | Run Vitest |
+
+## License
+
+MIT

package/dist/client.d.ts

@@ -0,0 +1,45 @@
+/**
+ * HTTP client for the Rebillia REST API
+ */
+export default class RebilliaClient {
+    private apiKey;
+    private baseUrl;
+    constructor(apiKey: string, baseUrl?: string);
+    /**
+     * Root base URL without trailing /v1 (some endpoints like /globals/* are not versioned).
+     */
+    private rootBaseUrl;
+    /**
+     * Authenticate API requests with X-AUTH-TOKEN header
+     */
+    private authenticate;
+    /**
+     * Handle API errors with descriptive messages
+     */
+    private handleError;
+    /**
+     * GET request
+     */
+    get<T = any>(endpoint: string): Promise<T>;
+    /**
+     * GET request against API root (no /v1). Use for endpoints like /globals/countries.
+     */
+    getRoot<T = any>(endpoint: string): Promise<T>;
+    /**
+     * POST request against API root (no /v1). Use for unversioned/internal endpoints.
+     */
+    postRoot<T = any>(endpoint: string, data?: any): Promise<T>;
+    /**
+     * POST request
+     */
+    post<T = any>(endpoint: string, data?: any): Promise<T>;
+    /**
+     * PUT request
+     */
+    put<T = any>(endpoint: string, data?: any): Promise<T>;
+    /**
+     * DELETE request
+     */
+    delete<T = any>(endpoint: string): Promise<T>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,cAAc;IACjC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,MAAsC;IAK3E;;OAEG;IACH,OAAO,CAAC,WAAW;IAInB;;OAEG;IACH,OAAO,CAAC,YAAY;IAOpB;;OAEG;YACW,WAAW;IAazB;;OAEG;IACG,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAchD;;OAEG;IACG,OAAO,CAAC,CAAC,GAAG,GAAG,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAcpD;;OAEG;IACG,QAAQ,CAAC,CAAC,GAAG,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC;IAejE;;OAEG;IACG,IAAI,CAAC,CAAC,GAAG,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC;IAe7D;;OAEG;IACG,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC;IAe5D;;OAEG;IACG,MAAM,CAAC,CAAC,GAAG,GAAG,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;CAgBpD"}

package/dist/client.js

@@ -0,0 +1,130 @@
+/**
+ * HTTP client for the Rebillia REST API
+ */
+export default class RebilliaClient {
+    apiKey;
+    baseUrl;
+    constructor(apiKey, baseUrl = "https://api.rebillia.com/v1") {
+        this.apiKey = apiKey;
+        this.baseUrl = baseUrl;
+    }
+    /**
+     * Root base URL without trailing /v1 (some endpoints like /globals/* are not versioned).
+     */
+    rootBaseUrl() {
+        return this.baseUrl.replace(/\/v1\/?$/, "");
+    }
+    /**
+     * Authenticate API requests with X-AUTH-TOKEN header
+     */
+    authenticate() {
+        return {
+            "X-AUTH-TOKEN": this.apiKey,
+            "Content-Type": "application/json",
+        };
+    }
+    /**
+     * Handle API errors with descriptive messages
+     */
+    async handleError(response) {
+        let errorBody;
+        try {
+            errorBody = await response.text();
+        }
+        catch {
+            errorBody = "Unable to read error response";
+        }
+        throw new Error(`Rebillia API error (${response.status} ${response.statusText}): ${errorBody}`);
+    }
+    /**
+     * GET request
+     */
+    async get(endpoint) {
+        const url = `${this.baseUrl}${endpoint}`;
+        const response = await fetch(url, {
+            method: "GET",
+            headers: this.authenticate(),
+        });
+        if (!response.ok) {
+            await this.handleError(response);
+        }
+        return response.json();
+    }
+    /**
+     * GET request against API root (no /v1). Use for endpoints like /globals/countries.
+     */
+    async getRoot(endpoint) {
+        const url = `${this.rootBaseUrl()}${endpoint}`;
+        const response = await fetch(url, {
+            method: "GET",
+            headers: this.authenticate(),
+        });
+        if (!response.ok) {
+            await this.handleError(response);
+        }
+        return response.json();
+    }
+    /**
+     * POST request against API root (no /v1). Use for unversioned/internal endpoints.
+     */
+    async postRoot(endpoint, data) {
+        const url = `${this.rootBaseUrl()}${endpoint}`;
+        const response = await fetch(url, {
+            method: "POST",
+            headers: this.authenticate(),
+            body: data ? JSON.stringify(data) : undefined,
+        });
+        if (!response.ok) {
+            await this.handleError(response);
+        }
+        return response.json();
+    }
+    /**
+     * POST request
+     */
+    async post(endpoint, data) {
+        const url = `${this.baseUrl}${endpoint}`;
+        const response = await fetch(url, {
+            method: "POST",
+            headers: this.authenticate(),
+            body: data ? JSON.stringify(data) : undefined,
+        });
+        if (!response.ok) {
+            await this.handleError(response);
+        }
+        return response.json();
+    }
+    /**
+     * PUT request
+     */
+    async put(endpoint, data) {
+        const url = `${this.baseUrl}${endpoint}`;
+        const response = await fetch(url, {
+            method: "PUT",
+            headers: this.authenticate(),
+            body: data ? JSON.stringify(data) : undefined,
+        });
+        if (!response.ok) {
+            await this.handleError(response);
+        }
+        return response.json();
+    }
+    /**
+     * DELETE request
+     */
+    async delete(endpoint) {
+        const url = `${this.baseUrl}${endpoint}`;
+        const response = await fetch(url, {
+            method: "DELETE",
+            headers: this.authenticate(),
+        });
+        if (!response.ok) {
+            await this.handleError(response);
+        }
+        if (response.status === 204) {
+            return {};
+        }
+        return response.json();
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * Rebillia MCP Server
+ * Model Context Protocol server for Rebillia API integration
+ */
+import "dotenv/config";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;GAGG;AAEH,OAAO,eAAe,CAAC"}