Hive

Read Hive automation contacts

read_contacts

Read-onlyIdempotent

List the people this Hive workspace has spoken to through DM automation, sequences, broadcasts and the Inbox. Names, handles and stored values follow the workspace Inbox privacy setting, so they may come back masked. The included-contact allowance comes back with every answer.

Input Schema

TableJSON Schema

Name	Required	Description
`email`	No	Find people by exact email address. Use only one of email, phone or fieldId.
`limit`	No	How many people to return, 1 to 100. Defaults to 25.
`phone`	No	Find people by exact phone number in international format, like +14155550123.
`search`	No	Match a name, handle or provider id.
`fieldId`	No	Find people whose contact field has exactly fieldValue. Field ids come from read_contact_fields.
`accountId`	No	Only people on this connected account’s platform.
`fieldName`	No	The field’s key or name, instead of fieldId.
`segmentId`	No	Only people in this Hive segment.
`fieldValue`	No	The value to match in fieldId.

Schema Changelog

Changes observed during successful MCP inspections.

Changed5 schema fields changedOct 10, 2026

addedInput schema / properties / email

Added value: +{
+  "description": "Find people by exact email address. Use only one of email, phone or fieldId.",
+  "type": "string"
+}

addedInput schema / properties / fieldId

Added value: +{
+  "description": "Find people whose contact field has exactly fieldValue. Field ids come from read_contact_fields.",
+  "type": "string"
+}

addedInput schema / properties / fieldName

Added value: +{
+  "description": "The field’s key or name, instead of fieldId.",
+  "type": "string"
+}

addedInput schema / properties / fieldValue

Added value: +{
+  "description": "The value to match in fieldId.",
+  "type": [
+    "string",
+    "number",
+    "boolean"
+  ]
+}

addedInput schema / properties / phone

Added value: +{
+  "description": "Find people by exact phone number in international format, like +14155550123.",
+  "type": "string"
+}

First observedSep 23, 2026

TDQS

Score is being calculated.

All Hive tools Inspect

Try in Browser

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

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?