# Billsby — MCP server on 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.

By: mcp.ai · official
Page: https://mcp.ai/billsby

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_billsby?ms=1787293560000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/billsby/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/billsby/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/billsby/skill.md
Postman collection (v2.1): https://mcp.ai/billsby/postman.json

## Tools
- billsby_create_customer(email: string, last_name: string, first_name: string, billing_address: object) — Create a Billsby customer without a subscription or payment card. This does not start recurring billing.
- billsby_get_customer(customer_unique_id: string) — Get billing, contact, payment-status, and account details for one Billsby customer.
- billsby_get_subscription(subscription_unique_id: string) — Get billing schedule, customer, product, plan, pricing, status, and revenue details for one Billsby subscription.
- billsby_get_subscription_shipping_address(subscription_unique_id: string) — Get the shipping address associated with one Billsby subscription.
- billsby_list_customer_subscriptions(customer_unique_id: string) — List all subscriptions belonging to one Billsby customer.
- billsby_list_customers(search?: string, page_size?: integer, next_cursor?: string) — Return one page of customers for the connected Billsby company, optionally filtered by a partial customer name.
- billsby_list_product_plans(product_id: integer) — List the plans and billing cycles configured for one Billsby product.
- billsby_list_products(search?: string, page_size?: integer, visibility?: integer, next_cursor?: string) — Return one page of Billsby products, optionally filtered by name or visibility.
- billsby_list_subscriptions(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) — Return one page of company subscriptions with optional status, trial, product, plan, and ordering filters.
- billsby_update_customer(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) — Replace the editable contact and billing-address details for an existing Billsby customer. Supply the complete desired values, not a partial patch.

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

## Links
Docs: https://mcp.ai/docs/mcps/billsby
Website: https://mcp.ai/mcps/billsby