Search recorded signals and retain source/time coverage. 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: 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"
}