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

# search_brokers

> Search for verified business brokers on Venturu by location, language, and more.

## search\_brokers

Search for verified business brokers (agents) on Venturu. Filter by location, name, language, and sort by various criteria.

<Info>
  This is a **read-only** tool. No authentication required.
</Info>

## Parameters

### Location

| Parameter      | Type     | Description                                     |
| -------------- | -------- | ----------------------------------------------- |
| `zipCode`      | `string` | Find brokers advertising in a specific ZIP code |
| `neighborhood` | `string` | Neighborhood name                               |
| `city`         | `string` | City name                                       |
| `county`       | `string` | County name                                     |
| `state`        | `string` | State or region                                 |
| `countryCode`  | `string` | ISO country code (e.g., `"US"`, `"CA"`)         |

<Tip>
  For the best results, provide `countryCode` along with more specific location fields like `state` or `city`. The server uses geo-localized subdivision queries to match brokers to their service areas.
</Tip>

### Filters

| Parameter          | Type       | Description                                                |
| ------------------ | ---------- | ---------------------------------------------------------- |
| `name`             | `string`   | Search brokers by name (case-insensitive partial match)    |
| `languageIds`      | `number[]` | Filter by languages spoken. Get IDs from `list_languages`. |
| `opportunityScore` | `object`   | Filter by opportunity score range (`min` / `max`)          |

### Sorting

| Parameter | Type     | Default | Description                                                                                                           |
| --------- | -------- | ------- | --------------------------------------------------------------------------------------------------------------------- |
| `sort`    | `string` | —       | Sort by: `"recommended"`, `"ai_score"`, `"most_active"`, `"highest_rated"`, `"most_experienced"`, or `"most_reviews"` |

### Pagination

| Parameter | Type      | Default | Description               |
| --------- | --------- | ------- | ------------------------- |
| `limit`   | `integer` | `15`    | Results per page (max 15) |
| `page`    | `integer` | `1`     | Page number (1-indexed)   |

## Response

The tool returns:

* **Text content** — A formatted summary of matching brokers
* **Structured content** — Machine-readable JSON:

```json theme={null}
{
  "brokers": [
    {
      "slug": "jane-smith",
      "name": "Jane Smith",
      "title": "Senior Business Broker",
      "company": "Smith & Associates",
      "serviceAreas": ["Miami, FL", "Fort Lauderdale, FL"],
      "languages": ["English", "Spanish"],
      "activeListings": 12
    }
  ],
  "total": 34
}
```

<Warning>
  Broker email addresses and phone numbers are **redacted** in search results for privacy. Use the `contact_broker` tool to send a message.
</Warning>

## Examples

<AccordionGroup>
  <Accordion title="Find brokers in a city">
    **Prompt:** "Find business brokers in Los Angeles"

    Parameters: `city: "Los Angeles"`, `state: "California"`, `countryCode: "US"`
  </Accordion>

  <Accordion title="Find Spanish-speaking brokers">
    **Prompt:** "Find brokers who speak Spanish in Florida"

    First call `list_languages` to get the Spanish language ID, then pass it in `languageIds` along with `state: "Florida"`.
  </Accordion>

  <Accordion title="Sort by experience">
    **Prompt:** "Show me the most experienced brokers in Texas"

    Parameters: `state: "Texas"`, `countryCode: "US"`, `sort: "most_experienced"`
  </Accordion>
</AccordionGroup>
