Search recorded signals and retain source/time coverage. Save custom detector definitions with library.signal_type.save.v2 in content, bind exact Library versions to campaigns or scouts, and submit sourced findings with signals.observations.create.v2. Show signals.monitoring.estimate.v2 cadence scenarios and disclose unavailable pricing before paid monitoring changes. Feedback updates workspace state. Inspect scout configuration before create/update/delete; a scout can start downstream monitoring and paid provider work. Read discoveries and exact evidence without inferring collection completeness.
Create an industry scout
industry.scouts.create.v2
Use when: The user approved a market monitor with Library Signal Type IDs and a defined scope.
Avoid when: The signal types have not been resolved from the Library.
Effects: Creates a workspace monitor and may start provider collection and credit usage.
Cost: No gateway rate is configured. Check the Core workflow preview/quote for downstream charges and final settlement. Gateway rate code: none; downstream billing may apply.
Access: actions:execute. Approval: exact_scope_single_action. A stable operation UUID is required.
Keep the same operation and operation_id when retrying identical work. Reconcile an uncertain result before new work; never replay an old V1 write under a new V2 ID.
Check status, execution_state, error_code, output and evidence/resource references. Queued work is not complete: poll jobs.status.get.v2 in domain.workspace.v2. For read-back verification require read_back_verified=true where returned; reconcile failures without creating another object.
Invocation example using fictional fixtures
{
"tool": "domain.signals.v2",
"arguments": {
"params": {
"action": "invoke",
"operation": "industry.scouts.create.v2",
"arguments": {
"signal_type_ids": [
"00000000-0000-4000-8000-000000000001"
]
},
"operation_id": "00000000-0000-4000-8000-000000000003"
}
},
"notice": "Fictional fixture IDs and example text. Resolve real IDs, use returned preview tokens and approve exact side effects before execution. Input validation is not proof of provider readiness or a successful business outcome."
}
Use when: The user explicitly approved permanent removal of an exact scout and its discoveries.
Avoid when: The user only wants to stop collection; update status to paused instead.
Effects: Permanently removes the scout and its discoveries. Linked accounts remain.
Cost: No gateway rate is configured. Check the Core workflow preview/quote for downstream charges and final settlement. Gateway rate code: none; downstream billing may apply.
Access: actions:execute. Approval: exact_scope_single_action. A stable operation UUID is required.
Keep the same operation and operation_id when retrying identical work. Reconcile an uncertain result before new work; never replay an old V1 write under a new V2 ID.
Check status, execution_state, error_code, output and evidence/resource references. Queued work is not complete: poll jobs.status.get.v2 in domain.workspace.v2. For read-back verification require read_back_verified=true where returned; reconcile failures without creating another object.
Invocation example using fictional fixtures
{
"tool": "domain.signals.v2",
"arguments": {
"params": {
"action": "invoke",
"operation": "industry.scouts.delete.v2",
"arguments": {
"scout_id": "00000000-0000-4000-8000-000000000001"
},
"operation_id": "00000000-0000-4000-8000-000000000003"
}
},
"notice": "Fictional fixture IDs and example text. Resolve real IDs, use returned preview tokens and approve exact side effects before execution. Input validation is not proof of provider readiness or a successful business outcome."
}
Use when: Read one scout's exact signal types, scope, cadence, threshold, and status.
Avoid when: You have not resolved its scout_id; list scouts first.
Effects: Reads current workspace state.
Cost: No gateway credit charge; reads saved workspace data without starting paid provider work. Gateway rate code: none; downstream billing may apply.
Access: accounts:read. Approval: operation authorization. Reads do not need an operation UUID.
Keep the same operation and operation_id when retrying identical work. Reconcile an uncertain result before new work; never replay an old V1 write under a new V2 ID.
Check status, execution_state, error_code, output and evidence/resource references. Queued work is not complete: poll jobs.status.get.v2 in domain.workspace.v2. For read-back verification require read_back_verified=true where returned; reconcile failures without creating another object.
Invocation example using fictional fixtures
{
"tool": "domain.signals.v2",
"arguments": {
"params": {
"action": "invoke",
"operation": "industry.scouts.get.v2",
"arguments": {
"scout_id": "00000000-0000-4000-8000-000000000001"
},
"operation_id": "00000000-0000-4000-8000-000000000003"
}
},
"notice": "Fictional fixture IDs and example text. Resolve real IDs, use returned preview tokens and approve exact side effects before execution. Input validation is not proof of provider readiness or a successful business outcome."
}
Input schema: fields, defaults and constraints
{
"additionalProperties": false,
"properties": {
"scout_id": {
"description": "Exact scout UUID returned by a Hivekind search, list, get, preview, or resource call.",
"format": "uuid",
"title": "Scout Id",
"type": "string"
}
},
"required": [
"scout_id"
],
"title": "McpIndustryScoutGetInputV2",
"type": "object"
}
Use when: Find workspace-wide market monitors and their configuration before selecting one.
Avoid when: You need recorded findings; use industry.signals.list.v2.
Effects: Reads current workspace state.
Cost: No gateway credit charge; reads saved workspace data without starting paid provider work. Gateway rate code: none; downstream billing may apply.
Access: accounts:read. Approval: operation authorization. Reads do not need an operation UUID.
Keep the same operation and operation_id when retrying identical work. Reconcile an uncertain result before new work; never replay an old V1 write under a new V2 ID.
Check status, execution_state, error_code, output and evidence/resource references. Queued work is not complete: poll jobs.status.get.v2 in domain.workspace.v2. For read-back verification require read_back_verified=true where returned; reconcile failures without creating another object.
Invocation example using fictional fixtures
{
"tool": "domain.signals.v2",
"arguments": {
"params": {
"action": "invoke",
"operation": "industry.scouts.list.v2",
"arguments": {},
"operation_id": "00000000-0000-4000-8000-000000000003"
}
},
"notice": "Fictional fixture IDs and example text. Resolve real IDs, use returned preview tokens and approve exact side effects before execution. Input validation is not proof of provider readiness or a successful business outcome."
}
Use when: The user approved changing an exact scout, including its cadence, types, threshold, or active/paused status.
Avoid when: You have not read the current scout or resolved its ID.
Effects: Changes the live monitor; resuming may start provider collection and credit usage.
Cost: No gateway rate is configured. Check the Core workflow preview/quote for downstream charges and final settlement. Gateway rate code: none; downstream billing may apply.
Access: actions:execute. Approval: exact_scope_single_action. A stable operation UUID is required.
Keep the same operation and operation_id when retrying identical work. Reconcile an uncertain result before new work; never replay an old V1 write under a new V2 ID.
Check status, execution_state, error_code, output and evidence/resource references. Queued work is not complete: poll jobs.status.get.v2 in domain.workspace.v2. For read-back verification require read_back_verified=true where returned; reconcile failures without creating another object.
Invocation example using fictional fixtures
{
"tool": "domain.signals.v2",
"arguments": {
"params": {
"action": "invoke",
"operation": "industry.scouts.update.v2",
"arguments": {
"scout_id": "00000000-0000-4000-8000-000000000001"
},
"operation_id": "00000000-0000-4000-8000-000000000003"
}
},
"notice": "Fictional fixture IDs and example text. Resolve real IDs, use returned preview tokens and approve exact side effects before execution. Input validation is not proof of provider readiness or a successful business outcome."
}
Use when: Read one discovery with its company, score, account resolution, source evidence, and outreach angle.
Avoid when: You have not resolved its discovery_id; list discoveries first.
Effects: Reads current workspace state.
Cost: No gateway credit charge; reads saved workspace data without starting paid provider work. Gateway rate code: none; downstream billing may apply.
Access: accounts:read. Approval: operation authorization. Reads do not need an operation UUID.
Keep the same operation and operation_id when retrying identical work. Reconcile an uncertain result before new work; never replay an old V1 write under a new V2 ID.
Check status, execution_state, error_code, output and evidence/resource references. Queued work is not complete: poll jobs.status.get.v2 in domain.workspace.v2. For read-back verification require read_back_verified=true where returned; reconcile failures without creating another object.
Invocation example using fictional fixtures
{
"tool": "domain.signals.v2",
"arguments": {
"params": {
"action": "invoke",
"operation": "industry.signals.get.v2",
"arguments": {
"discovery_id": "00000000-0000-4000-8000-000000000001"
},
"operation_id": "00000000-0000-4000-8000-000000000003"
}
},
"notice": "Fictional fixture IDs and example text. Resolve real IDs, use returned preview tokens and approve exact side effects before execution. Input validation is not proof of provider readiness or a successful business outcome."
}
Input schema: fields, defaults and constraints
{
"additionalProperties": false,
"properties": {
"discovery_id": {
"description": "Exact discovery UUID returned by a Hivekind search, list, get, preview, or resource call.",
"format": "uuid",
"title": "Discovery Id",
"type": "string"
}
},
"required": [
"discovery_id"
],
"title": "McpIndustrySignalGetInputV2",
"type": "object"
}
Use when: Review companies and signals found by one scout or across the workspace.
Avoid when: You need monitor configuration; list or get the scout instead.
Effects: Reads current workspace state.
Cost: No gateway credit charge; reads saved workspace data without starting paid provider work. Gateway rate code: none; downstream billing may apply.
Access: accounts:read. Approval: operation authorization. Reads do not need an operation UUID.
Keep the same operation and operation_id when retrying identical work. Reconcile an uncertain result before new work; never replay an old V1 write under a new V2 ID.
Check status, execution_state, error_code, output and evidence/resource references. Queued work is not complete: poll jobs.status.get.v2 in domain.workspace.v2. For read-back verification require read_back_verified=true where returned; reconcile failures without creating another object.
Invocation example using fictional fixtures
{
"tool": "domain.signals.v2",
"arguments": {
"params": {
"action": "invoke",
"operation": "industry.signals.list.v2",
"arguments": {},
"operation_id": "00000000-0000-4000-8000-000000000003"
}
},
"notice": "Fictional fixture IDs and example text. Resolve real IDs, use returned preview tokens and approve exact side effects before execution. Input validation is not proof of provider readiness or a successful business outcome."
}
Input schema: fields, defaults and constraints
{
"additionalProperties": false,
"properties": {
"scout_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Limit results to one scout; omit for all workspace scouts.",
"title": "Scout Id"
},
"limit": {
"default": 50,
"description": "Maximum number of records to return in this page.",
"maximum": 100,
"minimum": 1,
"title": "Limit",
"type": "integer"
}
},
"title": "McpIndustrySignalsListInputV2",
"type": "object"
}
Effects: Writes signal feedback. Does not send mail.
Cost: No gateway rate is configured. Check the Core workflow preview/quote for downstream charges and final settlement. Gateway rate code: none; downstream billing may apply.
Access: actions:execute. Approval: exact_scope_single_action. A stable operation UUID is required.
Keep the same operation and operation_id when retrying identical work. Reconcile an uncertain result before new work; never replay an old V1 write under a new V2 ID.
Check status, execution_state, error_code, output and evidence/resource references. Queued work is not complete: poll jobs.status.get.v2 in domain.workspace.v2. For read-back verification require read_back_verified=true where returned; reconcile failures without creating another object.
Invocation example using fictional fixtures
{
"tool": "domain.signals.v2",
"arguments": {
"params": {
"action": "invoke",
"operation": "signals.feedback.set.v2",
"arguments": {
"event_id": "00000000-0000-4000-8000-000000000001",
"verdict": "useful"
},
"operation_id": "00000000-0000-4000-8000-000000000003"
}
},
"notice": "Fictional fixture IDs and example text. Resolve real IDs, use returned preview tokens and approve exact side effects before execution. Input validation is not proof of provider readiness or a successful business outcome."
}
Input schema: fields, defaults and constraints
{
"additionalProperties": false,
"properties": {
"action_proposal_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional. Hivekind fills this from the MCP consent grant.",
"title": "Action Proposal Id"
},
"event_id": {
"description": "Exact event UUID returned by a Hivekind search, list, get, preview, or resource call.",
"format": "uuid",
"title": "Event Id",
"type": "string"
},
"verdict": {
"description": "Verdict used by the public signals feedback set input v2 operation.",
"enum": [
"useful",
"not_useful"
],
"title": "Verdict",
"type": "string"
},
"reason": {
"anyOf": [
{
"maxLength": 2000,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Reason used by the public signals feedback set input v2 operation.",
"title": "Reason"
}
},
"required": [
"event_id",
"verdict"
],
"title": "McpMcpPublicSignalsFeedbackSetInputV2",
"type": "object"
}
Use when: Compare credit upper bounds and execution volumes for hourly, daily, every three days, weekly, or fortnightly campaign and industry-scout monitoring before creating or editing it.
Avoid when: You want to activate monitors. A projection is not authorization to spend credits.
Effects: Reads selected Library definitions, audience size, and effective rate cards. No provider work or debit. Missing pricing is unavailable, never zero.
Cost: No gateway credit charge; reads saved workspace data without starting paid provider work. Gateway rate code: none; downstream billing may apply.
Access: accounts:read. Approval: operation authorization. Reads do not need an operation UUID.
Keep the same operation and operation_id when retrying identical work. Reconcile an uncertain result before new work; never replay an old V1 write under a new V2 ID.
Check status, execution_state, error_code, output and evidence/resource references. Queued work is not complete: poll jobs.status.get.v2 in domain.workspace.v2. For read-back verification require read_back_verified=true where returned; reconcile failures without creating another object.
Invocation example using fictional fixtures
{
"tool": "domain.signals.v2",
"arguments": {
"params": {
"action": "invoke",
"operation": "signals.monitoring.estimate.v2",
"arguments": {
"source_kind": "account_monitor",
"account_count": 20,
"signal_type_ids": [
"00000000-0000-4000-8000-000000000003"
],
"cadence": "weekly",
"horizon_days": 30
},
"operation_id": "00000000-0000-4000-8000-000000000003"
}
},
"notice": "Fictional fixture IDs and example text. Resolve real IDs, use returned preview tokens and approve exact side effects before execution. Input validation is not proof of provider readiness or a successful business outcome."
}
Input schema: fields, defaults and constraints
{
"additionalProperties": false,
"properties": {
"source_kind": {
"default": "account_monitor",
"description": "Source kind used by the signal monitoring estimate input v2 operation.",
"enum": [
"account_monitor",
"industry_scout"
],
"title": "Source Kind",
"type": "string"
},
"campaign_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Exact campaign UUID returned by a Hivekind search, list, get, preview, or resource call.",
"title": "Campaign Id"
},
"scout_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Exact scout UUID returned by a Hivekind search, list, get, preview, or resource call.",
"title": "Scout Id"
},
"signal_type_ids": {
"anyOf": [
{
"items": {
"format": "uuid",
"type": "string"
},
"maxItems": 20,
"minItems": 1,
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Exact signal type UUIDs returned by a Hivekind search, list, get, preview, or resource call.",
"title": "Signal Type Ids"
},
"account_count": {
"anyOf": [
{
"maximum": 100000,
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Account count used by the signal monitoring estimate input v2 operation.",
"title": "Account Count"
},
"cadence": {
"default": "weekly",
"description": "Cadence used by the signal monitoring estimate input v2 operation.",
"enum": [
"hourly",
"daily",
"every_3_days",
"weekly",
"every_two_weeks"
],
"title": "Cadence",
"type": "string"
},
"horizon_days": {
"default": 30,
"description": "Horizon days used by the signal monitoring estimate input v2 operation.",
"maximum": 366,
"minimum": 1,
"title": "Horizon Days",
"type": "integer"
}
},
"title": "McpSignalMonitoringEstimateInputV2",
"type": "object"
}
Use when: Add custom evidence discovered by the user or MCP to one campaign account or industry scout, using an already-bound Library Signal Type.
Avoid when: You need a new detector definition; save it in Library and bind it first. Never invent a qualification score or submit unsourced evidence.
Effects: Saves a canonical signal or industry discovery in Needs review, with source URLs, date, and submitter provenance. Does not queue scoring, enrichment, or sends.
Cost: No gateway rate is configured. Check the Core workflow preview/quote for downstream charges and final settlement. Gateway rate code: none; downstream billing may apply.
Access: actions:execute. Approval: exact_scope_single_action. A stable operation UUID is required.
Keep the same operation and operation_id when retrying identical work. Reconcile an uncertain result before new work; never replay an old V1 write under a new V2 ID.
Check status, execution_state, error_code, output and evidence/resource references. Queued work is not complete: poll jobs.status.get.v2 in domain.workspace.v2. For read-back verification require read_back_verified=true where returned; reconcile failures without creating another object.
Invocation example using fictional fixtures
{
"tool": "domain.signals.v2",
"arguments": {
"params": {
"action": "invoke",
"operation": "signals.observations.create.v2",
"arguments": {
"campaign_id": "00000000-0000-4000-8000-000000000001",
"account_id": "00000000-0000-4000-8000-000000000002",
"signal_type_id": "00000000-0000-4000-8000-000000000003",
"title": "Example company opens a new office",
"summary": "The company announced a new office in its public newsroom.",
"source_urls": [
"https://example.com/news/new-office"
],
"source_date": "2026-10-26T08:00:00Z"
},
"operation_id": "00000000-0000-4000-8000-000000000003"
}
},
"notice": "Fictional fixture IDs and example text. Resolve real IDs, use returned preview tokens and approve exact side effects before execution. Input validation is not proof of provider readiness or a successful business outcome."
}
Input schema: fields, defaults and constraints
{
"additionalProperties": false,
"properties": {
"campaign_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Exact campaign UUID returned by a Hivekind search, list, get, preview, or resource call.",
"title": "Campaign Id"
},
"scout_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Exact scout UUID returned by a Hivekind search, list, get, preview, or resource call.",
"title": "Scout Id"
},
"account_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Required for campaign evidence; must already belong to that campaign.",
"title": "Account Id"
},
"company_name": {
"anyOf": [
{
"maxLength": 255,
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Company name used by the signal observation create input v2 operation.",
"title": "Company Name"
},
"company_domain": {
"anyOf": [
{
"maxLength": 255,
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Company domain used by the signal observation create input v2 operation.",
"title": "Company Domain"
},
"signal_type_id": {
"description": "Exact signal type UUID returned by a Hivekind search, list, get, preview, or resource call.",
"format": "uuid",
"title": "Signal Type Id",
"type": "string"
},
"title": {
"description": "Title used by the signal observation create input v2 operation.",
"maxLength": 500,
"minLength": 1,
"title": "Title",
"type": "string"
},
"summary": {
"description": "Summary used by the signal observation create input v2 operation.",
"maxLength": 8000,
"minLength": 1,
"title": "Summary",
"type": "string"
},
"source_urls": {
"description": "Source urls used by the signal observation create input v2 operation.",
"items": {
"format": "uri",
"maxLength": 2083,
"minLength": 1,
"type": "string"
},
"maxItems": 20,
"minItems": 1,
"title": "Source Urls",
"type": "array"
},
"source_date": {
"description": "Source date used by the signal observation create input v2 operation.",
"format": "date-time",
"title": "Source Date",
"type": "string"
},
"action_proposal_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional. Hivekind fills this from the MCP consent grant.",
"title": "Action Proposal Id"
}
},
"required": [
"signal_type_id",
"title",
"summary",
"source_urls",
"source_date"
],
"title": "McpMcpSignalObservationCreateInputV2",
"type": "object"
}
Use when: You need bounded, timestamped why-now observations for known accounts or contacts.
Avoid when: You need to define a Library signal type or subscribe to future alerts.
Effects: Returns recorded observations with coverage limits. Read only.
Cost: No gateway credit charge; reads saved workspace data without starting paid provider work. Gateway rate code: none; downstream billing may apply.
Access: accounts:read. Approval: operation authorization. Reads do not need an operation UUID.
Keep the same operation and operation_id when retrying identical work. Reconcile an uncertain result before new work; never replay an old V1 write under a new V2 ID.
Check status, execution_state, error_code, output and evidence/resource references. Queued work is not complete: poll jobs.status.get.v2 in domain.workspace.v2. For read-back verification require read_back_verified=true where returned; reconcile failures without creating another object.
Invocation example using fictional fixtures
{
"tool": "domain.signals.v2",
"arguments": {
"params": {
"action": "invoke",
"operation": "signals.search.v2",
"arguments": {},
"operation_id": "00000000-0000-4000-8000-000000000003"
}
},
"notice": "Fictional fixture IDs and example text. Resolve real IDs, use returned preview tokens and approve exact side effects before execution. Input validation is not proof of provider readiness or a successful business outcome."
}
Input schema: fields, defaults and constraints
{
"additionalProperties": false,
"properties": {
"contact_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Exact contact UUID returned by a Hivekind search, list, get, preview, or resource call.",
"title": "Contact Id"
},
"account_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Exact account UUID returned by a Hivekind search, list, get, preview, or resource call.",
"title": "Account Id"
},
"channel": {
"anyOf": [
{
"maxLength": 64,
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Supported outreach or signal channel. Phone outreach is not supported.",
"title": "Channel"
},
"signal_types": {
"default": [],
"description": "Signal types used by the signals search input v2 operation.",
"items": {
"type": "string"
},
"maxItems": 20,
"title": "Signal Types",
"type": "array"
},
"lookback_days": {
"default": 30,
"description": "Number of calendar days before today to include.",
"maximum": 365,
"minimum": 1,
"title": "Lookback Days",
"type": "integer"
},
"offset": {
"default": 0,
"description": "Pagination offset; reuse observed_until from the first response.",
"maximum": 10000,
"minimum": 0,
"title": "Offset",
"type": "integer"
},
"observed_until": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Fixed UTC observation cutoff for stable pagination; defaults to now.",
"title": "Observed Until"
},
"limit": {
"default": 30,
"description": "Maximum number of records to return in this page.",
"maximum": 100,
"minimum": 1,
"title": "Limit",
"type": "integer"
}
},
"title": "McpSignalsSearchInputV2",
"type": "object"
}