Now talk to Hivekind in Claude or ChatGPT. Your priority accounts, GTM context, right where you work.

Signals

domain.signals.v2

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."
}
Input schema: fields, defaults and constraints
{
  "$defs": {
    "IndustryScoutGeographyV2": {
      "additionalProperties": false,
      "properties": {
        "kind": {
          "enum": [
            "continent",
            "country",
            "region"
          ],
          "title": "Kind",
          "type": "string"
        },
        "code": {
          "maxLength": 64,
          "minLength": 1,
          "title": "Code",
          "type": "string"
        },
        "label": {
          "maxLength": 120,
          "minLength": 1,
          "title": "Label",
          "type": "string"
        }
      },
      "required": [
        "kind",
        "code",
        "label"
      ],
      "title": "IndustryScoutGeographyV2",
      "type": "object"
    },
    "IndustryScoutRuleV2": {
      "additionalProperties": false,
      "properties": {
        "rule": {
          "maxLength": 1000,
          "minLength": 1,
          "title": "Rule",
          "type": "string"
        },
        "weight": {
          "default": 1,
          "minimum": 0,
          "title": "Weight",
          "type": "number"
        }
      },
      "required": [
        "rule"
      ],
      "title": "IndustryScoutRuleV2",
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "signal_type_ids": {
      "description": "Library Signal Type IDs to monitor.",
      "items": {
        "format": "uuid",
        "type": "string"
      },
      "minItems": 1,
      "title": "Signal Type Ids",
      "type": "array"
    },
    "name": {
      "anyOf": [
        {
          "maxLength": 160,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Human-readable name for the record.",
      "title": "Name"
    },
    "industry": {
      "anyOf": [
        {
          "maxLength": 200,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Industry used by the industry scout create input v2 operation.",
      "title": "Industry"
    },
    "geography": {
      "default": [],
      "description": "Geography used by the industry scout create input v2 operation.",
      "items": {
        "$ref": "#/$defs/IndustryScoutGeographyV2"
      },
      "title": "Geography",
      "type": "array"
    },
    "cadence": {
      "anyOf": [
        {
          "enum": [
            "hourly",
            "daily",
            "every_3_days",
            "weekly",
            "every_two_weeks"
          ],
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Cadence used by the industry scout create input v2 operation.",
      "title": "Cadence"
    },
    "auto_enrich_contacts": {
      "default": true,
      "description": "Auto enrich contacts used by the industry scout create input v2 operation.",
      "title": "Auto Enrich Contacts",
      "type": "boolean"
    },
    "trigger_rules": {
      "additionalProperties": {
        "items": {
          "$ref": "#/$defs/IndustryScoutRuleV2"
        },
        "type": "array"
      },
      "description": "Trigger rules used by the industry scout create input v2 operation.",
      "title": "Trigger Rules",
      "type": "object"
    },
    "trigger_threshold": {
      "default": 70,
      "description": "Trigger threshold used by the industry scout create input v2 operation.",
      "maximum": 100,
      "minimum": 0,
      "title": "Trigger Threshold",
      "type": "integer"
    },
    "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_ids"
  ],
  "title": "McpMcpIndustryScoutCreateInputV2",
  "type": "object"
}
Output schema inside the result envelope
{
  "additionalProperties": true,
  "properties": {
    "scout_id": {
      "format": "uuid",
      "title": "Scout Id",
      "type": "string"
    },
    "name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Name"
    },
    "industry": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Industry"
    },
    "status": {
      "title": "Status",
      "type": "string"
    },
    "cadence": {
      "title": "Cadence",
      "type": "string"
    },
    "signal_type_bindings": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Signal Type Bindings",
      "type": "array"
    },
    "geography": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Geography",
      "type": "array"
    },
    "trigger_threshold": {
      "default": 70,
      "title": "Trigger Threshold",
      "type": "integer"
    },
    "discovered_count": {
      "default": 0,
      "title": "Discovered Count",
      "type": "integer"
    }
  },
  "required": [
    "scout_id",
    "status",
    "cadence"
  ],
  "title": "IndustryScoutRecordV2",
  "type": "object"
}

Delete an industry scout

industry.scouts.delete.v2

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."
}
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"
    },
    "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": [
    "scout_id"
  ],
  "title": "McpMcpIndustryScoutDeleteInputV2",
  "type": "object"
}
Output schema inside the result envelope
{
  "properties": {
    "scout_id": {
      "format": "uuid",
      "title": "Scout Id",
      "type": "string"
    },
    "deleted": {
      "title": "Deleted",
      "type": "boolean"
    }
  },
  "required": [
    "scout_id",
    "deleted"
  ],
  "title": "IndustryScoutDeleteResultV2",
  "type": "object"
}

Get an industry scout

industry.scouts.get.v2

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"
}
Output schema inside the result envelope
{
  "additionalProperties": true,
  "properties": {
    "scout_id": {
      "format": "uuid",
      "title": "Scout Id",
      "type": "string"
    },
    "name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Name"
    },
    "industry": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Industry"
    },
    "status": {
      "title": "Status",
      "type": "string"
    },
    "cadence": {
      "title": "Cadence",
      "type": "string"
    },
    "signal_type_bindings": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Signal Type Bindings",
      "type": "array"
    },
    "geography": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Geography",
      "type": "array"
    },
    "trigger_threshold": {
      "default": 70,
      "title": "Trigger Threshold",
      "type": "integer"
    },
    "discovered_count": {
      "default": 0,
      "title": "Discovered Count",
      "type": "integer"
    }
  },
  "required": [
    "scout_id",
    "status",
    "cadence"
  ],
  "title": "IndustryScoutRecordV2",
  "type": "object"
}

List industry scouts

industry.scouts.list.v2

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."
}
Input schema: fields, defaults and constraints
{
  "additionalProperties": false,
  "properties": {},
  "title": "McpIndustryScoutsListInputV2",
  "type": "object"
}
Output schema inside the result envelope
{
  "$defs": {
    "IndustryScoutRecordV2": {
      "additionalProperties": true,
      "properties": {
        "scout_id": {
          "format": "uuid",
          "title": "Scout Id",
          "type": "string"
        },
        "name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Name"
        },
        "industry": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Industry"
        },
        "status": {
          "title": "Status",
          "type": "string"
        },
        "cadence": {
          "title": "Cadence",
          "type": "string"
        },
        "signal_type_bindings": {
          "items": {
            "additionalProperties": true,
            "type": "object"
          },
          "title": "Signal Type Bindings",
          "type": "array"
        },
        "geography": {
          "items": {
            "additionalProperties": true,
            "type": "object"
          },
          "title": "Geography",
          "type": "array"
        },
        "trigger_threshold": {
          "default": 70,
          "title": "Trigger Threshold",
          "type": "integer"
        },
        "discovered_count": {
          "default": 0,
          "title": "Discovered Count",
          "type": "integer"
        }
      },
      "required": [
        "scout_id",
        "status",
        "cadence"
      ],
      "title": "IndustryScoutRecordV2",
      "type": "object"
    }
  },
  "properties": {
    "scouts": {
      "items": {
        "$ref": "#/$defs/IndustryScoutRecordV2"
      },
      "title": "Scouts",
      "type": "array"
    },
    "total": {
      "title": "Total",
      "type": "integer"
    }
  },
  "required": [
    "scouts",
    "total"
  ],
  "title": "IndustryScoutsListResultV2",
  "type": "object"
}

Update or pause an industry scout

industry.scouts.update.v2

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."
}
Input schema: fields, defaults and constraints
{
  "$defs": {
    "IndustryScoutGeographyV2": {
      "additionalProperties": false,
      "properties": {
        "kind": {
          "enum": [
            "continent",
            "country",
            "region"
          ],
          "title": "Kind",
          "type": "string"
        },
        "code": {
          "maxLength": 64,
          "minLength": 1,
          "title": "Code",
          "type": "string"
        },
        "label": {
          "maxLength": 120,
          "minLength": 1,
          "title": "Label",
          "type": "string"
        }
      },
      "required": [
        "kind",
        "code",
        "label"
      ],
      "title": "IndustryScoutGeographyV2",
      "type": "object"
    },
    "IndustryScoutRuleV2": {
      "additionalProperties": false,
      "properties": {
        "rule": {
          "maxLength": 1000,
          "minLength": 1,
          "title": "Rule",
          "type": "string"
        },
        "weight": {
          "default": 1,
          "minimum": 0,
          "title": "Weight",
          "type": "number"
        }
      },
      "required": [
        "rule"
      ],
      "title": "IndustryScoutRuleV2",
      "type": "object"
    }
  },
  "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"
    },
    "name": {
      "anyOf": [
        {
          "maxLength": 160,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Human-readable name for the record.",
      "title": "Name"
    },
    "industry": {
      "anyOf": [
        {
          "maxLength": 200,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Industry used by the industry scout update input v2 operation.",
      "title": "Industry"
    },
    "geography": {
      "anyOf": [
        {
          "items": {
            "$ref": "#/$defs/IndustryScoutGeographyV2"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Geography used by the industry scout update input v2 operation.",
      "title": "Geography"
    },
    "signal_type_ids": {
      "anyOf": [
        {
          "items": {
            "format": "uuid",
            "type": "string"
          },
          "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"
    },
    "cadence": {
      "anyOf": [
        {
          "enum": [
            "hourly",
            "daily",
            "every_3_days",
            "weekly",
            "every_two_weeks"
          ],
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Cadence used by the industry scout update input v2 operation.",
      "title": "Cadence"
    },
    "status": {
      "anyOf": [
        {
          "enum": [
            "active",
            "paused"
          ],
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Status used by the industry scout update input v2 operation.",
      "title": "Status"
    },
    "auto_enrich_contacts": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Auto enrich contacts used by the industry scout update input v2 operation.",
      "title": "Auto Enrich Contacts"
    },
    "trigger_rules": {
      "anyOf": [
        {
          "additionalProperties": {
            "items": {
              "$ref": "#/$defs/IndustryScoutRuleV2"
            },
            "type": "array"
          },
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Trigger rules used by the industry scout update input v2 operation.",
      "title": "Trigger Rules"
    },
    "trigger_threshold": {
      "anyOf": [
        {
          "maximum": 100,
          "minimum": 0,
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Trigger threshold used by the industry scout update input v2 operation.",
      "title": "Trigger Threshold"
    },
    "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": [
    "scout_id"
  ],
  "title": "McpMcpIndustryScoutUpdateInputV2",
  "type": "object"
}
Output schema inside the result envelope
{
  "additionalProperties": true,
  "properties": {
    "scout_id": {
      "format": "uuid",
      "title": "Scout Id",
      "type": "string"
    },
    "name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Name"
    },
    "industry": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Industry"
    },
    "status": {
      "title": "Status",
      "type": "string"
    },
    "cadence": {
      "title": "Cadence",
      "type": "string"
    },
    "signal_type_bindings": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Signal Type Bindings",
      "type": "array"
    },
    "geography": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Geography",
      "type": "array"
    },
    "trigger_threshold": {
      "default": 70,
      "title": "Trigger Threshold",
      "type": "integer"
    },
    "discovered_count": {
      "default": 0,
      "title": "Discovered Count",
      "type": "integer"
    }
  },
  "required": [
    "scout_id",
    "status",
    "cadence"
  ],
  "title": "IndustryScoutRecordV2",
  "type": "object"
}

Get an industry signal

industry.signals.get.v2

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"
}
Output schema inside the result envelope
{
  "$defs": {
    "IndustryDiscoveryRecordV2": {
      "additionalProperties": true,
      "properties": {
        "discovery_id": {
          "format": "uuid",
          "title": "Discovery Id",
          "type": "string"
        },
        "scout_id": {
          "format": "uuid",
          "title": "Scout Id",
          "type": "string"
        },
        "company_name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Company Name"
        },
        "company_domain": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Company Domain"
        },
        "account_id": {
          "anyOf": [
            {
              "format": "uuid",
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Account Id"
        },
        "signal_title": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Signal Title"
        },
        "signal_summary": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Signal Summary"
        },
        "signal_type": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Signal Type"
        },
        "trigger_score": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Trigger Score"
        },
        "icp_score": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Icp Score"
        },
        "account_resolution": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Account Resolution"
        },
        "pipeline_state": {
          "title": "Pipeline State",
          "type": "string"
        },
        "state": {
          "title": "State",
          "type": "string"
        },
        "discovered_at": {
          "format": "date-time",
          "title": "Discovered At",
          "type": "string"
        },
        "source_urls": {
          "items": {
            "type": "string"
          },
          "title": "Source Urls",
          "type": "array"
        }
      },
      "required": [
        "discovery_id",
        "scout_id",
        "pipeline_state",
        "state",
        "discovered_at"
      ],
      "title": "IndustryDiscoveryRecordV2",
      "type": "object"
    },
    "IndustryScoutRecordV2": {
      "additionalProperties": true,
      "properties": {
        "scout_id": {
          "format": "uuid",
          "title": "Scout Id",
          "type": "string"
        },
        "name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Name"
        },
        "industry": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Industry"
        },
        "status": {
          "title": "Status",
          "type": "string"
        },
        "cadence": {
          "title": "Cadence",
          "type": "string"
        },
        "signal_type_bindings": {
          "items": {
            "additionalProperties": true,
            "type": "object"
          },
          "title": "Signal Type Bindings",
          "type": "array"
        },
        "geography": {
          "items": {
            "additionalProperties": true,
            "type": "object"
          },
          "title": "Geography",
          "type": "array"
        },
        "trigger_threshold": {
          "default": 70,
          "title": "Trigger Threshold",
          "type": "integer"
        },
        "discovered_count": {
          "default": 0,
          "title": "Discovered Count",
          "type": "integer"
        }
      },
      "required": [
        "scout_id",
        "status",
        "cadence"
      ],
      "title": "IndustryScoutRecordV2",
      "type": "object"
    }
  },
  "properties": {
    "signal": {
      "$ref": "#/$defs/IndustryDiscoveryRecordV2"
    },
    "scout": {
      "$ref": "#/$defs/IndustryScoutRecordV2"
    },
    "account_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Account Name"
    },
    "account_domain": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Account Domain"
    },
    "account_archived": {
      "default": false,
      "title": "Account Archived",
      "type": "boolean"
    },
    "trigger_threshold": {
      "title": "Trigger Threshold",
      "type": "integer"
    },
    "bucket": {
      "title": "Bucket",
      "type": "string"
    }
  },
  "required": [
    "signal",
    "scout",
    "trigger_threshold",
    "bucket"
  ],
  "title": "IndustrySignalGetResultV2",
  "type": "object"
}

List industry discoveries

industry.signals.list.v2

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"
}
Output schema inside the result envelope
{
  "$defs": {
    "IndustryDiscoveryRecordV2": {
      "additionalProperties": true,
      "properties": {
        "discovery_id": {
          "format": "uuid",
          "title": "Discovery Id",
          "type": "string"
        },
        "scout_id": {
          "format": "uuid",
          "title": "Scout Id",
          "type": "string"
        },
        "company_name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Company Name"
        },
        "company_domain": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Company Domain"
        },
        "account_id": {
          "anyOf": [
            {
              "format": "uuid",
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Account Id"
        },
        "signal_title": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Signal Title"
        },
        "signal_summary": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Signal Summary"
        },
        "signal_type": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Signal Type"
        },
        "trigger_score": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Trigger Score"
        },
        "icp_score": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Icp Score"
        },
        "account_resolution": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Account Resolution"
        },
        "pipeline_state": {
          "title": "Pipeline State",
          "type": "string"
        },
        "state": {
          "title": "State",
          "type": "string"
        },
        "discovered_at": {
          "format": "date-time",
          "title": "Discovered At",
          "type": "string"
        },
        "source_urls": {
          "items": {
            "type": "string"
          },
          "title": "Source Urls",
          "type": "array"
        }
      },
      "required": [
        "discovery_id",
        "scout_id",
        "pipeline_state",
        "state",
        "discovered_at"
      ],
      "title": "IndustryDiscoveryRecordV2",
      "type": "object"
    }
  },
  "properties": {
    "companies": {
      "items": {
        "$ref": "#/$defs/IndustryDiscoveryRecordV2"
      },
      "title": "Companies",
      "type": "array"
    },
    "total": {
      "title": "Total",
      "type": "integer"
    }
  },
  "required": [
    "companies",
    "total"
  ],
  "title": "IndustrySignalsListResultV2",
  "type": "object"
}

Set signal feedback

signals.feedback.set.v2

Use when: Accept or reject a signal for learning.

Avoid when: Do not use this to search signals.

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"
}
Output schema inside the result envelope
{
  "additionalProperties": false,
  "description": "V2 result for signals.feedback.set.v2; preserves the established validators.",
  "properties": {
    "event_id": {
      "format": "uuid",
      "title": "Event Id",
      "type": "string"
    },
    "verdict": {
      "enum": [
        "useful",
        "not_useful"
      ],
      "title": "Verdict",
      "type": "string"
    },
    "classified_at": {
      "format": "date-time",
      "title": "Classified At",
      "type": "string"
    }
  },
  "required": [
    "event_id",
    "verdict",
    "classified_at"
  ],
  "title": "PublicSignalsFeedbackSetResultV2",
  "type": "object"
}

Estimate monitoring credits by cadence

signals.monitoring.estimate.v2

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"
}
Output schema inside the result envelope
{
  "$defs": {
    "SignalCadenceEstimateV2": {
      "properties": {
        "cadence": {
          "enum": [
            "hourly",
            "daily",
            "every_3_days",
            "weekly",
            "every_two_weeks"
          ],
          "title": "Cadence",
          "type": "string"
        },
        "monitors": {
          "title": "Monitors",
          "type": "integer"
        },
        "projected_executions": {
          "title": "Projected Executions",
          "type": "integer"
        },
        "monitoring_credits_upper_bound": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$",
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Monitoring Credits Upper Bound"
        }
      },
      "required": [
        "cadence",
        "monitors",
        "projected_executions"
      ],
      "title": "SignalCadenceEstimateV2",
      "type": "object"
    }
  },
  "properties": {
    "source_kind": {
      "enum": [
        "account_monitor",
        "industry_scout"
      ],
      "title": "Source Kind",
      "type": "string"
    },
    "cadence": {
      "enum": [
        "hourly",
        "daily",
        "every_3_days",
        "weekly",
        "every_two_weeks"
      ],
      "title": "Cadence",
      "type": "string"
    },
    "horizon_days": {
      "title": "Horizon Days",
      "type": "integer"
    },
    "account_count": {
      "title": "Account Count",
      "type": "integer"
    },
    "signal_type_count": {
      "title": "Signal Type Count",
      "type": "integer"
    },
    "scenarios": {
      "items": {
        "$ref": "#/$defs/SignalCadenceEstimateV2"
      },
      "title": "Scenarios",
      "type": "array"
    },
    "executions_per_credit": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Executions Per Credit"
    },
    "credits_per_billing_unit": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Credits Per Billing Unit"
    },
    "pricing_status": {
      "enum": [
        "configured",
        "unavailable"
      ],
      "title": "Pricing Status",
      "type": "string"
    },
    "downstream_rates": {
      "additionalProperties": {
        "anyOf": [
          {
            "type": "number"
          },
          {
            "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$",
            "type": "string"
          }
        ]
      },
      "title": "Downstream Rates",
      "type": "object"
    },
    "assumptions": {
      "items": {
        "type": "string"
      },
      "title": "Assumptions",
      "type": "array"
    },
    "executable": {
      "const": false,
      "default": false,
      "title": "Executable",
      "type": "boolean"
    }
  },
  "required": [
    "source_kind",
    "cadence",
    "horizon_days",
    "account_count",
    "signal_type_count",
    "scenarios",
    "pricing_status",
    "downstream_rates",
    "assumptions"
  ],
  "title": "SignalMonitoringEstimateResultV2",
  "type": "object"
}

Submit a sourced signal

signals.observations.create.v2

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"
}
Output schema inside the result envelope
{
  "additionalProperties": false,
  "properties": {
    "signal_id": {
      "format": "uuid",
      "title": "Signal Id",
      "type": "string"
    },
    "source_kind": {
      "enum": [
        "account_monitor",
        "industry_scout"
      ],
      "title": "Source Kind",
      "type": "string"
    },
    "campaign_id": {
      "anyOf": [
        {
          "format": "uuid",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Campaign Id"
    },
    "scout_id": {
      "anyOf": [
        {
          "format": "uuid",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Scout Id"
    },
    "signal_type_id": {
      "format": "uuid",
      "title": "Signal Type Id",
      "type": "string"
    },
    "created": {
      "title": "Created",
      "type": "boolean"
    },
    "read_back_verified": {
      "title": "Read Back Verified",
      "type": "boolean"
    },
    "review_state": {
      "const": "needs_review",
      "default": "needs_review",
      "title": "Review State",
      "type": "string"
    },
    "credits_charged": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$",
          "type": "string"
        }
      ],
      "default": "0",
      "title": "Credits Charged"
    },
    "next_step": {
      "title": "Next Step",
      "type": "string"
    }
  },
  "required": [
    "signal_id",
    "source_kind",
    "signal_type_id",
    "created",
    "read_back_verified",
    "next_step"
  ],
  "title": "SignalObservationCreateResultV2",
  "type": "object"
}

Search recorded signals

signals.search.v2

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"
}
Output schema inside the result envelope
{
  "$defs": {
    "SignalSummaryV1": {
      "additionalProperties": false,
      "properties": {
        "signal_id": {
          "format": "uuid",
          "title": "Signal Id",
          "type": "string"
        },
        "contact_id": {
          "anyOf": [
            {
              "format": "uuid",
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Contact Id"
        },
        "account_id": {
          "anyOf": [
            {
              "format": "uuid",
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Account Id"
        },
        "campaign_id": {
          "anyOf": [
            {
              "format": "uuid",
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Campaign Id"
        },
        "loop_id": {
          "anyOf": [
            {
              "format": "uuid",
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Loop Id"
        },
        "account_name": {
          "maxLength": 255,
          "minLength": 1,
          "title": "Account Name",
          "type": "string"
        },
        "contact_name": {
          "anyOf": [
            {
              "maxLength": 255,
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Contact Name"
        },
        "channel": {
          "maxLength": 64,
          "minLength": 1,
          "title": "Channel",
          "type": "string"
        },
        "signal_type": {
          "maxLength": 128,
          "minLength": 1,
          "title": "Signal Type",
          "type": "string"
        },
        "intent": {
          "anyOf": [
            {
              "maxLength": 128,
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Intent"
        },
        "sentiment": {
          "anyOf": [
            {
              "maxLength": 128,
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Sentiment"
        },
        "content_excerpt": {
          "anyOf": [
            {
              "maxLength": 1000,
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Content Excerpt"
        },
        "observed_at": {
          "format": "date-time",
          "title": "Observed At",
          "type": "string"
        },
        "resource_path": {
          "anyOf": [
            {
              "maxLength": 500,
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Resource Path"
        },
        "state": {
          "anyOf": [
            {
              "maxLength": 64,
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "State"
        },
        "content_is_untrusted": {
          "const": true,
          "default": true,
          "title": "Content Is Untrusted",
          "type": "boolean"
        }
      },
      "required": [
        "signal_id",
        "account_name",
        "channel",
        "signal_type",
        "observed_at"
      ],
      "title": "SignalSummaryV1",
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "signals": {
      "default": [],
      "items": {
        "$ref": "#/$defs/SignalSummaryV1"
      },
      "maxItems": 100,
      "title": "Signals",
      "type": "array"
    },
    "offset": {
      "default": 0,
      "title": "Offset",
      "type": "integer"
    },
    "has_more": {
      "default": false,
      "title": "Has More",
      "type": "boolean"
    },
    "observed_until": {
      "anyOf": [
        {
          "format": "date-time",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Observed Until"
    },
    "coverage": {
      "default": "Recorded observations only; absence is not proof of no signal.",
      "title": "Coverage",
      "type": "string"
    }
  },
  "title": "SignalsSearchResultV2",
  "type": "object"
}