Docs: Tool reference
customers toolset

get_company

Get a company. Gets one company with MRR, renewal date and risk, account owner, attributes, its users, and its requests: the posts its users voted on, with priority and notes, newest first. Team only. No side effects.

Toolset
customers
Who can call it
OwnersManagersContributorsAPI keys
REST
GET /api/v1/w/{workspace}/companies/{company}
Behavior
read-onlyidempotent

Input

FieldTypeDescription
companyrequiredstringThe company's ID (co_…), external ID or exact name.

Output

FieldTypeDescription
idrequiredstringID with prefix "co_"
namerequiredstring
external_idrequiredstring or null
mrrrequirednumber or null
renewal_daterequiredstring (date) or null
renewal_riskrequiredone of: low, medium, high or null
account_ownerrequiredobject or null
attributesrequiredobject
user_countrequiredinteger
versionrequiredinteger
created_atrequiredstring (date-time)
updated_atrequiredstring (date-time)
admin_urlrequiredstring (uri)
usersrequiredarray of objectUp to 50, most recently linked first.
requestsrequiredarray of objectVotes by the company's users, newest first, up to 50: what they asked for.

Calling it

// MCP: tools/call
{ "name": "get_company", "arguments": {"company":"<string>"} }

// Typed client
await carechannel.get_company({"company":"<string>"});