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.search_businesses
Search listings with 30+ filters — location, price, revenue, industry, and more.
search_brokers
Find verified brokers by location, language, name, and rating.
Detail Tools
Retrieve full information about a specific business or broker.get_business
Get comprehensive details for a business listing by its slug.
get_broker
Get a broker’s full profile by their slug.
Lookup Tools
Discover available categories and languages to use as filter values in search tools.list_business_categories
All industry categories and business type IDs for filtering searches.
list_languages
All available languages with IDs for filtering broker searches.
Contact Tools
Send messages to brokers and sellers. These tools require authentication.contact_broker
Send a message to a broker by their profile slug. Requires auth.
contact_seller
Send a message to a listing’s seller by listing ID. Requires auth.
Identity
who_am_i
Verify the currently authenticated user’s identity. Requires auth.
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 |
Common Patterns
Search → Detail Flow
The typical usage pattern is to search first, then get details:- Call
list_business_categoriesto discover category IDs (if filtering by industry) - Call
search_businesseswith your desired filters - Call
get_businesswith 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_businessesreturns anextCursorvalue — pass it ascursorin the next callsearch_brokersaccepts apageparameter (starting at 1)