Business MCP tool
search_celebrities
Find public-figure records and structured bodygraph data for comparison, education, and discovery experiences.
Developer outcome: Add recognizable examples to an AI experience without maintaining a separate celebrity dataset.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
query | string | Yes | Full or partial celebrity name. |
limit | integer | No | Maximum number of matches. |
Request
Sanitized JSON-RPC
{
"jsonrpc": "2.0",
"id": 3,
"method": "tools/call",
"params": {
"name": "search_celebrities",
"arguments": {
"query": "David Bowie",
"limit": 10
}
}
}Success response shape
- Matching names and stable identifiers
- Known birth details
- Available bodygraph properties
The response also includes tier and quota metadata supplied by the API entitlement layer. Exact domain fields vary by tool and requested detail level.
Errors
- Business tier required
- Empty query
- No matches
- Quota exceeded
Quota behavior
A successful call consumes one shared API unit. Failed entitlement checks do not run the tool. Check current usage at my.humandesign.ai.