> ## Documentation Index
> Fetch the complete documentation index at: https://docs.superdata.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Tool catalog

> Inputs, outputs, and examples for the hosted Superdata MCP tools.

Every tool below is read-only, idempotent at the tool-contract level, and costs
one credit when accepted for execution.

## `superdata_search_companies`

Find companies by industry, country, and employee range.

### Inputs

| Field         | Type      | Required | Rules                                       |
| ------------- | --------- | -------- | ------------------------------------------- |
| `industries`  | string\[] | No       | 1–10 values, up to 120 characters each      |
| `countries`   | string\[] | No       | 1–10 values, up to 120 characters each      |
| `employeeMin` | integer   | No       | Zero or greater                             |
| `employeeMax` | integer   | No       | Greater than zero and not below the minimum |
| `limit`       | integer   | No       | 1–50; defaults to 25                        |
| `cursor`      | string    | No       | Opaque cursor from the previous response    |

At least one search filter is required.

```json theme={null}
{
  "industries": ["Fintech"],
  "countries": ["United Kingdom"],
  "employeeMin": 20,
  "employeeMax": 200,
  "limit": 25
}
```

The result contains `id`, `name`, `website`, `industry`, `location`, and
`employeeCount`, plus pagination fields.

## `superdata_search_people`

Find current professional profiles by role, country, current-company industry,
and current-company size.

### Inputs

| Field                  | Type      | Required | Rules                                       |
| ---------------------- | --------- | -------- | ------------------------------------------- |
| `jobTitles`            | string\[] | No       | Current roles or levels                     |
| `countries`            | string\[] | No       | Current person locations                    |
| `companyIndustries`    | string\[] | No       | Current-company industries                  |
| `companyEmployeeMin`   | integer   | No       | Zero or greater                             |
| `companyEmployeeMax`   | integer   | No       | Greater than zero and not below the minimum |
| `confirmedBroadSearch` | boolean   | No       | Use only after explicit user confirmation   |
| `limit`                | integer   | No       | 1–50; defaults to 25                        |
| `cursor`               | string    | No       | Opaque cursor from the previous response    |

At least one search filter is required. Unless `confirmedBroadSearch` is
explicitly true, omitted role, country, industry, or company-size context
produces a clarification response.

```json theme={null}
{
  "jobTitles": ["VP Sales", "Head of Sales"],
  "countries": ["United States"],
  "companyIndustries": ["SaaS"],
  "companyEmployeeMin": 50,
  "companyEmployeeMax": 500,
  "limit": 25
}
```

The result contains `id`, `name`, `title`, `linkedinUrl`, `location`,
`companyName`, `companyWebsite`, `workEmail`, and `phoneNumber`, plus pagination
fields. Unavailable contact values are `null`.

## Clarification response

Both tools can return `status: "needs_clarification"`, an empty result array,
and one or more questions with suggestions. Clarification happens before
metered execution and consumes no credit.