StackFast FractWin Expert Brain

Talent Scout Discover Companies By Campaign

talent_scout_discover_companies_by_campaign

Read-onlyIdempotent

Preview the account owner's saved business-list campaign. Returns public company websites, employee-count confidence, source receipts, and next actions for manual review. Read-only by default: it does not persist companies unless persist_results is explicitly true and never scrapes LinkedIn.

Input Schema

TableJSON Schema

Name	Required	Description
`limit`	No
`sources`	No
`tenant_id`	No
`campaign_id`	No
`sqlite_path`	No	Optional local SQLite path for BYOC receipts; hosted cloud calls fail closed instead of reading local files.
`campaign_name`	No
`auth_token_key`	No	Optional wallet/env key name for the tenant Turso auth token. Never pass a raw token.
`persist_results`	No	When true, persist discovered company records to the Talent Scout campaign store. Defaults false so hosted MCP discovery remains a read-only preview for human review.
`database_url_key`	No	Optional wallet/env key name for the tenant Turso database URL. Never pass a raw URL or secret.
`allow_live_firecrawl`	No	Backward-compatible refresh flag; Firecrawl is only a fallback/search or downstream extraction provider, not the Stage 1 radar.
`tenant_database_type`	No	Optional physical database routing mode. Omit for the default internal StackFast DB; use sovereign_cloud only with wallet-resolved tenant DB credentials.
`allow_live_google_places`	No	Refresh public business website leads through the configured directory provider and distance check. Websites are required before downstream enrichment. Set false only for an explicit no-network dry run.

Output Schema

TableJSON Schema

Name	Required	Description	Default
`result`	No
`public_tool`	Yes
`drafts_never_sends`	No
`no_autonomous_outbound`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedJul 8, 2026

changedInput schema / properties / persist_results / description

Previous value: -"When true, persist discovered company leads to the Talent Scout campaign store. Defaults false so hosted MCP discovery remains a read-only preview for human review."New value: +"When true, persist discovered company records to the Talent Scout campaign store. Defaults false so hosted MCP discovery remains a read-only preview for human review."

Changed2 schema fields changedJul 1, 2026

changedInput schema / properties / allow_live_firecrawl / description

Previous value: -"Backward-compatible live flag; Firecrawl is only a fallback/search or downstream extraction provider, not the Stage 1 radar."New value: +"Backward-compatible refresh flag; Firecrawl is only a fallback/search or downstream extraction provider, not the Stage 1 radar."

changedInput schema / properties / allow_live_google_places / description

Previous value: -"Run the Blue Ocean Stage 1 radar through Google Places + Distance Matrix. Websites are required before downstream enrichment. Set false only for an explicit no-network dry run."New value: +"Refresh public business website leads through the configured directory provider and distance check. Websites are required before downstream enrichment. Set false only for an explicit no-network dry run."

Changed1 schema field changedJul 1, 2026

addedInput schema / properties / persist_results

Added value: +{
+  "default": false,
+  "description": "When true, persist discovered company leads to the Talent Scout campaign store. Defaults false so hosted MCP discovery remains a read-only preview for human review.",
+  "type": "boolean"
+}

Changed2 schema fields changedJun 26, 2026

changedInput schema / properties / allow_live_google_places / default
```
Previous value: -falseNew value: +true
```

changedInput schema / properties / allow_live_google_places / description

Previous value: -"Run the Blue Ocean Stage 1 radar through Google Places + Distance Matrix. Websites are required before downstream enrichment."New value: +"Run the Blue Ocean Stage 1 radar through Google Places + Distance Matrix. Websites are required before downstream enrichment. Set false only for an explicit no-network dry run."

Changed2 schema fields changedJun 25, 2026

addedInput schema / properties / allow_live_firecrawl / description

Added value: +"Backward-compatible live flag; Firecrawl is only a fallback/search or downstream extraction provider, not the Stage 1 radar."

addedInput schema / properties / allow_live_google_places

Added value: +{
+  "default": false,
+  "description": "Run the Blue Ocean Stage 1 radar through Google Places + Distance Matrix. Websites are required before downstream enrichment.",
+  "type": "boolean"
+}

Changed4 schema fields changedJun 25, 2026

addedInput schema / properties / auth_token_key

Added value: +{
+  "description": "Optional wallet/env key name for the tenant Turso auth token. Never pass a raw token.",
+  "type": "string"
+}

addedInput schema / properties / database_url_key

Added value: +{
+  "description": "Optional wallet/env key name for the tenant Turso database URL. Never pass a raw URL or secret.",
+  "type": "string"
+}

addedInput schema / properties / sqlite_path

Added value: +{
+  "description": "Optional local SQLite path for BYOC receipts; hosted cloud calls fail closed instead of reading local files.",
+  "type": "string"
+}

addedInput schema / properties / tenant_database_type

Added value: +{
+  "description": "Optional physical database routing mode. Omit for the default internal StackFast DB; use sovereign_cloud only with wallet-resolved tenant DB credentials.",
+  "enum": [
+    "internal",
+    "sovereign_cloud",
+    "byoc"
+  ],
+  "type": "string"
+}

AddedJun 22, 2026

TDQS

A4.2/5.0

Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Although readOnlyHint is already present, the description adds the crucial nuance that persistence can happen when persist_results is explicitly true, and it states a hard limitation ('never scrapes LinkedIn'). This enriches the annotation without contradicting it.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Three tight sentences with no filler: purpose, outputs, then behavioral caveats. All sentences carry information an agent needs before invocation.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The safety and output context are well covered, and an output schema exists, but the description leaves campaign selection ambiguous despite zero required parameters. A short pointer to which identifier(s) select the saved campaign would make it complete.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is only 58%, and the description largely restates what the schema already says about persist_results without explaining how to identify the campaign (campaign_id vs campaign_name), what sources accepts, or what limit controls. It does not compensate for the undocumented parameters.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Description uses a specific verb ('Preview') plus a distinct resource ('the account owner's saved business-list campaign') and enumerates concrete outputs (websites, employee-count confidence, source receipts, next actions). The campaign scope clearly separates it from siblings like talent_scout_discover_local_companies.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description establishes a clear intended context: use this as a read-only preview to feed manual review. It does not explicitly name alternatives or state when-not-to-use cases, but the manual-review framing and default read-only behavior give an agent adequate direction.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All StackFast FractWin Expert Brain tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?