Chargebee
Chargebee's MCP tools — Customers, Contacts, Invoices, Items, and Transactions.
Every field below is returned by its tool and is filterable — see Tool Catalog for the naming convention and filter operators.
Chargebee timestamps are Unix epoch integers
Fields like date, due_date, paid_at, next_retry_at, voided_at, generated_at, and expected_payment_date are stored as Unix epoch integers (seconds), not date/time columns — they support range filters (gt/lt/etc.) like any other number, just not date-formatted comparisons.
Customer
- Object:
customer - MCP tool name:
get_chargebee_customer
| Field | Type |
|---|---|
| id | Text |
| first_name | Text |
| last_name | Text |
| Text | |
| company | Text |
| phone | Text |
| preferred_currency_code | Text |
| promotional_credits | Number |
| refundable_credits | Number |
| excess_payments | Number |
| unbilled_charges | Number |
| primary_payment_source_id | Text |
| card_status | Text |
| taxability | Text |
| auto_collection | Text |
| net_term_days | Number |
| allow_direct_debit | Boolean |
| channel | Text |
| resource_version | Number |
| deleted | Boolean |
Not returned via MCP (nested JSON): billing_address, balances.
Contact
- Object:
contact - MCP tool name:
get_chargebee_contact
| Field | Type |
|---|---|
| id | Text |
| first_name | Text |
| last_name | Text |
| Text | |
| phone | Text |
| label | Text |
| enabled | Boolean |
| send_account_email | Boolean |
| send_billing_email | Boolean |
Invoice
- Object:
invoice - MCP tool name:
get_chargebee_invoice
| Field | Type |
|---|---|
| id | Text |
| customer_id | Text |
| subscription_id | Text |
| recurring | Boolean |
| status | Text |
| date | Number |
| due_date | Number |
| net_term_days | Number |
| po_number | Text |
| vat_number | Text |
| price_type | Text |
| exchange_rate | Number |
| local_currency_exchange_rate | Number |
| currency_code | Text |
| local_currency_code | Text |
| tax | Number |
| sub_total | Number |
| sub_total_in_local_currency | Number |
| total | Number |
| total_in_local_currency | Number |
| amount_due | Number |
| amount_adjusted | Number |
| amount_paid | Number |
| paid_at | Number |
| write_off_amount | Number |
| credits_applied | Number |
| dunning_status | Text |
| next_retry_at | Number |
| voided_at | Number |
| resource_version | Number |
| line_items_next_offset | Text |
| first_invoice | Boolean |
| new_sales_amount | Number |
| has_advance_charges | Boolean |
| term_finalized | Boolean |
| is_gifted | Boolean |
| generated_at | Number |
| expected_payment_date | Number |
| amount_to_collect | Number |
| round_off_amount | Number |
| void_reason_code | Text |
| deleted | Boolean |
| tax_category | Text |
| vat_number_prefix | Text |
| channel | Text |
| business_entity_id | Text |
Not returned via MCP (nested JSON): billing_address, shipping_address, adjustment_credit_notes, issued_credit_notes, line_items, linked_orders, linked_payments, reference_transactions, dunning_attempts, applied_credits, discounts, taxes, tax_origin, linked_taxes_withheld, notes, statement_descriptor, einvoice, site_details_at_creation.
Item
- Object:
item - MCP tool name:
get_chargebee_item
| Field | Type |
|---|---|
| id | Text |
| name | Text |
| description | Text |
| type | Text |
| status | Text |
| price | Number |
| deleted | Boolean |
| is_giftable | Boolean |
| is_shippable | Boolean |
| enabled_for_checkout | Boolean |
| enabled_in_portal | Boolean |
| item_family_id | Text |
| external_name | Text |
| unit | Text |
| metered | Boolean |
| resource_version | Number |
Transaction
- Object:
transaction - MCP tool name:
get_chargebee_transaction
| Field | Type |
|---|---|
| id | Text |
| customer_id | Text |
| subscription_id | Text |
| payment_method | Text |
| gateway | Text |
| type | Text |
| date | Number |
| exchange_rate | Number |
| amount | Number |
| status | Text |
| resource_version | Number |
| deleted | Boolean |
| currency_code | Text |
| amount_unused | Number |
Not returned via MCP (nested JSON): linked_invoices, linked_refunds.