Crawdar Business Research
Server Details
Evidence-backed public business research for agents with compact, pageable output.
- Status
- Healthy
- Last Tested
- Transport
- Streamable HTTP
- URL
TDQS
Scored across 10 tools
Tools are mostly distinct, with clear separation between sync/async search, job lifecycle, review scanning, and sandbox testing. However, search_businesses, research_businesses, and start_lead_search all overlap in the core 'find businesses' use case and require careful reading of descriptions to pick correctly.
All tools follow a consistent verb_noun snake_case pattern (e.g., start_lead_search, cancel_lead_search, scan_review_pain_points). The naming is predictable and clearly indicates the action being performed.
Ten tools is a well-scoped set for a business research and lead search API. It covers sync and async workflows, lifecycle operations, documentation, review scanning, and testing without feeling bloated or sparse.
The tool set covers the full lead-search lifecycle: start, get, cancel, refine, retry, plus sync search, research, review pain points, sandbox testing, and explainer. There are no obvious missing operations for the stated domain.
Available Tools
10 toolscancel_lead_searchCancel a lead searchADestructiveIdempotentInspect
Cancel a queued or running search job. Completed and failed jobs remain immutable.
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Queued or running job id. | |
| jobToken | Yes | Private token belonging to the job. |
Output Schema
| Name | Required | Description |
|---|---|---|
| id | Yes | |
| status | Yes | |
| canceledAt | No |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already flag destructiveHint and idempotentHint. The description adds useful behavioral context: only queued or running jobs are affected, and completed/failed jobs are immutable, which clarifies why the operation is idempotent for terminal states.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two sentences deliver the action, the resource scope, and an important caveat without any filler. The main verb and target are front-loaded, making the purpose immediately clear.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With an output schema present, both required parameters fully documented, and annotations covering safety profile, the description provides everything an agent needs to invoke cancellation appropriately. The immutability caveat covers edge cases of completed/failed jobs.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The input schema provides full descriptions for both required parameters (id and jobToken) with 100% coverage. The description adds no additional parameter-specific meaning, so the baseline score of 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific verb ('Cancel') and resource ('search job'), and further narrows scope to 'queued or running' jobs. This clearly distinguishes it from sibling tools like start_lead_search or get_lead_search.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies when cancellation is valid by noting 'Completed and failed jobs remain immutable', which serves as a when-not. However, it does not explicitly name alternatives or direct the agent to a different tool for other job states.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
explain_crawdarExplain Crawdar searchARead-onlyIdempotentInspect
Get result semantics, limits, interface URLs, and safe operating guidance. This tool does not consume a search.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Output Schema
| Name | Required | Description |
|---|---|---|
| guidance | Yes | |
| interfaces | Yes | |
| resultLanes | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint, idempotentHint, and destructiveHint. The description adds a meaningful behavioral trait: 'does not consume a search.' This goes beyond the annotations by clarifying that the tool performs no search operation, which is important context. No contradiction with annotations.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two concise sentences with no redundancy. The first sentence front-loads the core purpose, and the second adds a clarifying limitation. Every word earns its place, making it efficient and easy to parse.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given zero parameters and an output schema, the description covers the essential information: what the tool returns (semantics, limits, URLs, guidance) and what it does not do (consume a search). An agent can confidently use this tool to obtain operational context for the search tools, and nothing critical is missing.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The tool has zero parameters, so the baseline is 4. The description does not need to explain parameter semantics, and the schema confirms no parameters exist. The description appropriately focuses on the tool's function rather than parameters.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific purpose: to retrieve result semantics, limits, interface URLs, and safety guidance. It explicitly distinguishes itself from search operations with 'This tool does not consume a search.' This clearly differentiates it from the sibling search tools and gives an agent a precise understanding of what it does.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies usage by stating what it provides and clarifying it does not consume a search. This sets a clear boundary versus the sibling search tools, though it doesn't explicitly state 'use this when you need to understand the search tool' or provide alternative conditions. The context is clear enough for an agent to infer when to use it.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_lead_searchGet a lead search pageARead-onlyIdempotentInspect
Read job status or one cursor-paginated result page. Keep jobToken private and pass nextCursor back unchanged.
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Job id returned by start_lead_search, refine_lead_search, or retry_lead_search. | |
| view | No | Compact minimizes tokens. Full retains detailed evidence fields. | compact |
| limit | No | Maximum prospects in this result page. | |
| cursor | No | Opaque nextCursor from the previous response. | |
| jobToken | Yes | Private token returned with the job. Do not log or share it. |
Output Schema
| Name | Required | Description |
|---|---|---|
| id | Yes | |
| error | No | |
| status | Yes | |
| results | No | |
| progress | No | |
| returned | No | |
| warnings | No | |
| createdAt | No | |
| errorCode | No | |
| nextCursor | No | |
| retryAfter | No | |
| completedAt | No | |
| diagnostics | No | |
| resultCount | No | |
| searchedSources | No |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already mark the operation as read-only, idempotent, and non-destructive. The description adds valuable behavioral detail beyond that: the tool returns either job status or a paginated page, jobToken must be kept private, and cursor must be passed back unchanged. No contradiction with annotations exists.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two short sentences front-load the core purpose and then give the two essential operational cautions. There is no filler or redundant restatement of the tool name.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With an output schema present, annotations providing the safety profile, and full parameter documentation, the description supplies the missing high-level semantics: status/page duality, opaque cursor chaining, and token privacy. An agent has enough information to invoke it correctly.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, and the schema already documents id provenance, view behavior, limit bounds, cursor opacity, and jobToken privacy. The description's 'keep jobToken private' and 'pass nextCursor back unchanged' largely echo schema text, with only the 'unchanged' nuance adding slight extra meaning.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific verb ('Read') and resource ('job status or one cursor-paginated result page'). This clearly distinguishes it from sibling tools like start_lead_search, refine_lead_search, retry_lead_search, and cancel_lead_search, which create, modify, or cancel jobs rather than read results.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description clearly frames the tool as a retrieval and pagination operation, and the instruction to pass nextCursor back unchanged gives concrete usage context. It does not explicitly name alternatives or exclusions, but the sibling tool set makes the retrieval-versus-creation contrast obvious.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
refine_lead_searchRefine a lead searchAInspect
Create a new private search job by changing the brief or criteria of a completed job. The original job stays unchanged.
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Completed source job id returned by an earlier durable search call. | |
| brief | No | Replacement natural-language brief for the new job. | |
| limit | No | Maximum prospects retained by the new job. | |
| fields | No | Business fields to retain. Website and source evidence remain available for verification. | |
| target | No | Replacement business target for the new job. | |
| jobToken | Yes | Private token belonging to the source job. | |
| geography | No | Replacement city, region, country, or Worldwide. | |
| qualifier | No | Replacement public requirements and exclusions. |
Output Schema
| Name | Required | Description |
|---|---|---|
| id | Yes | Stable job identifier. Use it with jobToken in every lifecycle call. |
| status | Yes | Current durable job state. |
| cacheHit | No | |
| jobToken | No | Private bearer token required to read, refine, or export this job. |
| retryUrl | Yes | Authenticated REST URL for creating a replacement after retryable failure. |
| cancelUrl | Yes | Authenticated REST URL for canceling queued or running work. |
| exportUrl | Yes | Authenticated CSV export URL. Add format=json for JSON. |
| statusUrl | Yes | Authenticated REST URL for job status and result pages. |
| resultCount | No | |
| expiresInSeconds | Yes | Seconds until the private job and token expire. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already indicate readOnly=false, destructive=false, and idempotent=false. The description adds that the original job remains unchanged, but it does not disclose persistence behavior, asynchronous job polling, rate limits, or other side effects beyond creating a new job.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, focused sentence with no filler. It front-loads the core action and key constraint, making it easy to parse quickly.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The schema and annotations cover the parameter and safety landscape, and the description gives the essential purpose. However, it omits lifecycle context such as how to retrieve the resulting job or whether it is asynchronous, which would be useful given the job-based nature of the tool.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, and each parameter has a clear one-line description. The tool description itself adds no additional meaning beyond what the input schema already provides, so the baseline score applies.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific verb ('Create'), a distinct resource ('new private search job'), and a unique action ('by changing the brief or criteria of a completed job'). The explicit non-destructive outcome ('The original job stays unchanged') further disambiguates it from similar lead-search tools.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies use when refining a completed lead search and clearly frames the action, but it does not explicitly name alternatives such as start_lead_search or retry_lead_search, nor does it provide direct 'when not to use' guidance. Context is present but not fully explicit.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
research_businessesResearch businesses from a briefARead-onlyInspect
Use for a quick synchronous search when the user supplies one natural-language brief and can wait for results in the current tool call. For durable progress, retry, export, or large agent workflows, use start_lead_search instead.
| Name | Required | Description | Default |
|---|---|---|---|
| brief | Yes | Example: Independent veterinary clinics in Berlin with an active first-party website. Exclude directories and chains. | |
| limit | No | Maximum businesses in this response page. | |
| fields | No | Business fields to retain. Website and source evidence remain available for verification. | |
| offset | No | Zero-based result offset for this response page. | |
| output | No | Compact minimizes tokens. Full preserves every returned field. | compact |
| geography | No | Optional explicit geography. Use when the brief does not make location clear. | |
| includeDiagnostics | No | Include source status and explained exclusions. |
Output Schema
| Name | Required | Description |
|---|---|---|
| limit | Yes | Maximum prospects requested for this page. |
| offset | Yes | Zero-based offset of this page. |
| hasMore | Yes | Whether another result page is available. |
| results | Yes | |
| warnings | Yes | Limitations the agent should retain with downstream data. |
| requestId | Yes | Request identifier for support and diagnostics. |
| durationMs | No | |
| nextOffset | No | Offset for the next synchronous result page, or null when complete. |
| diagnostics | No | Source status and explained candidate exclusions. |
| resultCount | Yes | Total accepted prospects before response pagination. |
| returnedCount | Yes | Prospects returned in this response page. |
| schemaVersion | Yes | Version of the result contract. |
| searchedSources | Yes | Discovery and first-party source types consulted. |
| remainingFreeSearches | No |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint=true and destructiveHint=false, so the safety profile is covered. The description adds the synchronous, quick nature and the contrast with the durable asynchronous sibling, which is valuable context beyond the annotations. It does not contradict annotations and provides the expected call-time behavior.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two sentences with zero waste. The primary use case is front-loaded in the first sentence, and the alternative is clearly stated in the second. It is concise, structured, and every word contributes to the agent's decision.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's complexity (7 parameters, 1 required) and the presence of a detailed input schema and output schema, the description is sufficient. It explains the synchronous nature and the routing to the async sibling. It does not cover pagination or output details, but those are already in the schema, and the description provides the key decision guidance for an agent.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100% and all seven parameters have detailed descriptions (e.g., brief example, limit bounds, fields enum). The description does not add parameter-specific semantics but reinforces that the brief is a natural-language query. With full schema coverage, a baseline of 3 is appropriate; the description adds no extra meaning beyond the schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific verb ('research') and resource ('businesses'), and immediately defines the scope: a quick synchronous search from a natural-language brief. It distinguishes itself from start_lead_search by naming the alternative, making it clear this tool is for immediate results in the current call. No ambiguity.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description explicitly says 'Use for a quick synchronous search when the user supplies one natural-language brief and can wait for results in the current tool call' and then explicitly routes other workflows ('durable progress, retry, export, or large agent workflows') to start_lead_search instead. This gives both when-to-use and when-not-to-use guidance with a named alternative.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
retry_lead_searchRetry a stopped lead searchAInspect
Create a replacement job when a prior job failed or exceeded its execution window. The original job stays available for audit.
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Failed or timed-out source job id. | |
| jobToken | Yes | Private token belonging to the source job. |
Output Schema
| Name | Required | Description |
|---|---|---|
| id | Yes | Stable job identifier. Use it with jobToken in every lifecycle call. |
| status | Yes | Current durable job state. |
| cacheHit | No | |
| jobToken | No | Private bearer token required to read, refine, or export this job. |
| retryUrl | Yes | Authenticated REST URL for creating a replacement after retryable failure. |
| cancelUrl | Yes | Authenticated REST URL for canceling queued or running work. |
| exportUrl | Yes | Authenticated CSV export URL. Add format=json for JSON. |
| statusUrl | Yes | Authenticated REST URL for job status and result pages. |
| resultCount | No | |
| expiresInSeconds | Yes | Seconds until the private job and token expire. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
The description makes the mutation explicit ('Create a replacement job') and adds a side effect detail (original stays for audit). It does not mention idempotency or permissions, but the annotations already cover the read-only and destructiveness hints, and the description aligns with them.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is two sentences, concise and to the point, with no unnecessary details or repetition. It is well-structured and front-loads the core purpose.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The description is complete enough given the output schema exists and the parameters are well-described. It does not cover error cases or output details, but these are not required for a tool of this simplicity.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Both parameters have descriptions in the schema that add meaning: 'id' is 'Failed or timed-out source job id' and 'jobToken' is 'Private token belonging to the source job'. This exceeds simple name-based inference.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
Description clearly states the action ('Create a replacement job') and the specific object ('replacement job'), and distinguishes it from siblings by noting the original job stays for audit. It is clear and specific.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description explicitly states when to use it ('when a prior job failed or exceeded its execution window'), providing a clear condition. It does not explicitly name alternatives, but the condition sufficiently guides usage.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
sandbox_businessesTest the Crawdar contractARead-onlyIdempotentInspect
Return deterministic fictional businesses without consuming provider capacity. Use this to test schemas, clients, and agent loops.
| Name | Required | Description | Default |
|---|---|---|---|
| target | No | Fictional business type echoed into deterministic test results. | |
| geography | No | Fictional location echoed into deterministic test results. |
Output Schema
| Name | Required | Description |
|---|---|---|
| limit | Yes | Maximum prospects requested for this page. |
| offset | Yes | Zero-based offset of this page. |
| hasMore | Yes | Whether another result page is available. |
| results | Yes | |
| warnings | Yes | Limitations the agent should retain with downstream data. |
| requestId | Yes | Request identifier for support and diagnostics. |
| durationMs | No | |
| nextOffset | No | Offset for the next synchronous result page, or null when complete. |
| diagnostics | No | Source status and explained candidate exclusions. |
| resultCount | Yes | Total accepted prospects before response pagination. |
| returnedCount | Yes | Prospects returned in this response page. |
| schemaVersion | Yes | Version of the result contract. |
| searchedSources | Yes | Discovery and first-party source types consulted. |
| remainingFreeSearches | No |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
The description clearly indicates the tool returns fictional deterministic data and has no provider-side consumption, aligning with the readOnlyHint annotation. It also implies idempotency through 'deterministic' and is consistent with the destructiveHint false annotation. No behavioral contradictions are present.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is tightly written in two sentences with no redundant wording. It front-loads the primary purpose and immediately follows with concrete usage guidance.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the annotations, input schema, output schema, and sibling tool context, the description covers all essential information an agent needs: purpose, behavior, parameters, and safe usage. There are no missing critical details.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Both parameters are described with their meaning and role in generating deterministic test results. The schema coverage is 100%, and the description adds that values are 'echoed' into results, clarifying how the parameters affect output.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description uses a specific verb ('Return') and clearly identifies the resource as deterministic fictional businesses. It also distinguishes this tool from production data tools by noting it does not consume provider capacity and is intended for testing schemas, clients, and agent loops.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description explicitly states when to use the tool: 'Use this to test schemas, clients, and agent loops.' This provides clear guidance on the intended scenario and helps differentiate it from the sibling search/research tools.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
scan_review_pain_pointsFind recurring customer complaintsARead-onlyInspect
Scan a named business or discover up to three businesses for recent recurring complaints. Returns individually sourced reviews and possible technical solutions. Coverage is sampled; unavailable reviews never mean no problems. Five scans per day. Google reviews require a configured provider.
| Name | Required | Description | Default |
|---|---|---|---|
| target | No | ||
| website | No | ||
| business | No | ||
| geography | No | ||
| reviewUrls | No | ||
| googlePlaceId | No |
Output Schema
| Name | Required | Description |
|---|---|---|
| id | No | |
| status | No | |
| reports | No | |
| limitations | No |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint=true and openWorldHint=true, but the description adds critical behavior beyond them: coverage is sampled (unavailable reviews never mean no problems), a five-scans-per-day rate limit, and a dependency on a configured provider for Google reviews. These are non-obvious traits that materially affect invocation.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is three tight sentences, front-loading the primary action and purpose. Each sentence earns its place: the core function, the sampling caveat, and the operational constraints (rate limit and provider requirement). No filler.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With six parameters, zero schema descriptions, and no explanation of which parameters map to 'named business' or 'discover up to three businesses,' the description is insufficient for correct invocation. The output schema exists, so return format isn't a gap, but input semantics are entirely unaddressed. The operational constraints are helpful but don't compensate for missing parameter guidance.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 0%, so the description must compensate by explaining parameter meanings. It does not mention any of the six parameters (target, website, business, geography, reviewUrls, googlePlaceId) or how they relate to the described behavior. An agent cannot determine what to provide.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states a specific action (scan) and resource (a named business or discover up to three businesses) for a distinct purpose (recurring complaints). It differentiates from sibling tools by focusing on complaints and solutions, not leads or generic research.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies usage for complaint analysis but doesn't explicitly contrast with alternatives like search_businesses or research_businesses. It provides caveats (coverage sampling, rate limit, provider dependency) that inform when it's applicable, but lacks explicit when-not guidance or alternative routing.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
search_businessesSearch businesses with structured criteriaARead-onlyInspect
Use for a quick synchronous search when target, geography, and qualification fields are already structured. Use research_businesses for a plain-language brief, or start_lead_search for durable asynchronous work.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum businesses in this response page. | |
| fields | No | Business fields to retain. Website and source evidence remain available for verification. | |
| offset | No | Zero-based result offset for this response page. | |
| output | No | Compact minimizes tokens. Full preserves every returned field. | compact |
| target | Yes | Business type or concise target. | |
| geography | Yes | City, region, country, or Worldwide. | |
| qualifier | No | Optional required signals and exclusions that can be checked in public evidence. | |
| includeDiagnostics | No | Include source status and explained exclusions. |
Output Schema
| Name | Required | Description |
|---|---|---|
| limit | Yes | Maximum prospects requested for this page. |
| offset | Yes | Zero-based offset of this page. |
| hasMore | Yes | Whether another result page is available. |
| results | Yes | |
| warnings | Yes | Limitations the agent should retain with downstream data. |
| requestId | Yes | Request identifier for support and diagnostics. |
| durationMs | No | |
| nextOffset | No | Offset for the next synchronous result page, or null when complete. |
| diagnostics | No | Source status and explained candidate exclusions. |
| resultCount | Yes | Total accepted prospects before response pagination. |
| returnedCount | Yes | Prospects returned in this response page. |
| schemaVersion | Yes | Version of the result contract. |
| searchedSources | Yes | Discovery and first-party source types consulted. |
| remainingFreeSearches | No |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already establish readOnlyHint, openWorldHint, idempotentHint, and destructiveHint. The description adds useful context by characterizing the call as quick and synchronous, and there is no contradiction with the annotations.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is concise, front-loaded with the primary use case, and efficiently contrasts sibling tools without unnecessary detail.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The description, combined with the parameter schema and annotations, provides enough context for invoking a synchronous search and interpreting paging-related outputs. It could mention return shape more explicitly, but the output enum and parameter descriptions cover the essentials.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema descriptions cover 100% of parameters, so the baseline applies. The tool description does not add much beyond the schema, though it does reinforce that target, geography, and qualifier are the structured search fields.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
Description uses the specific verb 'search' and identifies the resource 'businesses.' It clearly distinguishes from siblings by noting the structured-criteria synchronous use case versus research_businesses for plain-language briefs and start_lead_search for durable async work.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Explicitly states when to use the tool: quick synchronous search when target, geography, and qualification fields are already structured. It also names alternatives for different scenarios, leaving little ambiguity about selection.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
start_lead_searchStart a durable lead searchAInspect
Use for the recommended durable asynchronous workflow. Creates a private queued search job and returns a job id plus jobToken for progress polling, cursor paging, refinement, retry, cancellation, and CSV or JSON export.
| Name | Required | Description | Default |
|---|---|---|---|
| brief | No | Natural-language business, geography, required signals, and exclusions. Use this instead of separate target and geography. | |
| limit | No | Maximum accepted prospects retained by the job. | |
| fields | No | Business fields to retain. Website and source evidence remain available for verification. | |
| target | No | Business type or concise ideal-customer target. Pair with geography when brief is omitted. | |
| geography | No | City, region, country, or Worldwide. Required with target when brief is omitted. | |
| qualifier | No | Publicly verifiable requirements and exclusions. | |
| idempotencyKey | No | Stable key for safely retrying the same job creation request. |
Output Schema
| Name | Required | Description |
|---|---|---|
| id | Yes | Stable job identifier. Use it with jobToken in every lifecycle call. |
| status | Yes | Current durable job state. |
| cacheHit | No | |
| jobToken | No | Private bearer token required to read, refine, or export this job. |
| retryUrl | Yes | Authenticated REST URL for creating a replacement after retryable failure. |
| cancelUrl | Yes | Authenticated REST URL for canceling queued or running work. |
| exportUrl | Yes | Authenticated CSV export URL. Add format=json for JSON. |
| statusUrl | Yes | Authenticated REST URL for job status and result pages. |
| resultCount | No | |
| expiresInSeconds | Yes | Seconds until the private job and token expire. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Description discloses that it creates a job, is asynchronous and queued, and returns identifiers for subsequent operations; consistent with annotations (idempotentHint=false, readOnlyHint=false).
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two sentences, front-loaded with usage recommendation, then concise feature list; no redundancy.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Provides purpose, async nature, return identifiers, and downstream capabilities; since output schema exists, no need to detail return fields.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema already covers all parameters with descriptions; description adds high-level workflow context but does not detail parameter usage, so baseline 3.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific verb 'creates' and resource 'private queued search job', and positions it as the recommended durable asynchronous workflow, distinguishing it from synchronous siblings.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Explicitly says 'Use for the recommended durable asynchronous workflow' and enumerates downstream capabilities (polling, paging, refinement, retry, cancellation, export), signaling when to choose this tool; however, it does not explicitly name sibling tools for contrast.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
1 tool update
- Added
scan_review_pain_points
8 tool updates
- Changed
cancel_lead_search2 fields changed- added
Input schema / properties / id / descriptionAdded value: +"Queued or running job id." - added
Input schema / properties / jobToken / descriptionAdded value: +"Private token belonging to the job."
- Changed
get_lead_search4 fields changed- added
Input schema / properties / id / descriptionAdded value: +"Job id returned by start_lead_search, refine_lead_search, or retry_lead_search." - added
Input schema / properties / jobToken / descriptionAdded value: +"Private token returned with the job. Do not log or share it." - added
Input schema / properties / limit / descriptionAdded value: +"Maximum prospects in this result page." - added
Input schema / properties / view / descriptionAdded value: +"Compact minimizes tokens. Full retains detailed evidence fields."
- Changed
refine_lead_search15 fields changed- added
Input schema / properties / brief / descriptionAdded value: +"Replacement natural-language brief for the new job." - added
Input schema / properties / fields / descriptionAdded value: +"Business fields to retain. Website and source evidence remain available for verification." - added
Input schema / properties / geography / descriptionAdded value: +"Replacement city, region, country, or Worldwide." - added
Input schema / properties / id / descriptionAdded value: +"Completed source job id returned by an earlier durable search call." - added
Input schema / properties / jobToken / descriptionAdded value: +"Private token belonging to the source job." - added
Input schema / properties / limit / descriptionAdded value: +"Maximum prospects retained by the new job." - added
Input schema / properties / qualifier / descriptionAdded value: +"Replacement public requirements and exclusions." - added
Input schema / properties / target / descriptionAdded value: +"Replacement business target for the new job." - added
Output schema / properties / cancelUrl / descriptionAdded value: +"Authenticated REST URL for canceling queued or running work." - added
Output schema / properties / expiresInSeconds / descriptionAdded value: +"Seconds until the private job and token expire." - added
Output schema / properties / exportUrl / descriptionAdded value: +"Authenticated CSV export URL. Add format=json for JSON." - added
Output schema / properties / id / descriptionAdded value: +"Stable job identifier. Use it with jobToken in every lifecycle call." - added
Output schema / properties / retryUrl / descriptionAdded value: +"Authenticated REST URL for creating a replacement after retryable failure." - added
Output schema / properties / status / descriptionAdded value: +"Current durable job state." - added
Output schema / properties / statusUrl / descriptionAdded value: +"Authenticated REST URL for job status and result pages."
- Changed
research_businesses12 fields changed- added
Input schema / properties / fields / descriptionAdded value: +"Business fields to retain. Website and source evidence remain available for verification." - added
Output schema / properties / diagnostics / descriptionAdded value: +"Source status and explained candidate exclusions." - added
Output schema / properties / hasMore / descriptionAdded value: +"Whether another result page is available." - added
Output schema / properties / limit / descriptionAdded value: +"Maximum prospects requested for this page." - added
Output schema / properties / nextOffset / descriptionAdded value: +"Offset for the next synchronous result page, or null when complete." - added
Output schema / properties / offset / descriptionAdded value: +"Zero-based offset of this page." - added
Output schema / properties / requestId / descriptionAdded value: +"Request identifier for support and diagnostics." - added
Output schema / properties / resultCount / descriptionAdded value: +"Total accepted prospects before response pagination." - added
Output schema / properties / returnedCount / descriptionAdded value: +"Prospects returned in this response page." - added
Output schema / properties / schemaVersion / descriptionAdded value: +"Version of the result contract." - added
Output schema / properties / searchedSources / descriptionAdded value: +"Discovery and first-party source types consulted." - added
Output schema / properties / warnings / descriptionAdded value: +"Limitations the agent should retain with downstream data."
- Changed
retry_lead_search9 fields changed- added
Input schema / properties / id / descriptionAdded value: +"Failed or timed-out source job id." - added
Input schema / properties / jobToken / descriptionAdded value: +"Private token belonging to the source job." - added
Output schema / properties / cancelUrl / descriptionAdded value: +"Authenticated REST URL for canceling queued or running work." - added
Output schema / properties / expiresInSeconds / descriptionAdded value: +"Seconds until the private job and token expire." - added
Output schema / properties / exportUrl / descriptionAdded value: +"Authenticated CSV export URL. Add format=json for JSON." - added
Output schema / properties / id / descriptionAdded value: +"Stable job identifier. Use it with jobToken in every lifecycle call." - added
Output schema / properties / retryUrl / descriptionAdded value: +"Authenticated REST URL for creating a replacement after retryable failure." - added
Output schema / properties / status / descriptionAdded value: +"Current durable job state." - added
Output schema / properties / statusUrl / descriptionAdded value: +"Authenticated REST URL for job status and result pages."
- Changed
sandbox_businesses13 fields changed- added
Input schema / properties / geography / descriptionAdded value: +"Fictional location echoed into deterministic test results." - added
Input schema / properties / target / descriptionAdded value: +"Fictional business type echoed into deterministic test results." - added
Output schema / properties / diagnostics / descriptionAdded value: +"Source status and explained candidate exclusions." - added
Output schema / properties / hasMore / descriptionAdded value: +"Whether another result page is available." - added
Output schema / properties / limit / descriptionAdded value: +"Maximum prospects requested for this page." - added
Output schema / properties / nextOffset / descriptionAdded value: +"Offset for the next synchronous result page, or null when complete." - added
Output schema / properties / offset / descriptionAdded value: +"Zero-based offset of this page." - added
Output schema / properties / requestId / descriptionAdded value: +"Request identifier for support and diagnostics." - added
Output schema / properties / resultCount / descriptionAdded value: +"Total accepted prospects before response pagination." - added
Output schema / properties / returnedCount / descriptionAdded value: +"Prospects returned in this response page." - added
Output schema / properties / schemaVersion / descriptionAdded value: +"Version of the result contract." - added
Output schema / properties / searchedSources / descriptionAdded value: +"Discovery and first-party source types consulted." - added
Output schema / properties / warnings / descriptionAdded value: +"Limitations the agent should retain with downstream data."
- Changed
search_businesses12 fields changed- added
Input schema / properties / fields / descriptionAdded value: +"Business fields to retain. Website and source evidence remain available for verification." - added
Output schema / properties / diagnostics / descriptionAdded value: +"Source status and explained candidate exclusions." - added
Output schema / properties / hasMore / descriptionAdded value: +"Whether another result page is available." - added
Output schema / properties / limit / descriptionAdded value: +"Maximum prospects requested for this page." - added
Output schema / properties / nextOffset / descriptionAdded value: +"Offset for the next synchronous result page, or null when complete." - added
Output schema / properties / offset / descriptionAdded value: +"Zero-based offset of this page." - added
Output schema / properties / requestId / descriptionAdded value: +"Request identifier for support and diagnostics." - added
Output schema / properties / resultCount / descriptionAdded value: +"Total accepted prospects before response pagination." - added
Output schema / properties / returnedCount / descriptionAdded value: +"Prospects returned in this response page." - added
Output schema / properties / schemaVersion / descriptionAdded value: +"Version of the result contract." - added
Output schema / properties / searchedSources / descriptionAdded value: +"Discovery and first-party source types consulted." - added
Output schema / properties / warnings / descriptionAdded value: +"Limitations the agent should retain with downstream data."
- Changed
start_lead_search13 fields changed- added
Input schema / properties / brief / descriptionAdded value: +"Natural-language business, geography, required signals, and exclusions. Use this instead of separate target and geography." - added
Input schema / properties / fields / descriptionAdded value: +"Business fields to retain. Website and source evidence remain available for verification." - added
Input schema / properties / geography / descriptionAdded value: +"City, region, country, or Worldwide. Required with target when brief is omitted." - added
Input schema / properties / limit / descriptionAdded value: +"Maximum accepted prospects retained by the job." - added
Input schema / properties / qualifier / descriptionAdded value: +"Publicly verifiable requirements and exclusions." - added
Input schema / properties / target / descriptionAdded value: +"Business type or concise ideal-customer target. Pair with geography when brief is omitted." - added
Output schema / properties / cancelUrl / descriptionAdded value: +"Authenticated REST URL for canceling queued or running work." - added
Output schema / properties / expiresInSeconds / descriptionAdded value: +"Seconds until the private job and token expire." - added
Output schema / properties / exportUrl / descriptionAdded value: +"Authenticated CSV export URL. Add format=json for JSON." - added
Output schema / properties / id / descriptionAdded value: +"Stable job identifier. Use it with jobToken in every lifecycle call." - added
Output schema / properties / retryUrl / descriptionAdded value: +"Authenticated REST URL for creating a replacement after retryable failure." - added
Output schema / properties / status / descriptionAdded value: +"Current durable job state." - added
Output schema / properties / statusUrl / descriptionAdded value: +"Authenticated REST URL for job status and result pages."
4 tool updates
- Changed
get_lead_search5 fields changed- added
Output schema / properties / results / items / properties / contactRouteAdded value: +{ + "additionalProperties": true, + "type": "object" +} - added
Output schema / properties / results / items / properties / criteriaAdded value: +{ + "items": { + "additionalProperties": true, + "type": "object" + }, + "type": "array" +} - added
Output schema / properties / results / items / properties / prospectStatusAdded value: +{ + "enum": [ + "qualified", + "possible" + ] +} - added
Output schema / properties / results / items / properties / whyMatchAdded value: +{ + "items": { + "type": "string" + }, + "type": "array" +} - changed
Output schema / properties / results / items / requiredPrevious value: -[ - "name" -]New value: +[ + "name", + "prospectStatus", + "whyMatch", + "criteria", + "contactRoute" +]
- Changed
research_businesses5 fields changed- added
Output schema / properties / results / items / properties / contactRouteAdded value: +{ + "additionalProperties": true, + "type": "object" +} - added
Output schema / properties / results / items / properties / criteriaAdded value: +{ + "items": { + "additionalProperties": true, + "type": "object" + }, + "type": "array" +} - added
Output schema / properties / results / items / properties / prospectStatusAdded value: +{ + "enum": [ + "qualified", + "possible" + ] +} - added
Output schema / properties / results / items / properties / whyMatchAdded value: +{ + "items": { + "type": "string" + }, + "type": "array" +} - changed
Output schema / properties / results / items / requiredPrevious value: -[ - "name" -]New value: +[ + "name", + "prospectStatus", + "whyMatch", + "criteria", + "contactRoute" +]
- Changed
sandbox_businesses5 fields changed- added
Output schema / properties / results / items / properties / contactRouteAdded value: +{ + "additionalProperties": true, + "type": "object" +} - added
Output schema / properties / results / items / properties / criteriaAdded value: +{ + "items": { + "additionalProperties": true, + "type": "object" + }, + "type": "array" +} - added
Output schema / properties / results / items / properties / prospectStatusAdded value: +{ + "enum": [ + "qualified", + "possible" + ] +} - added
Output schema / properties / results / items / properties / whyMatchAdded value: +{ + "items": { + "type": "string" + }, + "type": "array" +} - changed
Output schema / properties / results / items / requiredPrevious value: -[ - "name" -]New value: +[ + "name", + "prospectStatus", + "whyMatch", + "criteria", + "contactRoute" +]
- Changed
search_businesses5 fields changed- added
Output schema / properties / results / items / properties / contactRouteAdded value: +{ + "additionalProperties": true, + "type": "object" +} - added
Output schema / properties / results / items / properties / criteriaAdded value: +{ + "items": { + "additionalProperties": true, + "type": "object" + }, + "type": "array" +} - added
Output schema / properties / results / items / properties / prospectStatusAdded value: +{ + "enum": [ + "qualified", + "possible" + ] +} - added
Output schema / properties / results / items / properties / whyMatchAdded value: +{ + "items": { + "type": "string" + }, + "type": "array" +} - changed
Output schema / properties / results / items / requiredPrevious value: -[ - "name" -]New value: +[ + "name", + "prospectStatus", + "whyMatch", + "criteria", + "contactRoute" +]
6 tool updates
- Added
cancel_lead_search - Changed
get_lead_search2 fields changed- added
Output schema / properties / progressAdded value: +{ + "additionalProperties": true, + "type": "object" +} - changed
Output schema / properties / status / enumPrevious value: -[ - "queued", - "running", - "completed", - "failed" -]New value: +[ + "queued", + "running", + "completed", + "failed", + "canceled" +]
- Changed
refine_lead_search3 fields changed- added
Output schema / properties / cancelUrlAdded value: +{ + "type": "string" +} - changed
Output schema / properties / status / enumPrevious value: -[ - "queued", - "running", - "completed", - "failed" -]New value: +[ + "queued", + "running", + "completed", + "failed", + "canceled" +] - changed
Output schema / requiredPrevious value: -[ - "id", - "status", - "jobToken", - "statusUrl", - "exportUrl", - "retryUrl", - "expiresInSeconds" -]New value: +[ + "id", + "status", + "statusUrl", + "exportUrl", + "retryUrl", + "cancelUrl", + "expiresInSeconds" +]
- Changed
retry_lead_search3 fields changed- added
Output schema / properties / cancelUrlAdded value: +{ + "type": "string" +} - changed
Output schema / properties / status / enumPrevious value: -[ - "queued", - "running", - "completed", - "failed" -]New value: +[ + "queued", + "running", + "completed", + "failed", + "canceled" +] - changed
Output schema / requiredPrevious value: -[ - "id", - "status", - "jobToken", - "statusUrl", - "exportUrl", - "retryUrl", - "expiresInSeconds" -]New value: +[ + "id", + "status", + "statusUrl", + "exportUrl", + "retryUrl", + "cancelUrl", + "expiresInSeconds" +]
- Added
sandbox_businesses - Changed
start_lead_search4 fields changed- added
Input schema / properties / idempotencyKeyAdded value: +{ + "description": "Stable key for safely retrying the same job creation request.", + "maxLength": 128, + "minLength": 8, + "type": "string" +} - added
Output schema / properties / cancelUrlAdded value: +{ + "type": "string" +} - changed
Output schema / properties / status / enumPrevious value: -[ - "queued", - "running", - "completed", - "failed" -]New value: +[ + "queued", + "running", + "completed", + "failed", + "canceled" +] - changed
Output schema / requiredPrevious value: -[ - "id", - "status", - "jobToken", - "statusUrl", - "exportUrl", - "retryUrl", - "expiresInSeconds" -]New value: +[ + "id", + "status", + "statusUrl", + "exportUrl", + "retryUrl", + "cancelUrl", + "expiresInSeconds" +]
3 tool updates
- Changed
refine_lead_search2 fields changed- added
Output schema / properties / retryUrlAdded value: +{ + "type": "string" +} - changed
Output schema / requiredPrevious value: -[ - "id", - "status", - "jobToken", - "statusUrl", - "exportUrl", - "expiresInSeconds" -]New value: +[ + "id", + "status", + "jobToken", + "statusUrl", + "exportUrl", + "retryUrl", + "expiresInSeconds" +]
- Added
retry_lead_search - Changed
start_lead_search2 fields changed- added
Output schema / properties / retryUrlAdded value: +{ + "type": "string" +} - changed
Output schema / requiredPrevious value: -[ - "id", - "status", - "jobToken", - "statusUrl", - "exportUrl", - "expiresInSeconds" -]New value: +[ + "id", + "status", + "jobToken", + "statusUrl", + "exportUrl", + "retryUrl", + "expiresInSeconds" +]
6 tool updates
- Changed
explain_crawdar1 field changed- changed
Output schema / (root)Previous value: -nullNew value: +{ + "additionalProperties": false, + "properties": { + "guidance": { + "items": { + "type": "string" + }, + "type": "array" + }, + "interfaces": { + "additionalProperties": { + "type": "string" + }, + "type": "object" + }, + "resultLanes": { + "additionalProperties": { + "type": "string" + }, + "type": "object" + } + }, + "required": [ + "resultLanes", + "guidance", + "interfaces" + ], + "type": "object" +}
- Added
get_lead_search - Added
refine_lead_search - Added
research_businesses - Changed
search_businesses7 fields changed- added
Input schema / properties / includeDiagnosticsAdded value: +{ + "default": true, + "description": "Include source status and explained exclusions.", + "type": "boolean" +} - added
Input schema / properties / limitAdded value: +{ + "default": 10, + "description": "Maximum businesses in this response page.", + "maximum": 50, + "minimum": 1, + "type": "integer" +} - added
Input schema / properties / offsetAdded value: +{ + "default": 0, + "description": "Zero-based result offset for this response page.", + "minimum": 0, + "type": "integer" +} - added
Input schema / properties / outputAdded value: +{ + "default": "compact", + "description": "Compact minimizes tokens. Full preserves every returned field.", + "enum": [ + "compact", + "full" + ] +} - changed
Input schema / properties / qualifier / descriptionPrevious value: -"Optional public-evidence requirements."New value: +"Optional required signals and exclusions that can be checked in public evidence." - changed
Input schema / properties / target / descriptionPrevious value: -"Business type or plain-language target."New value: +"Business type or concise target." - changed
Output schema / (root)Previous value: -nullNew value: +{ + "additionalProperties": true, + "properties": { + "diagnostics": { + "additionalProperties": true, + "type": "object" + }, + "durationMs": { + "type": "integer" + }, + "hasMore": { + "type": "boolean" + }, + "limit": { + "type": "integer" + }, + "nextOffset": { + "type": [ + "integer", + "null" + ] + }, + "offset": { + "type": "integer" + }, + "remainingFreeSearches": { + "type": "integer" + }, + "requestId": { + "type": "string" + }, + "resultCount": { + "type": "integer" + }, + "results": { + "items": { + "additionalProperties": true, + "properties": { + "city": { + "type": "string" + }, + "confidence": { + "type": "number" + }, + "email": { + "type": "string" + }, + "entityConfidence": { + "type": "number" + }, + "evidence": { + "items": { + "additionalProperties": true, + "properties": { + "kind": { + "type": "string" + }, + "label": { + "type": "string" + }, + "url": { + "type": "string" + } + }, + "type": "object" + }, + "type": "array" + }, + "evidenceQuality": { + "enum": [ + "strong", + "moderate", + "weak" + ] + }, + "fitStatus": { + "enum": [ + "verified", + "likely" + ] + }, + "name": { + "type": "string" + }, + "phone": { + "type": "string" + }, + "qualificationChecks": { + "items": { + "additionalProperties": true, + "type": "object" + }, + "type": "array" + }, + "qualificationConfidence": { + "type": "number" + }, + "sourceUrls": { + "items": { + "type": "string" + }, + "type": "array" + }, + "website": { + "type": "string" + }, + "websiteUrl": { + "type": "string" + } + }, + "required": [ + "name" + ], + "type": "object" + }, + "type": "array" + }, + "returnedCount": { + "type": "integer" + }, + "schemaVersion": { + "type": "string" + }, + "searchedSources": { + "items": { + "type": "string" + }, + "type": "array" + }, + "warnings": { + "items": { + "type": "string" + }, + "type": "array" + } + }, + "required": [ + "schemaVersion", + "requestId", + "resultCount", + "returnedCount", + "offset", + "limit", + "hasMore", + "results", + "searchedSources", + "warnings" + ], + "type": "object" +}
- Added
start_lead_search
2 tool updates
- First observed
explain_crawdar - First observed
search_businesses
Related MCP Connectors
Web research for agents: quality-scored Google search, webpage extraction, and deep research.
Web search, fetch, extract, and research for AI agents. Markdown output + AI-synthesized answers.
Source-traced evidence research for AI agents. We organise the evidence; you decide.
Compact, citation-verifiable public web context for AI agents, paid per use with x402.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceEnables agents to search SEC filings, earnings transcripts, and EU regulations with ready-to-cite evidence, including exact passages and source links.Apache 2.0
- FlicenseNot gradedqualityCmaintenanceEnables AI assistants to perform institutional-grade research by retrieving and validating company, financial, industry, news, litigation, and funding data, then generating cited reports in Markdown, HTML, or PDF.-
- AlicenseNot gradedqualityCmaintenanceEnables AI chat clients to perform market research and competitive intelligence by gathering company overviews, competitor lists, product portfolios, pricing snapshots, and recent news via live Tavily search.MIT
- AlicenseAqualityAmaintenanceEvidence-backed web research for AI agents. Real-time search with cited claims, confidence scores, and compare mode showing raw LLM hallucination vs evidence-backed answers.520Apache 2.0