> ## 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.

# Tools Overview

> Complete reference for all 9 tools available on the Venturu MCP server.

## All Tools

The Venturu MCP server provides 9 tools for discovering, exploring, and contacting businesses and brokers. Tools are organized into functional categories.

### Search Tools

Find businesses and brokers using rich filters and natural-language location queries.

<CardGroup cols={2}>
  <Card title="search_businesses" icon="magnifying-glass" href="/mcp-server/tools/search-businesses">
    Search listings with 30+ filters — location, price, revenue, industry, and more.
  </Card>

  <Card title="search_brokers" icon="magnifying-glass" href="/mcp-server/tools/search-brokers">
    Find verified brokers by location, language, name, and rating.
  </Card>
</CardGroup>

### Detail Tools

Retrieve full information about a specific business or broker.

<CardGroup cols={2}>
  <Card title="get_business" icon="file-lines" href="/mcp-server/tools/get-business">
    Get comprehensive details for a business listing by its slug.
  </Card>

  <Card title="get_broker" icon="user" href="/mcp-server/tools/get-broker">
    Get a broker's full profile by their slug.
  </Card>
</CardGroup>

### Lookup Tools

Discover available categories and languages to use as filter values in search tools.

<CardGroup cols={2}>
  <Card title="list_business_categories" icon="tags" href="/mcp-server/tools/list-business-categories">
    All industry categories and business type IDs for filtering searches.
  </Card>

  <Card title="list_languages" icon="language" href="/mcp-server/tools/list-languages">
    All available languages with IDs for filtering broker searches.
  </Card>
</CardGroup>

### Contact Tools

Send messages to brokers and sellers. These tools require authentication.

<CardGroup cols={2}>
  <Card title="contact_broker" icon="paper-plane" href="/mcp-server/tools/contact-broker">
    Send a message to a broker by their profile slug. Requires auth.
  </Card>

  <Card title="contact_seller" icon="envelope" href="/mcp-server/tools/contact-seller">
    Send a message to a listing's seller by listing ID. Requires auth.
  </Card>
</CardGroup>

### Identity

<Card title="who_am_i" icon="circle-user" href="/mcp-server/tools/who-am-i">
  Verify the currently authenticated user's identity. Requires auth.
</Card>

## Tool Annotations

Each tool includes MCP annotations that inform AI clients about the tool's behavior:

| Annotation               | Meaning                                                           |
| ------------------------ | ----------------------------------------------------------------- |
| `readOnlyHint: true`     | The tool does not modify any data                                 |
| `destructiveHint: false` | The tool will not delete or irreversibly change data              |
| `openWorldHint: true`    | The tool interacts with external systems (e.g., sending messages) |
| `openWorldHint: false`   | The tool only reads from the Venturu database                     |

All search, detail, and lookup tools are annotated as **read-only** and **non-destructive**. Contact tools are annotated as **non-destructive** but **open-world** since they send messages.

## Common Patterns

### Search → Detail Flow

The typical usage pattern is to search first, then get details:

1. Call `list_business_categories` to discover category IDs (if filtering by industry)
2. Call `search_businesses` with your desired filters
3. Call `get_business` with a slug from the search results to see full details

### Pagination

Search tools use **cursor-based pagination** for businesses and **page-based pagination** for brokers:

* `search_businesses` returns a `nextCursor` value — pass it as `cursor` in the next call
* `search_brokers` accepts a `page` parameter (starting at 1)

Both tools default to 15 results per page (maximum 15).