DeepSearch

Ask about a person

ask_about_person

Read-only

Answer one specific question about a person, grounded in their public footprint, and suggest follow-ups. Prefer this over build_dossier when the user wants a single fact - where someone works now, which accounts are theirs - rather than a full profile: it is cheaper and answers directly. Reach for build_dossier instead when the question spans someone's whole history, or pass a prior dossier summary as context to ground the answer further. Public sources only - never private accounts or breach data. Requires chat scope. Provider work consumes account usage; cached results consume none.

Input Schema

TableJSON Schema

Name	Required	Description
`name`	Yes
`context`	No
`sandbox`	No
`question`	Yes
`idempotency_key`	No	Reuse this key when retrying the same inputs.

Output Schema

TableJSON Schema

Name	Required	Description	Default
`usage`	Yes
`answer`	Yes
`events`	Yes
`object`	Yes
`status`	No
`warning`	No
`metadata`	Yes
`request_id`	Yes
`related_questions`	Yes

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedOct 9, 2026

changedOutput schema / properties / events / items / anyOf

Previous value: -[
-  {
-    "additionalProperties": true,
-    "properties": {
-      "hit": {
-        "anyOf": [
-          {
-            "additionalProperties": {},
-            "properties": {
-              "age": {
-                "exclusiveMinimum": 0,
-                "maximum": 9007199254740991,
-                "type": "integer"
-              },
-              "avatarCandidates": {
-                "items": {
-                  "format": "uri",
-                  "type": "string"
-                },
-                "maxItems": 10,
-                "type": "array"
-              },
-              "avatarContext": {
-                "enum": [
-                  "account",
-                  "authority",
-                  "submitted",
-                  "subject"
-                ],
-                "type": "string"
-              },
-              "avatarUrl": {
-                "format": "uri",
-                "type": "string"
-              },
-              "confidence": {
-                "type": "number"
-              },
-              "headline": {
-                "maxLength": 500,
-                "type": "string"
-              },
-              "id": {
-                "type": "string"
-              },
-              "identityContext": {
-                "enum": [
-                  "account",
-                  "authority",
-                  "submitted"
-                ],
-                "type": "string"
-              },
-              "initials": {
-                "type": "string"
-              },
-              "kind": {
-                "const": "person",
-                "type": "string"
-              },
-              "location": {
-                "maxLength": 500,
-                "type": "string"
-              },
-              "name": {
-                "maxLength": 180,
-                "minLength": 1,
-                "type": "string"
-              },
-              "primaryPlatform": {
-                "enum": [
-                  "instagram",
-                  "facebook",
-                  "x",
-                  "twitter",
-                  "tiktok",
-                  "linkedin",
-                  "youtube",
-                  "whatsapp",
-                  "telegram",
-                  "snapchat",
-                  "reddit",
-                  "threads",
-                  "bluesky",
-                  "mastodon",
-                  "pinterest",
-                  "twitch",
-                  "discord",
-                  "tinder",
-                  "bumble",
-                  "hinge",
-                  "onlyfans",
-                  "fansly",
-                  "patreon",
-                  "cameo",
-                  "vsco",
-                  "tumblr",
-                  "flickr",
-                  "strava",
-                  "apple_music",
-                  "bandcamp",
-                  "lastfm",
-                  "vimeo",
-                  "letterboxd",
-                  "goodreads",
-                  "quora",
-                  "github",
-                  "stack_overflow",
-                  "hacker_news",
-                  "npm",
-                  "kaggle",
-                  "medium",
-                  "substack",
-                  "product_hunt",
-                  "wellfound",
-                  "crunchbase",
-                  "behance",
-                  "dribbble",
-                  "soundcloud",
-                  "spotify",
-                  "orcid",
-                  "google_scholar",
-                  "researchgate",
-                  "academia",
-                  "linktree",
-                  "personal_website",
-                  "company_page",
-                  "other"
-                ],
-                "type": "string"
-              },
-              "primaryUrl": {
-                "format": "uri",
-                "type": "string"
-              },
-              "primaryUsername": {
-                "maxLength": 80,
-                "type": "string"
-              },
-              "seedEmail": {
-                "maxLength": 320,
-                "type": "string"
-              },
-              "seedPhone": {
-                "maxLength": 80,
-                "type": "string"
-              },
-              "tags": {
-                "items": {
-                  "type": "string"
-                },
-                "type": "array"
-              }
-            },
-            "required": [
-              "id",
-              "name",
-              "initials",
-              "confidence",
-              "tags"
-            ],
-            "type": "object"
-          },
-          {
-            "additionalProperties": {},
-            "properties": {
-              "confidence": {
-                "type": "number"
-              },
-              "domain": {
-                "maxLength": 255,
-                "type": "string"
-              },
-              "headline": {
-                "maxLength": 500,
-                "type": "string"
-              },
-              "id": {
-                "type": "string"
-              },
-              "initials": {
-                "type": "string"
-              },
-              "jurisdiction": {
-                "maxLength": 120,
-                "type": "string"
-              },
-              "kind": {
-                "const": "company",
-                "type": "string"
-              },
-              "legalName": {
-                "maxLength": 180,
-                "type": "string"
-              },
-              "logoUrl": {
-                "format": "uri",
-                "type": "string"
-              },
-              "name": {
-                "maxLength": 180,
-                "minLength": 1,
-                "type": "string"
-              },
-              "seedDomain": {
-                "maxLength": 255,
-                "type": "string"
-              },
-              "seedRegistryId": {
-                "maxLength": 120,
-                "type": "string"
-              },
-              "seedRegistrySource": {
-                "maxLength": 80,
-                "type": "string"
-              },
-              "status": {
-                "enum": [
-                  "active",
-                  "dissolved",
-                  "unknown"
-                ],
-                "type": "string"
-              },
-              "tags": {
-                "items": {
-                  "type": "string"
-                },
-                "type": "array"
-              }
-            },
-            "required": [
-              "id",
-              "name",
-              "initials",
-              "confidence",
-              "tags",
-              "kind"
-            ],
-            "type": "object"
-          }
-        ]
-      },
-      "type": {
-        "const": "hit",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type",
-      "hit"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": true,
-    "properties": {
-      "delta": {
-        "type": "string"
-      },
-      "type": {
-        "const": "text",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type",
-      "delta"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": true,
-    "properties": {
-      "delta": {
-        "type": "string"
-      },
-      "type": {
-        "const": "summary",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type",
-      "delta"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": true,
-    "properties": {
-      "sources": {
-        "items": {
-          "additionalProperties": {},
-          "properties": {
-            "authorImageUrl": {
-              "type": "string"
-            },
-            "authorName": {
-              "type": "string"
-            },
-            "cited": {
-              "type": "boolean"
-            },
-            "domain": {
-              "type": "string"
-            },
-            "id": {
-              "type": "string"
-            },
-            "position": {
-              "type": "number"
-            },
-            "publishedAt": {
-              "type": "string"
-            },
-            "snippet": {
-              "type": "string"
-            },
-            "title": {
-              "type": "string"
-            },
-            "url": {
-              "type": "string"
-            }
-          },
-          "required": [
-            "id",
-            "position",
-            "url",
-            "title",
-            "domain"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "type": {
-        "const": "sources",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type",
-      "sources"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": true,
-    "properties": {
-      "questions": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "type": {
-        "const": "related",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type",
-      "questions"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": true,
-    "properties": {
-      "data": {},
-      "key": {
-        "enum": [
-          "identity",
-          "photos",
-          "contact",
-          "socials",
-          "locations",
-          "relatives",
-          "work",
-          "education",
-          "mentions",
-          "dating",
-          "relationships"
-        ],
-        "type": "string"
-      },
-      "type": {
-        "const": "section",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type",
-      "key",
-      "data"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": true,
-    "properties": {
-      "data": {},
-      "key": {
-        "enum": [
-          "identity",
-          "registration",
-          "industry",
-          "financials",
-          "funding",
-          "executives",
-          "locations",
-          "linkage",
-          "contact",
-          "mentions"
-        ],
-        "type": "string"
-      },
-      "type": {
-        "const": "entity_section",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type",
-      "key",
-      "data"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": true,
-    "properties": {
-      "data": {},
-      "key": {
-        "enum": [
-          "identity",
-          "engine",
-          "safety",
-          "recalls",
-          "history"
-        ],
-        "type": "string"
-      },
-      "type": {
-        "const": "vehicle_section",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type",
-      "key",
-      "data"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": true,
-    "properties": {
-      "match": {
-        "additionalProperties": {},
-        "properties": {
-          "date": {
-            "type": "string"
-          },
-          "imageUrl": {
-            "type": "string"
-          },
-          "matchKind": {
-            "type": "string"
-          },
-          "snippet": {
-            "type": "string"
-          },
-          "sourceDomain": {
-            "type": "string"
-          },
-          "thumbnailUrl": {
-            "type": "string"
-          },
-          "title": {
-            "type": "string"
-          },
-          "url": {
-            "type": "string"
-          }
-        },
-        "required": [
-          "url",
-          "sourceDomain"
-        ],
-        "type": "object"
-      },
-      "type": {
-        "const": "image_match",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type",
-      "match"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": true,
-    "properties": {
-      "image": {
-        "additionalProperties": {},
-        "properties": {
-          "imageUrl": {
-            "type": "string"
-          },
-          "sourceDomain": {
-            "type": "string"
-          },
-          "sourceUrl": {
-            "type": "string"
-          },
-          "thumbnailUrl": {
-            "type": "string"
-          },
-          "title": {
-            "type": "string"
-          }
-        },
-        "required": [
-          "imageUrl"
-        ],
-        "type": "object"
-      },
-      "type": {
-        "const": "similar_image",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type",
-      "image"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": true,
-    "properties": {
-      "result": {
-        "additionalProperties": {},
-        "properties": {
-          "matches": {
-            "items": {
-              "additionalProperties": {},
-              "properties": {
-                "date": {
-                  "type": "string"
-                },
-                "imageUrl": {
-                  "type": "string"
-                },
-                "matchKind": {
-                  "type": "string"
-                },
-                "snippet": {
-                  "type": "string"
-                },
-                "sourceDomain": {
-                  "type": "string"
-                },
-                "thumbnailUrl": {
-                  "type": "string"
-                },
-                "title": {
-                  "type": "string"
-                },
-                "url": {
-                  "type": "string"
-                }
-              },
-              "required": [
-                "url",
-                "sourceDomain"
-              ],
-              "type": "object"
-            },
-            "type": "array"
-          },
-          "provider": {
-            "type": "string"
-          },
-          "similar": {
-            "items": {
-              "additionalProperties": {},
-              "properties": {
-                "imageUrl": {
-                  "type": "string"
-                },
-                "sourceDomain": {
-                  "type": "string"
-                },
-                "sourceUrl": {
-                  "type": "string"
-                },
-                "thumbnailUrl": {
-                  "type": "string"
-                },
-                "title": {
-                  "type": "string"
-                }
-              },
-              "required": [
-                "imageUrl"
-              ],
-              "type": "object"
-            },
-            "type": "array"
-          }
-        },
-        "required": [
-          "provider"
-        ],
-        "type": "object"
-      },
-      "type": {
-        "const": "image_summary",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type",
-      "result"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": true,
-    "properties": {
-      "type": {
-        "const": "done",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": true,
-    "properties": {
-      "code": {
-        "type": "string"
-      },
-      "message": {
-        "type": "string"
-      },
-      "type": {
-        "const": "error",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type",
-      "message"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": {},
-    "properties": {
-      "type": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "type"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": true,
+    "properties": {
+      "hit": {
+        "anyOf": [
+          {
+            "additionalProperties": {},
+            "properties": {
+              "age": {
+                "exclusiveMinimum": 0,
+                "maximum": 9007199254740991,
+                "type": "integer"
+              },
+              "avatarCandidates": {
+                "items": {
+                  "format": "uri",
+                  "type": "string"
+                },
+                "maxItems": 10,
+                "type": "array"
+              },
+              "avatarContext": {
+                "enum": [
+                  "account",
+                  "authority",
+                  "submitted",
+                  "subject"
+                ],
+                "type": "string"
+              },
+              "avatarUrl": {
+                "format": "uri",
+                "type": "string"
+              },
+              "confidence": {
+                "type": "number"
+              },
+              "headline": {
+                "maxLength": 500,
+                "type": "string"
+              },
+              "id": {
+                "type": "string"
+              },
+              "identityContext": {
+                "enum": [
+                  "account",
+                  "authority",
+                  "submitted"
+                ],
+                "type": "string"
+              },
+              "initials": {
+                "type": "string"
+              },
+              "kind": {
+                "const": "person",
+                "type": "string"
+              },
+              "linkedProfileUrls": {
+                "items": {
+                  "format": "uri",
+                  "type": "string"
+                },
+                "maxItems": 32,
+                "type": "array"
+              },
+              "location": {
+                "maxLength": 500,
+                "type": "string"
+              },
+              "name": {
+                "maxLength": 180,
+                "minLength": 1,
+                "type": "string"
+              },
+              "primaryPlatform": {
+                "enum": [
+                  "instagram",
+                  "facebook",
+                  "x",
+                  "twitter",
+                  "tiktok",
+                  "linkedin",
+                  "youtube",
+                  "whatsapp",
+                  "telegram",
+                  "snapchat",
+                  "reddit",
+                  "threads",
+                  "bluesky",
+                  "mastodon",
+                  "pinterest",
+                  "twitch",
+                  "discord",
+                  "tinder",
+                  "bumble",
+                  "hinge",
+                  "onlyfans",
+                  "fansly",
+                  "patreon",
+                  "cameo",
+                  "vsco",
+                  "tumblr",
+                  "flickr",
+                  "strava",
+                  "apple_music",
+                  "bandcamp",
+                  "lastfm",
+                  "vimeo",
+                  "letterboxd",
+                  "goodreads",
+                  "quora",
+                  "github",
+                  "stack_overflow",
+                  "hacker_news",
+                  "npm",
+                  "kaggle",
+                  "medium",
+                  "substack",
+                  "product_hunt",
+                  "wellfound",
+                  "crunchbase",
+                  "behance",
+                  "dribbble",
+                  "soundcloud",
+                  "spotify",
+                  "orcid",
+                  "google_scholar",
+                  "researchgate",
+                  "academia",
+                  "linktree",
+                  "personal_website",
+                  "company_page",
+                  "other"
+                ],
+                "type": "string"
+              },
+              "primaryUrl": {
+                "format": "uri",
+                "type": "string"
+              },
+              "primaryUsername": {
+                "maxLength": 80,
+                "type": "string"
+              },
+              "seedEmail": {
+                "maxLength": 320,
+                "type": "string"
+              },
+              "seedPhone": {
+                "maxLength": 80,
+                "type": "string"
+              },
+              "tags": {
+                "items": {
+                  "type": "string"
+                },
+                "type": "array"
+              }
+            },
+            "required": [
+              "id",
+              "name",
+              "initials",
+              "confidence",
+              "tags"
+            ],
+            "type": "object"
+          },
+          {
+            "additionalProperties": {},
+            "properties": {
+              "confidence": {
+                "type": "number"
+              },
+              "domain": {
+                "maxLength": 255,
+                "type": "string"
+              },
+              "headline": {
+                "maxLength": 500,
+                "type": "string"
+              },
+              "id": {
+                "type": "string"
+              },
+              "initials": {
+                "type": "string"
+              },
+              "jurisdiction": {
+                "maxLength": 120,
+                "type": "string"
+              },
+              "kind": {
+                "const": "company",
+                "type": "string"
+              },
+              "legalName": {
+                "maxLength": 180,
+                "type": "string"
+              },
+              "logoUrl": {
+                "format": "uri",
+                "type": "string"
+              },
+              "name": {
+                "maxLength": 180,
+                "minLength": 1,
+                "type": "string"
+              },
+              "seedDomain": {
+                "maxLength": 255,
+                "type": "string"
+              },
+              "seedRegistryId": {
+                "maxLength": 120,
+                "type": "string"
+              },
+              "seedRegistrySource": {
+                "maxLength": 80,
+                "type": "string"
+              },
+              "status": {
+                "enum": [
+                  "active",
+                  "dissolved",
+                  "unknown"
+                ],
+                "type": "string"
+              },
+              "tags": {
+                "items": {
+                  "type": "string"
+                },
+                "type": "array"
+              }
+            },
+            "required": [
+              "id",
+              "name",
+              "initials",
+              "confidence",
+              "tags",
+              "kind"
+            ],
+            "type": "object"
+          }
+        ]
+      },
+      "type": {
+        "const": "hit",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type",
+      "hit"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": true,
+    "properties": {
+      "delta": {
+        "type": "string"
+      },
+      "type": {
+        "const": "text",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type",
+      "delta"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": true,
+    "properties": {
+      "delta": {
+        "type": "string"
+      },
+      "type": {
+        "const": "summary",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type",
+      "delta"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": true,
+    "properties": {
+      "sources": {
+        "items": {
+          "additionalProperties": {},
+          "properties": {
+            "authorImageUrl": {
+              "type": "string"
+            },
+            "authorName": {
+              "type": "string"
+            },
+            "cited": {
+              "type": "boolean"
+            },
+            "domain": {
+              "type": "string"
+            },
+            "id": {
+              "type": "string"
+            },
+            "position": {
+              "type": "number"
+            },
+            "publishedAt": {
+              "type": "string"
+            },
+            "snippet": {
+              "type": "string"
+            },
+            "title": {
+              "type": "string"
+            },
+            "url": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "id",
+            "position",
+            "url",
+            "title",
+            "domain"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "type": {
+        "const": "sources",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type",
+      "sources"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": true,
+    "properties": {
+      "questions": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "type": {
+        "const": "related",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type",
+      "questions"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": true,
+    "properties": {
+      "data": {},
+      "key": {
+        "enum": [
+          "identity",
+          "photos",
+          "contact",
+          "socials",
+          "locations",
+          "relatives",
+          "work",
+          "education",
+          "mentions",
+          "dating",
+          "relationships"
+        ],
+        "type": "string"
+      },
+      "type": {
+        "const": "section",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type",
+      "key",
+      "data"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": true,
+    "properties": {
+      "data": {},
+      "key": {
+        "enum": [
+          "identity",
+          "registration",
+          "industry",
+          "financials",
+          "funding",
+          "executives",
+          "locations",
+          "linkage",
+          "contact",
+          "mentions"
+        ],
+        "type": "string"
+      },
+      "type": {
+        "const": "entity_section",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type",
+      "key",
+      "data"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": true,
+    "properties": {
+      "data": {},
+      "key": {
+        "enum": [
+          "identity",
+          "engine",
+          "safety",
+          "recalls",
+          "history"
+        ],
+        "type": "string"
+      },
+      "type": {
+        "const": "vehicle_section",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type",
+      "key",
+      "data"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": true,
+    "properties": {
+      "match": {
+        "additionalProperties": {},
+        "properties": {
+          "date": {
+            "type": "string"
+          },
+          "imageUrl": {
+            "type": "string"
+          },
+          "matchKind": {
+            "type": "string"
+          },
+          "snippet": {
+            "type": "string"
+          },
+          "sourceDomain": {
+            "type": "string"
+          },
+          "thumbnailUrl": {
+            "type": "string"
+          },
+          "title": {
+            "type": "string"
+          },
+          "url": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "url",
+          "sourceDomain"
+        ],
+        "type": "object"
+      },
+      "type": {
+        "const": "image_match",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type",
+      "match"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": true,
+    "properties": {
+      "image": {
+        "additionalProperties": {},
+        "properties": {
+          "imageUrl": {
+            "type": "string"
+          },
+          "sourceDomain": {
+            "type": "string"
+          },
+          "sourceUrl": {
+            "type": "string"
+          },
+          "thumbnailUrl": {
+            "type": "string"
+          },
+          "title": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "imageUrl"
+        ],
+        "type": "object"
+      },
+      "type": {
+        "const": "similar_image",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type",
+      "image"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": true,
+    "properties": {
+      "result": {
+        "additionalProperties": {},
+        "properties": {
+          "matches": {
+            "items": {
+              "additionalProperties": {},
+              "properties": {
+                "date": {
+                  "type": "string"
+                },
+                "imageUrl": {
+                  "type": "string"
+                },
+                "matchKind": {
+                  "type": "string"
+                },
+                "snippet": {
+                  "type": "string"
+                },
+                "sourceDomain": {
+                  "type": "string"
+                },
+                "thumbnailUrl": {
+                  "type": "string"
+                },
+                "title": {
+                  "type": "string"
+                },
+                "url": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "url",
+                "sourceDomain"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "provider": {
+            "type": "string"
+          },
+          "similar": {
+            "items": {
+              "additionalProperties": {},
+              "properties": {
+                "imageUrl": {
+                  "type": "string"
+                },
+                "sourceDomain": {
+                  "type": "string"
+                },
+                "sourceUrl": {
+                  "type": "string"
+                },
+                "thumbnailUrl": {
+                  "type": "string"
+                },
+                "title": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "imageUrl"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          }
+        },
+        "required": [
+          "provider"
+        ],
+        "type": "object"
+      },
+      "type": {
+        "const": "image_summary",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type",
+      "result"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": true,
+    "properties": {
+      "type": {
+        "const": "done",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": true,
+    "properties": {
+      "code": {
+        "type": "string"
+      },
+      "message": {
+        "type": "string"
+      },
+      "type": {
+        "const": "error",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type",
+      "message"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": {},
+    "properties": {
+      "type": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "type"
+    ],
+    "type": "object"
+  }
+]

Changed12 schema fields changedOct 2, 2026

addedInput schema / $schema

Added value: +"https://json-schema.org/draft/2020-12/schema"

removedInput schema / properties / context / description

Removed value: -"Optional extra grounding context, e.g. a prior dossier summary."

addedInput schema / properties / context / maxLength
```
Added value: +12000
```

addedInput schema / properties / idempotency_key

Added value: +{
+  "description": "Reuse this key when retrying the same inputs.",
+  "maxLength": 255,
+  "minLength": 1,
+  "type": "string"
+}

removedInput schema / properties / name / description

Removed value: -"The person the question is about."

addedInput schema / properties / name / maxLength
```
Added value: +180
```
addedInput schema / properties / name / minLength
```
Added value: +1
```
removedInput schema / properties / question / description
```
Removed value: -"Your question about the person."
```
addedInput schema / properties / question / maxLength
```
Added value: +4000
```
addedInput schema / properties / question / minLength
```
Added value: +1
```
addedInput schema / properties / sandbox
```
Added value: +{
+  "type": "boolean"
+}
```

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "additionalProperties": true,
+  "properties": {
+    "answer": {
+      "type": "string"
+    },
+    "events": {
+      "items": {
+        "anyOf": [
+          {
+            "additionalProperties": true,
+            "properties": {
+              "hit": {
+                "anyOf": [
+                  {
+                    "additionalProperties": {},
+                    "properties": {
+                      "age": {
+                        "exclusiveMinimum": 0,
+                        "maximum": 9007199254740991,
+                        "type": "integer"
+                      },
+                      "avatarCandidates": {
+                        "items": {
+                          "format": "uri",
+                          "type": "string"
+                        },
+                        "maxItems": 10,
+                        "type": "array"
+                      },
+                      "avatarContext": {
+                        "enum": [
+                          "account",
+                          "authority",
+                          "submitted",
+                          "subject"
+                        ],
+                        "type": "string"
+                      },
+                      "avatarUrl": {
+                        "format": "uri",
+                        "type": "string"
+                      },
+                      "confidence": {
+                        "type": "number"
+                      },
+                      "headline": {
+                        "maxLength": 500,
+                        "type": "string"
+                      },
+                      "id": {
+                        "type": "string"
+                      },
+                      "identityContext": {
+                        "enum": [
+                          "account",
+                          "authority",
+                          "submitted"
+                        ],
+                        "type": "string"
+                      },
+                      "initials": {
+                        "type": "string"
+                      },
+                      "kind": {
+                        "const": "person",
+                        "type": "string"
+                      },
+                      "location": {
+                        "maxLength": 500,
+                        "type": "string"
+                      },
+                      "name": {
+                        "maxLength": 180,
+                        "minLength": 1,
+                        "type": "string"
+                      },
+                      "primaryPlatform": {
+                        "enum": [
+                          "instagram",
+                          "facebook",
+                          "x",
+                          "twitter",
+                          "tiktok",
+                          "linkedin",
+                          "youtube",
+                          "whatsapp",
+                          "telegram",
+                          "snapchat",
+                          "reddit",
+                          "threads",
+                          "bluesky",
+                          "mastodon",
+                          "pinterest",
+                          "twitch",
+                          "discord",
+                          "tinder",
+                          "bumble",
+                          "hinge",
+                          "onlyfans",
+                          "fansly",
+                          "patreon",
+                          "cameo",
+                          "vsco",
+                          "tumblr",
+                          "flickr",
+                          "strava",
+                          "apple_music",
+                          "bandcamp",
+                          "lastfm",
+                          "vimeo",
+                          "letterboxd",
+                          "goodreads",
+                          "quora",
+                          "github",
+                          "stack_overflow",
+                          "hacker_news",
+                          "npm",
+                          "kaggle",
+                          "medium",
+                          "substack",
+                          "product_hunt",
+                          "wellfound",
+                          "crunchbase",
+                          "behance",
+                          "dribbble",
+                          "soundcloud",
+                          "spotify",
+                          "orcid",
+                          "google_scholar",
+                          "researchgate",
+                          "academia",
+                          "linktree",
+                          "personal_website",
+                          "company_page",
+                          "other"
+                        ],
+                        "type": "string"
+                      },
+                      "primaryUrl": {
+                        "format": "uri",
+                        "type": "string"
+                      },
+                      "primaryUsername": {
+                        "maxLength": 80,
+                        "type": "string"
+                      },
+                      "seedEmail": {
+                        "maxLength": 320,
+                        "type": "string"
+                      },
+                      "seedPhone": {
+                        "maxLength": 80,
+                        "type": "string"
+                      },
+                      "tags": {
+                        "items": {
+                          "type": "string"
+                        },
+                        "type": "array"
+                      }
+                    },
+                    "required": [
+                      "id",
+                      "name",
+                      "initials",
+                      "confidence",
+                      "tags"
+                    ],
+                    "type": "object"
+                  },
+                  {
+                    "additionalProperties": {},
+                    "properties": {
+                      "confidence": {
+                        "type": "number"
+                      },
+                      "domain": {
+                        "maxLength": 255,
+                        "type": "string"
+                      },
+                      "headline": {
+                        "maxLength": 500,
+                        "type": "string"
+                      },
+                      "id": {
+                        "type": "string"
+                      },
+                      "initials": {
+                        "type": "string"
+                      },
+                      "jurisdiction": {
+                        "maxLength": 120,
+                        "type": "string"
+                      },
+                      "kind": {
+                        "const": "company",
+                        "type": "string"
+                      },
+                      "legalName": {
+                        "maxLength": 180,
+                        "type": "string"
+                      },
+                      "logoUrl": {
+                        "format": "uri",
+                        "type": "string"
+                      },
+                      "name": {
+                        "maxLength": 180,
+                        "minLength": 1,
+                        "type": "string"
+                      },
+                      "seedDomain": {
+                        "maxLength": 255,
+                        "type": "string"
+                      },
+                      "seedRegistryId": {
+                        "maxLength": 120,
+                        "type": "string"
+                      },
+                      "seedRegistrySource": {
+                        "maxLength": 80,
+                        "type": "string"
+                      },
+                      "status": {
+                        "enum": [
+                          "active",
+                          "dissolved",
+                          "unknown"
+                        ],
+                        "type": "string"
+                      },
+                      "tags": {
+                        "items": {
+                          "type": "string"
+                        },
+                        "type": "array"
+                      }
+                    },
+                    "required": [
+                      "id",
+                      "name",
+                      "initials",
+                      "confidence",
+                      "tags",
+                      "kind"
+                    ],
+                    "type": "object"
+                  }
+                ]
+              },
+              "type": {
+                "const": "hit",
+                "type": "string"
+              }
+            },
+            "required": [
+              "type",
+              "hit"
+            ],
+            "type": "object"
+          },
+          {
+            "additionalProperties": true,
+            "properties": {
+              "delta": {
+                "type": "string"
+              },
+              "type": {
+                "const": "text",
+                "type": "string"
+              }
+            },
+            "required": [
+              "type",
+              "delta"
+            ],
+            "type": "object"
+          },
+          {
+            "additionalProperties": true,
+            "properties": {
+              "delta": {
+                "type": "string"
+              },
+              "type": {
+                "const": "summary",
+                "type": "string"
+              }
+            },
+            "required": [
+              "type",
+              "delta"
+            ],
+            "type": "object"
+          },
+          {
+            "additionalProperties": true,
+            "properties": {
+              "sources": {
+                "items": {
+                  "additionalProperties": {},
+                  "properties": {
+                    "authorImageUrl": {
+                      "type": "string"
+                    },
+                    "authorName": {
+                      "type": "string"
+                    },
+                    "cited": {
+                      "type": "boolean"
+                    },
+                    "domain": {
+                      "type": "string"
+                    },
+                    "id": {
+                      "type": "string"
+                    },
+                    "position": {
+                      "type": "number"
+                    },
+                    "publishedAt": {
+                      "type": "string"
+                    },
+                    "snippet": {
+                      "type": "string"
+                    },
+                    "title": {
+                      "type": "string"
+                    },
+                    "url": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "id",
+                    "position",
+                    "url",
+                    "title",
+                    "domain"
+                  ],
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "type": {
+                "const": "sources",
+                "type": "string"
+              }
+            },
+            "required": [
+              "type",
+              "sources"
+            ],
+            "type": "object"
+          },
+          {
+            "additionalProperties": true,
+            "properties": {
+              "questions": {
+                "items": {
+                  "type": "string"
+                },
+                "type": "array"
+              },
+              "type": {
+                "const": "related",
+                "type": "string"
+              }
+            },
+            "required": [
+              "type",
+              "questions"
+            ],
+            "type": "object"
+          },
+          {
+            "additionalProperties": true,
+            "properties": {
+              "data": {},
+              "key": {
+                "enum": [
+                  "identity",
+                  "photos",
+                  "contact",
+                  "socials",
+                  "locations",
+                  "relatives",
+                  "work",
+                  "education",
+                  "mentions",
+                  "dating",
+                  "relationships"
+                ],
+                "type": "string"
+              },
+              "type": {
+                "const": "section",
+                "type": "string"
+              }
+            },
+            "required": [
+              "type",
+              "key",
+              "data"
+            ],
+            "type": "object"
+          },
+          {
+            "additionalProperties": true,
+            "properties": {
+              "data": {},
+              "key": {
+                "enum": [
+                  "identity",
+                  "registration",
+                  "industry",
+                  "financials",
+                  "funding",
+                  "executives",
+                  "locations",
+                  "linkage",
+                  "contact",
+                  "mentions"
+                ],
+                "type": "string"
+              },
+              "type": {
+                "const": "entity_section",
+                "type": "string"
+              }
+            },
+            "required": [
+              "type",
+              "key",
+              "data"
+            ],
+            "type": "object"
+          },
+          {
+            "additionalProperties": true,
+            "properties": {
+              "data": {},
+              "key": {
+                "enum": [
+                  "identity",
+                  "engine",
+                  "safety",
+                  "recalls",
+                  "history"
+                ],
+                "type": "string"
+              },
+              "type": {
+                "const": "vehicle_section",
+                "type": "string"
+              }
+            },
+            "required": [
+              "type",
+              "key",
+              "data"
+            ],
+            "type": "object"
+          },
+          {
+            "additionalProperties": true,
+            "properties": {
+              "match": {
+                "additionalProperties": {},
+                "properties": {
+                  "date": {
+                    "type": "string"
+                  },
+                  "imageUrl": {
+                    "type": "string"
+                  },
+                  "matchKind": {
+                    "type": "string"
+                  },
+                  "snippet": {
+                    "type": "string"
+                  },
+                  "sourceDomain": {
+                    "type": "string"
+                  },
+                  "thumbnailUrl": {
+                    "type": "string"
+                  },
+                  "title": {
+                    "type": "string"
+                  },
+                  "url": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "url",
+                  "sourceDomain"
+                ],
+                "type": "object"
+              },
+              "type": {
+                "const": "image_match",
+                "type": "string"
+              }
+            },
+            "required": [
+              "type",
+              "match"
+            ],
+            "type": "object"
+          },
+          {
+            "additionalProperties": true,
+            "properties": {
+              "image": {
+                "additionalProperties": {},
+                "properties": {
+                  "imageUrl": {
+                    "type": "string"
+                  },
+                  "sourceDomain": {
+                    "type": "string"
+                  },
+                  "sourceUrl": {
+                    "type": "string"
+                  },
+                  "thumbnailUrl": {
+                    "type": "string"
+                  },
+                  "title": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "imageUrl"
+                ],
+                "type": "object"
+              },
+              "type": {
+                "const": "similar_image",
+                "type": "string"
+              }
+            },
+            "required": [
+              "type",
+              "image"
+            ],
+            "type": "object"
+          },
+          {
+            "additionalProperties": true,
+            "properties": {
+              "result": {
+                "additionalProperties": {},
+                "properties": {
+                  "matches": {
+                    "items": {
+                      "additionalProperties": {},
+                      "properties": {
+                        "date": {
+                          "type": "string"
+                        },
+                        "imageUrl": {
+                          "type": "string"
+                        },
+                        "matchKind": {
+                          "type": "string"
+                        },
+                        "snippet": {
+                          "type": "string"
+                        },
+                        "sourceDomain": {
+                          "type": "string"
+                        },
+                        "thumbnailUrl": {
+                          "type": "string"
+                        },
+                        "title": {
+                          "type": "string"
+                        },
+                        "url": {
+                          "type": "string"
+                        }
+                      },
+                      "required": [
+                        "url",
+                        "sourceDomain"
+                      ],
+                      "type": "object"
+                    },
+                    "type": "array"
+                  },
+                  "provider": {
+                    "type": "string"
+                  },
+                  "similar": {
+                    "items": {
+                      "additionalProperties": {},
+                      "properties": {
+                        "imageUrl": {
+                          "type": "string"
+                        },
+                        "sourceDomain": {
+                          "type": "string"
+                        },
+                        "sourceUrl": {
+                          "type": "string"
+                        },
+                        "thumbnailUrl": {
+                          "type": "string"
+                        },
+                        "title": {
+                          "type": "string"
+                        }
+                      },
+                      "required": [
+                        "imageUrl"
+                      ],
+                      "type": "object"
+                    },
+                    "type": "array"
+                  }
+                },
+                "required": [
+                  "provider"
+                ],
+                "type": "object"
+              },
+              "type": {
+                "const": "image_summary",
+                "type": "string"
+              }
+            },
+            "required": [
+              "type",
+              "result"
+            ],
+            "type": "object"
+          },
+          {
+            "additionalProperties": true,
+            "properties": {
+              "type": {
+                "const": "done",
+                "type": "string"
+              }
+            },
+            "required": [
+              "type"
+            ],
+            "type": "object"
+          },
+          {
+            "additionalProperties": true,
+            "properties": {
+              "code": {
+                "type": "string"
+              },
+              "message": {
+                "type": "string"
+              },
+              "type": {
+                "const": "error",
+                "type": "string"
+              }
+            },
+            "required": [
+              "type",
+              "message"
+            ],
+            "type": "object"
+          },
+          {
+            "additionalProperties": {},
+            "properties": {
+              "type": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "type"
+            ],
+            "type": "object"
+          }
+        ]
+      },
+      "type": "array"
+    },
+    "metadata": {
+      "additionalProperties": true,
+      "properties": {
+        "api_version": {
+          "const": "v1",
+          "type": "string"
+        },
+        "generated_at": {
+          "type": "string"
+        },
+        "operation": {
+          "enum": [
+            "search",
+            "dossier",
+            "chat",
+            "entity_search",
+            "entity_dossier",
+            "reverse_image",
+            "vin"
+          ],
+          "type": "string"
+        },
+        "request_id": {
+          "type": "string"
+        },
+        "sandbox": {
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "api_version",
+        "operation",
+        "request_id",
+        "generated_at"
+      ],
+      "type": "object"
+    },
+    "object": {
+      "const": "chat_result",
+      "type": "string"
+    },
+    "related_questions": {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "request_id": {
+      "type": "string"
+    },
+    "status": {
+      "const": "partial",
+      "type": "string"
+    },
+    "usage": {
+      "additionalProperties": true,
+      "properties": {
+        "allowanceSource": {
+          "enum": [
+            "weekly",
+            "coin"
+          ],
+          "type": "string"
+        },
+        "cached": {
+          "type": "boolean"
+        },
+        "credits": {
+          "type": "number"
+        },
+        "idempotencyKey": {
+          "type": "string"
+        },
+        "metered": {
+          "type": "boolean"
+        },
+        "percentageCharged": {
+          "type": "number"
+        },
+        "remainingPercent": {
+          "type": "number"
+        },
+        "replayed": {
+          "type": "boolean"
+        },
+        "resetAt": {
+          "type": "string"
+        },
+        "sandbox": {
+          "type": "boolean"
+        },
+        "source": {
+          "enum": [
+            "included",
+            "extra",
+            "mixed"
+          ],
+          "type": "string"
+        }
+      },
+      "required": [
+        "metered",
+        "credits"
+      ],
+      "type": "object"
+    },
+    "warning": {
+      "type": "string"
+    }
+  },
+  "required": [
+    "request_id",
+    "metadata",
+    "usage",
+    "events",
+    "object",
+    "answer",
+    "related_questions"
+  ],
+  "type": "object"
+}

Changed10 schema fields changedSep 9, 2026

removedInput schema / additionalProperties
```
Removed value: -false
```

addedInput schema / properties / context

Added value: +{
+  "description": "Optional extra grounding context, e.g. a prior dossier summary.",
+  "type": "string"
+}

changedInput schema / properties / name / description

Previous value: -"The person's name, not a phone number, email, or handle."New value: +"The person the question is about."

removedInput schema / properties / name / maxLength
```
Removed value: -100
```
removedInput schema / properties / name / minLength
```
Removed value: -2
```

removedInput schema / properties / profile_url

Removed value: -{
-  "description": "The profileUrl of the professional source selected from search_people. Never infer account ownership.",
-  "maxLength": 400,
-  "type": "string"
-}

changedInput schema / properties / question / description

Previous value: -"A specific question about the person's public professional work."New value: +"Your question about the person."

removedInput schema / properties / question / maxLength
```
Removed value: -400
```
removedInput schema / properties / question / minLength
```
Removed value: -5
```

changedInput schema / required

Previous value: -[
-  "name",
-  "profile_url",
-  "question"
-]New value: +[
+  "name",
+  "question"
+]

Changed10 schema fields changedSep 9, 2026

addedInput schema / additionalProperties
```
Added value: +false
```

removedInput schema / properties / context

Removed value: -{
-  "description": "Optional extra grounding context, e.g. a prior dossier summary.",
-  "type": "string"
-}

changedInput schema / properties / name / description

Previous value: -"The person the question is about."New value: +"The person's name, not a phone number, email, or handle."

addedInput schema / properties / name / maxLength
```
Added value: +100
```
addedInput schema / properties / name / minLength
```
Added value: +2
```

addedInput schema / properties / profile_url

Added value: +{
+  "description": "The profileUrl of the professional source selected from search_people. Never infer account ownership.",
+  "maxLength": 400,
+  "type": "string"
+}

changedInput schema / properties / question / description

Previous value: -"Your question about the person."New value: +"A specific question about the person's public professional work."

addedInput schema / properties / question / maxLength
```
Added value: +400
```
addedInput schema / properties / question / minLength
```
Added value: +5
```

changedInput schema / required

Previous value: -[
-  "name",
-  "question"
-]New value: +[
+  "name",
+  "profile_url",
+  "question"
+]

First observedAug 19, 2026

TDQS

A4.7/5.0

Behavior5/5

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

Annotations cover only the safety profile (readOnly, openWorld, non-destructive), but the description adds substantive behavior the annotations cannot convey: public sources only with an explicit prohibition on private accounts and breach data, a required chat scope, and a cost model distinguishing provider work from cached results.

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

Conciseness5/5

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

Four tightly packed sentences, front-loaded with the core action and its routing rule before the exclusions, grounding advice, and cost/privacy constraints. Every sentence carries distinct information; none is filler.

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

Completeness5/5

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

An output schema exists, so return values need not be explained, and the description still notes that follow-ups are suggested. Combined with the scope, cost, and sourcing constraints, an agent has everything needed to select and call this correctly.

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

Parameters3/5

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

Schema description coverage is only 20% (only idempotency_key is documented), so the description must carry the load. It does add real meaning for `context` (pass a prior dossier summary to ground the answer), but leaves `sandbox`, `name`, and `question` unexplained beyond their obvious names. Partial compensation for a significant coverage gap.

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

Purpose5/5

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

States a specific verb and resource ('Answer one specific question about a person, grounded in their public footprint') and explicitly contrasts itself with the sibling build_dossier. An agent can distinguish it from build_dossier, search_people, and the dossier builders without opening any schema.

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

Usage Guidelines5/5

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

Gives explicit when-to-use ('single fact - where someone works now, which accounts are theirs'), when-not ('question spans someone's whole history'), and names the alternative (build_dossier) plus a hybrid path (pass a prior dossier summary as `context`). Nothing is left to inference.

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

All DeepSearch 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?