Find customer
Customers matching an email, company or name.
MCP tool chargebee_read → find_customer
read
Searches Chargebee customers and returns the customer ID that every other endpoint takes. Email and names match exactly; company matches the start of the name. Newest customers come first. Pages hold up to 100 customers; pass next_cursor back as cursor for the next page.
Parameters
| Name | Type | Description |
|---|---|---|
| email string | string | Exact email address. |
| company string | string | Start of the company name. |
| first_name string | string | Exact first name. |
| last_name string | string | Exact last name. |
| limit integer | integer | 1 to 100. Default: 10. |
| cursor string | string | Next page cursor from the previous call. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "chargebee_read",
"arguments": {
"operation": "find_customer",
"arguments": {}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"customers": [
{
"customer_id": "cus_9s2kQw",
"company": "Brightleaf Analytics",
"first_name": "Billing",
"last_name": "Team",
"email": "billing@brightleaf.example",
"auto_collection": "on",
"created_at": "2025-03-12T09:14:00Z"
}
],
"next_cursor": null
},
"isError": false
}