# Billsby — how to use (mcp.ai)

Connect your Billsby account and use 10 tools for payment processing straight from your AI agent. Connect with your own API key. Billsby is a subscription billing platform for managing customers, subscriptions, invoices, products, plans, usage counters, add-ons, and allowances.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_billsby?ms=1787296020000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `billsby_create_customer`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/billsby`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/billsby/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/billsby/create/customer` — Create a Billsby customer without a subscription or payment card. This does not start recurring billing.
  - body: { email: string, last_name: string, first_name: string, billing_address: object }
- `POST https://api.mcp.ai/api/billsby/get/customer` — Get billing, contact, payment-status, and account details for one Billsby customer.
  - body: { customer_unique_id: string }
- `POST https://api.mcp.ai/api/billsby/get/subscription` — Get billing schedule, customer, product, plan, pricing, status, and revenue details for one Billsby subscription.
  - body: { subscription_unique_id: string }
- `POST https://api.mcp.ai/api/billsby/get/subscription/shipping/address` — Get the shipping address associated with one Billsby subscription.
  - body: { subscription_unique_id: string }
- `POST https://api.mcp.ai/api/billsby/list/customer/subscriptions` — List all subscriptions belonging to one Billsby customer.
  - body: { customer_unique_id: string }
- `POST https://api.mcp.ai/api/billsby/list/customers` — Return one page of customers for the connected Billsby company, optionally filtered by a partial customer name.
  - body: { search?: string, page_size?: integer, next_cursor?: string }
- `POST https://api.mcp.ai/api/billsby/list/product/plans` — List the plans and billing cycles configured for one Billsby product.
  - body: { product_id: integer }
- `POST https://api.mcp.ai/api/billsby/list/products` — Return one page of Billsby products, optionally filtered by name or visibility.
  - body: { search?: string, page_size?: integer, visibility?: integer, next_cursor?: string }
- `POST https://api.mcp.ai/api/billsby/list/subscriptions` — Return one page of company subscriptions with optional status, trial, product, plan, and ordering filters.
  - body: { order_by?: string, is_active?: boolean, page_size?: integer, plan_name?: string, next_cursor?: string, product_name?: string, is_in_free_trial?: boolean, order_descending?: boolean }
- `POST https://api.mcp.ai/api/billsby/update/customer` — Replace the editable contact and billing-address details for an existing Billsby customer. Supply the complete desired values, not a partial patch.
  - body: { email: string, last_name: string, first_name: string, phone_number?: string, billing_address: object, customer_unique_id: string, phone_number_dial_code?: string, phone_number_dial_country?: string }

## Example prompts
- "What can I do in Billsby?"
- "Show me a summary of my Billsby account"

## More
- Page: https://mcp.ai/billsby
- Agent spec (llms.txt): https://mcp.ai/billsby/llms.txt
- Postman collection: https://mcp.ai/billsby/postman.json