Evidence-backed public business research for agents with compact, pageable output.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Cancel a queued or running search job. Completed and failed jobs remain immutable.
Queued or running job id.
Private token belonging to the job.
The server marks this tool as destructive. Running it may delete or overwrite data on the server or in any account you connected with your headers.
Cancel a queued or running search job. Completed and failed jobs remain immutable.
| Argument | Type | Description |
|---|---|---|
| id* | string | Queued or running job id. |
| jobToken* | string | Private token belonging to the job. |
{
"type": "object",
"required": [
"id",
"jobToken"
],
"properties": {
"id": {
"type": "string",
"maxLength": 36,
"minLength": 36,
"description": "Queued or running job id."
},
"jobToken": {
"type": "string",
"maxLength": 100,
"minLength": 20,
"description": "Private token belonging to the job."
}
},
"additionalProperties": false
}Get result semantics, limits, interface URLs, and safe operating guidance. This tool does not consume a search.
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}Read job status or one cursor-paginated result page. Keep jobToken private and pass nextCursor back unchanged.
| Argument | Type | Description |
|---|---|---|
| id* | string | Job id returned by start_lead_search, refine_lead_search, or retry_lead_search. |
| view | any | Compact minimizes tokens. Full retains detailed evidence fields. |
| limit | integer | Maximum prospects in this result page. |
| cursor | string | Opaque nextCursor from the previous response. |
| jobToken* | string | Private token returned with the job. Do not log or share it. |
{
"type": "object",
"required": [
"id",
"jobToken"
],
"properties": {
"id": {
"type": "string",
"maxLength": 36,
"minLength": 36,
"description": "Job id returned by start_lead_search, refine_lead_search, or retry_lead_search."
},
"view": {
"enum": [
"compact",
"full"
],
"default": "compact",
"description": "Compact minimizes tokens. Full retains detailed evidence fields."
},
"limit": {
"type": "integer",
"default": 10,
"maximum": 50,
"minimum": 1,
"description": "Maximum prospects in this result page."
},
"cursor": {
"type": "string",
"description": "Opaque nextCursor from the previous response."
},
"jobToken": {
"type": "string",
"maxLength": 100,
"minLength": 20,
"description": "Private token returned with the job. Do not log or share it."
}
},
"additionalProperties": false
}Create a new private search job by changing the brief or criteria of a completed job. The original job stays unchanged.
| Argument | Type | Description |
|---|---|---|
| id* | string | Completed source job id returned by an earlier durable search call. |
| brief | string | Replacement natural-language brief for the new job. |
| limit | integer | Maximum prospects retained by the new job. |
| fields | array | Business fields to retain. Website and source evidence remain available for verification. |
| target | string | Replacement business target for the new job. |
| jobToken* | string | Private token belonging to the source job. |
| geography | string | Replacement city, region, country, or Worldwide. |
| qualifier | string | Replacement public requirements and exclusions. |
{
"type": "object",
"required": [
"id",
"jobToken"
],
"properties": {
"id": {
"type": "string",
"maxLength": 36,
"minLength": 36,
"description": "Completed source job id returned by an earlier durable search call."
},
"brief": {
"type": "string",
"maxLength": 500,
"minLength": 8,
"description": "Replacement natural-language brief for the new job."
},
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Maximum prospects retained by the new job."
},
"fields": {
"type": "array",
"items": {
"enum": [
"Website",
"Business email",
"Phone",
"Location",
"Owner type",
"Description",
"Source links"
]
},
"description": "Business fields to retain. Website and source evidence remain available for verification."
},
"target": {
"type": "string",
"maxLength": 220,
"minLength": 3,
"description": "Replacement business target for the new job."
},
"jobToken": {
"type": "string",
"maxLength": 100,
"minLength": 20,
"description": "Private token belonging to the source job."
},
"geography": {
"type": "string",
"maxLength": 140,
"minLength": 2,
"description": "Replacement city, region, country, or Worldwide."
},
"qualifier": {
"type": "string",
"maxLength": 900,
"description": "Replacement public requirements and exclusions."
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| brief* | string | Example: Independent veterinary clinics in Berlin with an active first-party website. Exclude directories and chains. |
| limit | integer | Maximum businesses in this response page. |
| fields | array | Business fields to retain. Website and source evidence remain available for verification. |
| offset | integer | Zero-based result offset for this response page. |
| output | any | Compact minimizes tokens. Full preserves every returned field. |
| geography | string | Optional explicit geography. Use when the brief does not make location clear. |
| includeDiagnostics | boolean | Include source status and explained exclusions. |
{
"type": "object",
"required": [
"brief"
],
"properties": {
"brief": {
"type": "string",
"maxLength": 1200,
"minLength": 8,
"description": "Example: Independent veterinary clinics in Berlin with an active first-party website. Exclude directories and chains."
},
"limit": {
"type": "integer",
"default": 10,
"maximum": 50,
"minimum": 1,
"description": "Maximum businesses in this response page."
},
"fields": {
"type": "array",
"items": {
"enum": [
"Website",
"Business email",
"Phone",
"Location",
"Owner type",
"Description",
"Source links"
]
},
"description": "Business fields to retain. Website and source evidence remain available for verification."
},
"offset": {
"type": "integer",
"default": 0,
"minimum": 0,
"description": "Zero-based result offset for this response page."
},
"output": {
"enum": [
"compact",
"full"
],
"default": "compact",
"description": "Compact minimizes tokens. Full preserves every returned field."
},
"geography": {
"type": "string",
"maxLength": 140,
"minLength": 2,
"description": "Optional explicit geography. Use when the brief does not make location clear."
},
"includeDiagnostics": {
"type": "boolean",
"default": true,
"description": "Include source status and explained exclusions."
}
},
"additionalProperties": false
}Create a replacement job when a prior job failed or exceeded its execution window. The original job stays available for audit.
| Argument | Type | Description |
|---|---|---|
| id* | string | Failed or timed-out source job id. |
| jobToken* | string | Private token belonging to the source job. |
{
"type": "object",
"required": [
"id",
"jobToken"
],
"properties": {
"id": {
"type": "string",
"maxLength": 36,
"minLength": 36,
"description": "Failed or timed-out source job id."
},
"jobToken": {
"type": "string",
"maxLength": 100,
"minLength": 20,
"description": "Private token belonging to the source job."
}
},
"additionalProperties": false
}Return deterministic fictional businesses without consuming provider capacity. Use this to test schemas, clients, and agent loops.
| Argument | Type | Description |
|---|---|---|
| target | string | Fictional business type echoed into deterministic test results. |
| geography | string | Fictional location echoed into deterministic test results. |
{
"type": "object",
"properties": {
"target": {
"type": "string",
"maxLength": 220,
"minLength": 3,
"description": "Fictional business type echoed into deterministic test results."
},
"geography": {
"type": "string",
"maxLength": 140,
"minLength": 2,
"description": "Fictional location echoed into deterministic test results."
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| target | string | |
| website | string | |
| business | string | |
| geography | string | |
| reviewUrls | array | |
| googlePlaceId | string |
{
"type": "object",
"properties": {
"target": {
"type": "string"
},
"website": {
"type": "string"
},
"business": {
"type": "string"
},
"geography": {
"type": "string"
},
"reviewUrls": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 3
},
"googlePlaceId": {
"type": "string"
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Maximum businesses in this response page. |
| fields | array | Business fields to retain. Website and source evidence remain available for verification. |
| offset | integer | Zero-based result offset for this response page. |
| output | any | Compact minimizes tokens. Full preserves every returned field. |
| target* | string | Business type or concise target. |
| geography* | string | City, region, country, or Worldwide. |
| qualifier | string | Optional required signals and exclusions that can be checked in public evidence. |
| includeDiagnostics | boolean | Include source status and explained exclusions. |
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.
| Argument | Type | Description |
|---|---|---|
| brief | string | Natural-language business, geography, required signals, and exclusions. Use this instead of separate target and geography. |
| limit | integer | Maximum accepted prospects retained by the job. |
| fields | array | Business fields to retain. Website and source evidence remain available for verification. |
| target | string | Business type or concise ideal-customer target. Pair with geography when brief is omitted. |
| geography | string | City, region, country, or Worldwide. Required with target when brief is omitted. |
| qualifier | string | Publicly verifiable requirements and exclusions. |
| idempotencyKey | string | Stable key for safely retrying the same job creation request. |
{
"type": "object",
"anyOf": [
{
"required": [
"brief"
]
},
{
"required": [
"target",
"geography"
]
}
],
"properties": {
"brief": {
"type": "string",
"maxLength": 500,
"minLength": 8,
"description": "Natural-language business, geography, required signals, and exclusions. Use this instead of separate target and geography."
},
"limit": {
"type": "integer",
"default": 50,
"maximum": 50,
"minimum": 1,
"description": "Maximum accepted prospects retained by the job."
},
"fields": {
"type": "array",
"items": {
"enum": [
"Website",
"Business email",
"Phone",
"Location",
"Owner type",
"Description",
"Source links"
]
},
"description": "Business fields to retain. Website and source evidence remain available for verification."
},
"target": {
"type": "string",
"maxLength": 220,
"minLength": 3,
"description": "Business type or concise ideal-customer target. Pair with geography when brief is omitted."
},
"geography": {
"type": "string",
"maxLength": 140,
"minLength": 2,
"description": "City, region, country, or Worldwide. Required with target when brief is omitted."
},
"qualifier": {
"type": "string",
"maxLength": 900,
"description": "Publicly verifiable requirements and exclusions."
},
"idempotencyKey": {
"type": "string",
"maxLength": 128,
"minLength": 8,
"description": "Stable key for safely retrying the same job creation request."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"target",
"geography"
],
"properties": {
"limit": {
"type": "integer",
"default": 10,
"maximum": 50,
"minimum": 1,
"description": "Maximum businesses in this response page."
},
"fields": {
"type": "array",
"items": {
"enum": [
"Website",
"Business email",
"Phone",
"Location",
"Owner type",
"Description",
"Source links"
]
},
"description": "Business fields to retain. Website and source evidence remain available for verification."
},
"offset": {
"type": "integer",
"default": 0,
"minimum": 0,
"description": "Zero-based result offset for this response page."
},
"output": {
"enum": [
"compact",
"full"
],
"default": "compact",
"description": "Compact minimizes tokens. Full preserves every returned field."
},
"target": {
"type": "string",
"maxLength": 220,
"minLength": 3,
"description": "Business type or concise target."
},
"geography": {
"type": "string",
"maxLength": 140,
"minLength": 2,
"description": "City, region, country, or Worldwide."
},
"qualifier": {
"type": "string",
"maxLength": 900,
"description": "Optional required signals and exclusions that can be checked in public evidence."
},
"includeDiagnostics": {
"type": "boolean",
"default": true,
"description": "Include source status and explained exclusions."
}
},
"additionalProperties": false
}