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

# OrbiSearch MCP tools

> The 14 tools the OrbiSearch MCP server provides: inputs, outputs and the REST endpoint each one matches.

Each tool runs the same code as a REST endpoint, so its output fields are the endpoint's response fields. Follow the endpoint link for the full field reference.

## Single calls

### `validate_email`

[Full reference](https://orbisearch.com/docs/mcp/tools/validate-email.md)

Checks whether one email address can receive mail. Returns `safe`, `risky`, `invalid` or `unknown`, with the reason and the mail provider. Each call is charged.

| Input | Required | Description |
| - | - | - |
| `email` | Yes | Email address to validate. |
| `timeout` | No | Timeout in seconds, 3 to 97. Default 97. |
| `retry_greylisted` | No | If the mail server says to try again later, wait about a minute and retry once. Needs a `timeout` of at least 80. |

Output: see [GET /v1/verify](https://orbisearch.com/docs/api-reference/verify-email.md).

### `find_email`

[Full reference](https://orbisearch.com/docs/mcp/tools/find-email.md)

Finds a person's work email from a LinkedIn profile URL, or from their name and company domain. Each call is charged, with credits or your unlimited plan depending on the app's [billing setting](https://orbisearch.com/docs/mcp/authentication.md#how-each-app-pays).

| Input | Required | Description |
| - | - | - |
| `linkedin_url` | One of the two ways | LinkedIn profile URL. Send this instead of a name and domain. |
| `first_name`, `last_name` | One of the two ways | At least one of the two, with `domain`. |
| `domain` | With a name | Company domain to search within. |

Output: see [POST /v1/email-lookup](https://orbisearch.com/docs/api-reference/email-lookup.md).

### `enrich_company`

[Full reference](https://orbisearch.com/docs/mcp/tools/enrich-company.md)

Returns a company's profile from its LinkedIn company URL or website domain. Each call is charged.

| Input | Required | Description |
| - | - | - |
| `linkedin_url` | One of the two | LinkedIn company or showcase URL. Preferred. |
| `domain` | One of the two | The company's website domain. |

Output: see [GET /v1/company-enrichment](https://orbisearch.com/docs/api-reference/company-enrichment.md).

### `check_spam_content`

[Full reference](https://orbisearch.com/docs/mcp/tools/check-spam-content.md)

Scores a cold email's text and subject line against spam filter rules. Free, with a daily limit.

| Input | Required | Description |
| - | - | - |
| `content` | Yes | Plain-text email body, up to 10,000 characters. |
| `subject` | No | Subject line. |

Output: see [POST /v1/content-spam-check](https://orbisearch.com/docs/api-reference/content-spam-check.md).

### `get_account`

[Full reference](https://orbisearch.com/docs/mcp/tools/get-account.md)

Shows your credit balance, how this app's email searches are paid (`credits` or `unlimited`), and your unlimited plan's usage if you have one. No inputs. Not charged.

## Bulk jobs

Bulk tools come in three families: validation, email search and company enrichment. Each family has a start tool, a status tool and a results tool.

| Family | Start | Status | Results | Matching endpoints |
| - | - | - | - | - |
| Validation | [`start_bulk_validation`](https://orbisearch.com/docs/mcp/tools/start-bulk-validation) | [`get_bulk_validation_status`](https://orbisearch.com/docs/mcp/tools/get-bulk-validation-status) | [`get_bulk_validation_results`](https://orbisearch.com/docs/mcp/tools/get-bulk-validation-results) | [Bulk verification](https://orbisearch.com/docs/api-reference/bulk-submit.md) |
| Email search | [`start_bulk_email_search`](https://orbisearch.com/docs/mcp/tools/start-bulk-email-search) | [`get_bulk_email_search_status`](https://orbisearch.com/docs/mcp/tools/get-bulk-email-search-status) | [`get_bulk_email_search_results`](https://orbisearch.com/docs/mcp/tools/get-bulk-email-search-results) | [Bulk email finder](https://orbisearch.com/docs/api-reference/bulk-lookup-submit.md) |
| Company enrichment | [`start_bulk_company_enrichment`](https://orbisearch.com/docs/mcp/tools/start-bulk-company-enrichment) | [`get_bulk_company_enrichment_status`](https://orbisearch.com/docs/mcp/tools/get-bulk-company-enrichment-status) | [`get_bulk_company_enrichment_results`](https://orbisearch.com/docs/mcp/tools/get-bulk-company-enrichment-results) | [Bulk company enrichment](https://orbisearch.com/docs/api-reference/company-enrichment-bulk-submit.md) |

* **Start** takes 1 to 1,000 rows, charges when the job starts (once per unique row), and returns a `job_id`.
* **Status** takes the `job_id` and returns progress. Not charged.
* **Results** takes the `job_id`, a `limit` of up to 100 rows and an `offset`. It returns `total_rows`, a page of `results` and `next_offset` for the next page (null on the last page). Email search and enrichment pages also start with a `summary` of outcomes. Not charged.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.