MCP TOOLcubeshell.company.search

Find Companies

Use when the user needs one company's business profile: industry, size, headquarters, founding year and description. Identify the company by domain (preferred), professional profile URL, or name. Returns one company or a not_found result. It does not list a company's people (use cubeshell.employee.find), its technologies (use cubeshell.company.technographics), or similar companies (use cubeshell.company.lookalike).

One company, not a list

Provide at least one of company_domain, profile_url or company_name. Domain is preferred because it identifies a company exactly. A call with none of the three is rejected as INVALID_INPUT before anything is charged. Despite the name, this tool resolves one company. It is not a multi-result search. For similar companies use cubeshell.company.lookalike.

Request

Workspace identity comes from the authenticated MCP connection, not from the call arguments. There is no workspace field to set.

Parameter	Type	Description
`request_id`required	`string`	Stable idempotency key, 1 to 200 characters. Replaying the same request_id with the same input returns the original result without a second charge.
`quote_only`required	`false`	Must be false. Quote-only preview is not available in this version.
`input.company_domain`	`string`	Bare company domain such as example.com. Not a URL. Up to 253 characters. Preferred identifier.
`input.profile_url`	`string`	Public professional profile URL for the company. Up to 500 characters.
`input.company_name`	`string`	Company name. Up to 200 characters. The least exact identifier, so send a domain when you have one.
`max_microcredits`	`integer`	Optional ceiling. If the authoritative price is higher, the call is rejected before anything is charged.

tools/call

{
  "name": "cubeshell.company.search",
  "arguments": {
    "request_id": "company-search-example-001",
    "quote_only": false,
    "input": { "company_domain": "example.com" }
  }
}

Result

On status: "succeeded", the result field holds the one company that was resolved. Fields are populated when they are known, so read defensively.

Parameter	Type	Description
`result.name`	`string`	Resolved company name. Always present on a succeeded result.
`result.company_id`	`integer`	Stable identifier for the resolved company.
`result.tagline`	`string`	Short company tagline.
`result.description`	`string`	Company description.
`result.industry`	`string`	Primary industry.
`result.specialties`	`string`	Reported areas of focus.
`result.website_url`	`string`	Company website.
`result.profile_url`	`string`	Professional profile URL for the company.
`result.linkedin_url`	`string`	Company profile URL on LinkedIn, when reported.
`result.logo_url`	`string`	Company logo image URL.
`result.locations`	`string`	Reported office locations beyond the headquarters.
`result.revenue`	`string`	Reported revenue band, when available.
`result.employee_range`	`string`	Headcount band as a display string, such as 51-200.
`result.employee_count`	`integer`	Reported headcount.
`result.employee_range_start`	`integer`	Lower bound of the headcount band.
`result.employee_range_end`	`integer`	Upper bound of the headcount band.
`result.founded`	`integer`	Founding year.
`result.follower_count`	`integer`	Public follower count on the company profile.
`result.hq_line1`	`string`	Headquarters street line.
`result.hq_city`	`string`	Headquarters city.
`result.hq_state`	`string`	Headquarters state or region.
`result.hq_postal_code`	`string`	Headquarters postal code.
`result.hq_country`	`string`	Headquarters country.
`result.email_found`	`boolean`	Whether an email is known to exist for this company. An availability flag only: no address is returned.
`result.mobile_found`	`boolean`	Whether a mobile number is known to exist for this company. An availability flag only: no number is returned.
`result.has_tech_stack`	`boolean`	Whether technologies are known for this company. Use cubeshell.company.technographics to read them.

Not found

When no company matches the identifier you sent, the call returns status: "not_found" with no result. This is a real terminal status rather than an error, and it is not charged. Treat it as a settled answer. An agent should not retry the same input hoping for a different one. Send a better identifier instead, such as the domain when a name did not resolve.

Job Change Check

Technology Lookup