discovery
PeopleAnalyst's free people-analytics feeds: answers, tools, evidence, story and scene catalogs.
我该使用它吗
质量与安全性
A
发现（3）
- HIGHTool poisoning patterns detected
- MEDIUMTool description contains URL to non-standard domain在 list_peopleanalyst_feeds 中
- LOWTool 'get_scene_templates' description lacks action verb在 get_scene_templates 中
基于对工具定义和协议合规性的自动分析。
上下文开销
~10,765token 数（工具定义）
~7.2 KB典型响应大小
对注意力有显著影响（占 128k 上下文窗口的 8.41%）
这是每次将服务器的工具加载到模型上下文窗口时所消耗的大致 token 数。数值越高，可用于其他任务的注意力就越少。
安装
一键安装
将以下内容添加到你的 `claude_desktop_config.json` 文件中：
{
"mcpServers": {
"discovery": {
"url": "https://peopleanalyst.com/mcp"
}
}
}远程端点
https://peopleanalyst.com/mcpstreamable-http它能做什么
工具清单
工具（16）
🟢 只读🟡 写入🔴 删除⚪ 未知
🟢list_peopleanalyst_feeds
List PeopleAnalyst's free machine-readable feeds and their MCP/REST availability. OpenAPI is also published at https://peopleanalyst.com/openapi.json.
输入模式
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}输出模式
{
"type": "object",
"properties": {
"feeds": {
"type": "array",
"items": {
"type": "object",
"properties": {
"path": {
"type": "string"
},
"summary": {
"type": "string"
},
"params": {
"type": "array",
"items": {
"type": "string"
}
},
"tool": {
"type": "string"
},
"restOnly": {
"type": "boolean",
"const": true
}
},
"required": [
"path",
"summary",
"params"
],
"additionalProperties": false
}
}
},
"required": [
"feeds"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢list_answers
Returns the full index of authored /answers pages — one entry per slug, with the question and canonical URL. Use this to discover available slugs before calling get_answer.
输入模式
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}输出模式
{
"type": "object",
"properties": {
"contract": {
"type": "string"
},
"count": {
"type": "number"
},
"answers": {
"type": "array",
"items": {
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"title": {
"type": "string"
},
"question": {
"type": "string"
},
"canonicalUrl": {
"type": "string"
},
"updatedAt": {
"type": "string"
}
},
"required": [
"slug",
"title",
"question",
"canonicalUrl",
"updatedAt"
],
"additionalProperties": false
}
}
},
"required": [
"contract",
"count",
"answers"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_answer(slug)
Returns one authored /answers page as structured content: question, markdown answer body (short answer, problem frame, evidence, grounded sources), and citations with libraryId or url. Known slugs (33): measure-employee-performance, survey-validity-check, people-analytics-program-maturity, people-analytics-vs-hr-reporting, engagement-survey-vs-listening-diagnostic, people-analytics-tools-compare, beyond-annual-engagement-survey, replace-gut-feel-talent-decisions, ….
输入模式
{
"type": "object",
"properties": {
"slug": {
"type": "string",
"description": "Answer slug from the query map (e.g. survey-validity-check)."
}
},
"required": [
"slug"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}输出模式
{
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"title": {
"type": "string"
},
"canonicalUrl": {
"type": "string"
},
"question": {
"type": "string"
},
"answer": {
"type": "string"
},
"citations": {
"type": "array",
"items": {
"type": "object",
"properties": {
"title": {
"type": "string"
},
"url": {
"type": "string"
},
"libraryId": {
"type": "string"
}
},
"required": [
"title"
],
"additionalProperties": false
}
},
"updatedAt": {
"type": "string"
}
},
"required": [
"slug",
"title",
"canonicalUrl",
"question",
"answer",
"citations",
"updatedAt"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_product_description(product)
Machine-readable description of each PeopleAnalyst product. Versioned, CORS-open descriptions of every product in the portfolio — name, category, oneLiner, problemFrames, capabilities, beachheads, whenNotToUse (honest disqualifiers), canonicalUrls, relatedProducts. Assembled from canon. Pass ?product to filter.
输入模式
{
"type": "object",
"properties": {
"product": {
"type": "string",
"description": "Filter to one product id (e.g. performix, anycomp, compensation-toolbox)."
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}输出模式
{
"type": "object",
"properties": {
"contract": {
"type": "string"
},
"filter": {
"type": "object",
"properties": {
"product": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"product"
],
"additionalProperties": false
},
"count": {
"type": "number"
},
"products": {
"type": "array",
"items": {
"type": "object",
"properties": {
"product": {
"type": "string"
},
"name": {
"type": "string"
},
"category": {
"type": "string"
},
"oneLiner": {
"type": "string"
},
"problemFrames": {
"type": "array",
"items": {
"type": "string"
}
},
"capabilities": {
"type": "array",
"items": {
"type": "string"
}
},
"beachheads": {
"type": "array",
"items": {
"type": "string"
}
},
"whenNotToUse": {
"type": "array",
"items": {
"type": "string"
}
},
"canonicalUrls": {
"type": "array",
"items": {
"type": "string"
}
},
"relatedProducts": {
"type": "array",
"items": {
"type": "string"
}
},
"status": {
"type": "string"
}
},
"required": [
"product",
"name",
"category",
"oneLiner",
"problemFrames",
"capabilities",
"beachheads",
"whenNotToUse",
"canonicalUrls",
"relatedProducts",
"status"
],
"additionalProperties": false
}
}
},
"required": [
"contract",
"filter",
"products"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_marketing_registry(product, status)
The Pitboss marketing-asset registry (typed cards + personas). Cross-site marketing-asset cards built from the portfolio's brandscripts and proofs, plus the persona set. ?product filters to one product; ?status filters by lifecycle.
输入模式
{
"type": "object",
"properties": {
"product": {
"type": "string",
"description": "Filter cards to one product."
},
"status": {
"type": "string",
"description": "Filter by lifecycle (e.g. live, draft)."
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}输出模式
{
"type": "object",
"properties": {
"built_at": {
"type": "string"
},
"contract": {
"type": "string"
},
"filter": {
"type": "object",
"properties": {
"product": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"status": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"product",
"status"
],
"additionalProperties": false
},
"counts": {
"type": "object",
"properties": {
"cards": {
"type": "number"
},
"personas": {
"type": "number"
}
},
"required": [
"cards",
"personas"
],
"additionalProperties": false
},
"cards": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"product": {
"type": "string"
},
"status": {
"type": "string"
}
},
"required": [
"id"
],
"additionalProperties": {}
}
},
"personas": {
"type": "array",
"items": {}
}
},
"required": [
"built_at",
"contract",
"filter",
"counts",
"cards",
"personas"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_brandscripts(product, persona, status)
Per-persona StoryBrand arguments for each product. The persona-level argument layer (SB7-shaped): the major problem solved for a persona and what the solution looks like. ?product / ?persona filter; ?status opts into drafts.
输入模式
{
"type": "object",
"properties": {
"product": {
"type": "string",
"description": "Filter to one product's arguments."
},
"persona": {
"type": "string",
"description": "Filter to one persona slug."
},
"status": {
"type": "string",
"enum": [
"live",
"draft",
"all"
],
"description": "live (default) | draft | all."
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}输出模式
{
"type": "object",
"properties": {
"contract": {
"type": "string"
},
"filter": {
"type": "object",
"properties": {
"product": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"persona": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"status": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"product",
"persona",
"status"
],
"additionalProperties": false
},
"count": {
"type": "number"
},
"brandscripts": {
"type": "array",
"items": {
"type": "object",
"properties": {
"product": {
"type": "string"
},
"persona": {
"type": "string"
},
"personaLabel": {
"type": "string"
},
"status": {
"type": "string",
"enum": [
"live",
"draft"
]
},
"logline": {
"type": "string"
},
"character": {
"type": "string"
},
"problem": {
"type": "object",
"properties": {
"external": {
"type": "string"
},
"internal": {
"type": "string"
},
"philosophical": {
"type": "string"
}
},
"required": [
"external",
"internal",
"philosophical"
],
"additionalProperties": false
},
"guide": {
"type": "object",
"properties": {
"empathy": {
"type": "string"
},
"authority": {
"type": "string"
}
},
"required": [
"empathy",
"authority"
],
"additionalProperties": false
},
"plan": {
"type": "array",
"items": {
"type": "string"
}
},
"callToAction": {
"type": "object",
"properties": {
"direct": {
"type": "string"
},
"transitional": {
"type": "string"
}
},
"required": [
"direct"
],
"additionalProperties": false
},
"success": {
"type": "string"
},
"failure": {
"type": "string"
},
"products": {
"type": "array",
"items": {
"type": "string"
}
},
"cards": {
"type": "array",
"items": {
"type": "string"
}
},
"navLabel": {
"type": "string"
},
"teaser": {
"type": "string"
},
"seo": {
"type": "object",
"properties": {
"metaTitle": {
"type": "string"
},
"metaDescription": {
"type": "string"
}
},
"required": [
"metaTitle",
"metaDescription"
],
"additionalProperties": false
},
"order": {
"type": "number"
},
"proves": {
"type": "array",
"items": {
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"title": {
"type": "string"
},
"navLabel": {
"type": "string"
},
"customerPitch": {
"type": "string"
}
},
"required": [
"slug",
"title",
"navLabel",
"customerPitch"
],
"additionalProperties": false
}
},
"stories": {
"type": "array",
"items": {
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"name": {
"type": "string"
},
"logline": {
"type": "string"
},
"occasion": {
"type": "string"
},
"problemTags": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"slug",
"name",
"logline",
"occasion",
"problemTags"
],
"additionalProperties": false
}
},
"problemTags": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"product",
"persona",
"personaLabel",
"status",
"logline",
"character",
"problem",
"guide",
"plan",
"callToAction",
"success",
"failure",
"products",
"cards",
"navLabel",
"teaser",
"seo",
"order",
"proves",
"stories",
"problemTags"
],
"additionalProperties": false
}
}
},
"required": [
"contract",
"filter",
"count",
"brandscripts"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_story_tracks(persona, problem, metric, slug)
Pre-authored data-story tracks — the possibility space. Complete data stories: the SB7 argument, the acts and beats that carry it, the branches it forks down, the decision it produces, and the data required to test it. Candidates only — nothing here asserts a story is true of any organisation; that is decided against data. ?persona / ?problem / ?metric / ?slug filter.
输入模式
{
"type": "object",
"properties": {
"persona": {
"type": "string",
"description": "Candidate stories for one persona (registry prefixes and aliases are normalized)."
},
"problem": {
"type": "string",
"description": "Filter by problem tag, e.g. regretted-attrition."
},
"metric": {
"type": "string",
"description": "Filter by metric tag, e.g. attrition."
},
"slug": {
"type": "string",
"description": "Fetch a single story track."
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}输出模式
{
"type": "object",
"properties": {
"contract": {
"type": "string"
},
"note": {
"type": "string"
},
"filter": {
"type": "object",
"properties": {
"persona": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"personaResolved": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"problem": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"metric": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"persona",
"personaResolved",
"problem",
"metric",
"slug"
],
"additionalProperties": false
},
"count": {
"type": "number"
},
"stories": {
"type": "array",
"items": {
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"name": {
"type": "string"
},
"logline": {
"type": "string"
},
"occasion": {
"type": "string"
},
"hero": {
"type": "string"
},
"drivingQuestion": {
"type": "string"
},
"personas": {
"type": "array",
"items": {
"type": "string"
}
},
"problemTags": {
"type": "array",
"items": {
"type": "string"
}
},
"cast": {
"type": "object",
"properties": {
"metricTags": {
"type": "array",
"items": {
"type": "string"
}
},
"populations": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"metricTags",
"populations"
],
"additionalProperties": false
},
"brandscript": {
"type": "object",
"properties": {
"character": {
"type": "object",
"properties": {
"who": {
"type": "string"
},
"wants": {
"type": "string"
}
},
"required": [
"who",
"wants"
],
"additionalProperties": false
},
"problem": {
"type": "object",
"properties": {
"villain": {
"type": "string"
},
"external": {
"type": "string"
},
"internal": {
"type": "string"
},
"philosophical": {
"type": "string"
}
},
"required": [
"villain",
"external",
"internal",
"philosophical"
],
"additionalProperties": false
},
"guide": {
"type": "object",
"properties": {
"empathy": {
"type": "string"
},
"authority": {
"type": "string"
}
},
"required": [
"empathy",
"authority"
],
"additionalProperties": false
},
"plan": {
"type": "array",
"items": {
"type": "string"
}
},
"callToAction": {
"type": "object",
"properties": {
"direct": {
"type": "string"
},
"transitional": {
"type": "string"
}
},
"required": [
"direct"
],
"additionalProperties": false
},
"failure": {
"type": "string"
},
"success": {
"type": "object",
"properties": {
"outcome": {
"type": "string"
},
"transformation": {
"type": "string"
}
},
"required": [
"outcome",
"transformation"
],
"additionalProperties": false
}
},
"required": [
"character",
"problem",
"guide",
"plan",
"callToAction",
"failure",
"success"
],
"additionalProperties": false
},
"acts": {
"type": "array",
"items": {
"type": "object",
"properties": {
"title": {
"type": "string"
},
"purpose": {
"type": "string"
},
"beats": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"archetype": {
"type": "string"
},
"transition": {
"type": "string"
},
"subQuestion": {
"type": "string"
},
"role": {
"type": "string"
},
"acceptCards": {
"type": "array",
"items": {
"type": "string"
}
},
"acceptForms": {
"type": "array",
"items": {
"type": "string"
}
},
"handle": {
"type": "string"
}
},
"required": [
"id",
"archetype",
"transition",
"subQuestion",
"role",
"acceptCards",
"acceptForms",
"handle"
],
"additionalProperties": false
}
}
},
"required": [
"title",
"purpose",
"beats"
],
"additionalProperties": false
}
},
"branches": {
"type": "array",
"items": {
"type": "object",
"properties": {
"afterBeat": {
"type": "string"
},
"condition": {
"type": "string"
},
"thenBeats": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"archetype": {
"type": "string"
},
"transition": {
"type": "string"
},
"subQuestion": {
"type": "string"
},
"opens": {
"type": "object",
"properties": {
"acceptCards": {
"type": "array",
"items": {
"type": "string"
}
},
"acceptForms": {
"type": "array",
"items": {
"type": "string"
}
},
"role": {
"type": "string"
}
},
"required": [
"acceptCards",
"role"
],
"additionalProperties": false
},
"supports": {
"type": "array",
"items": {
"type": "object",
"properties": {
"acceptCards": {
"type": "array",
"items": {
"type": "string"
}
},
"acceptForms": {
"type": "array",
"items": {
"type": "string"
}
},
"role": {
"type": "string"
}
},
"required": [
"acceptCards",
"role"
],
"additionalProperties": false
}
},
"handle": {
"type": "string"
}
},
"required": [
"id",
"archetype",
"transition",
"subQuestion",
"opens",
"handle"
],
"additionalProperties": false
}
},
"elseGoTo": {
"type": "object",
"properties": {
"storySlug": {
"type": "string"
},
"note": {
"type": "string"
}
},
"required": [
"storySlug",
"note"
],
"additionalProperties": false
}
},
"required": [
"afterBeat",
"condition"
],
"additionalProperties": false
}
},
"resolution": {
"type": "string"
},
"close": {
"type": "object",
"properties": {
"question": {
"type": "string"
},
"nextSteps": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"question",
"nextSteps"
],
"additionalProperties": false
},
"dataRequirements": {
"type": "array",
"items": {
"type": "string"
}
},
"altitudes": {
"anyOf": [
{
"type": "object",
"properties": {
"exec": {
"type": "string"
},
"director": {
"type": "string"
},
"manager": {
"type": "string"
},
"analyst": {
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"provenanceClass": {
"type": "string",
"enum": [
"engagement-replay + framework",
"framework"
]
}
},
"required": [
"slug",
"name",
"logline",
"occasion",
"hero",
"drivingQuestion",
"personas",
"problemTags",
"cast",
"brandscript",
"acts",
"branches",
"resolution",
"close",
"dataRequirements",
"altitudes",
"provenanceClass"
],
"additionalProperties": false
}
}
},
"required": [
"contract",
"note",
"filter",
"count",
"stories"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_scene_templates(persona, focus, form, shape, tier, ...)
Falsifiable scene templates — one claim plus what would make it false. The cards a story is told with. Each declares truth conditions the data can falsify, so a claim survives on evidence rather than assertion. Persona relevance is derived from focus (a stated heuristic). Drafts excluded unless ?status=all.
输入模式
{
"type": "object",
"properties": {
"persona": {
"type": "string",
"description": "Scenes relevant to one persona."
},
"focus": {
"type": "string",
"description": "Spine focus, e.g. regretted-loss, compensation, cross."
},
"form": {
"type": "string",
"description": "Canonical form the scene presents as, e.g. rising."
},
"shape": {
"type": "string",
"description": "Data shape, e.g. series, groups, funnel."
},
"tier": {
"type": "string",
"enum": [
"1",
"2",
"3"
],
"description": "1 descriptive | 2 model-bound | 3 decision/value."
},
"archetype": {
"type": "string",
"description": "Archetype, e.g. trend, where, flow, driver."
},
"id": {
"type": "string",
"description": "Fetch a single scene template."
},
"status": {
"type": "string",
"enum": [
"published",
"all"
],
"description": "published (default) | all."
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}输出模式
{
"type": "object",
"properties": {
"contract": {
"type": "string"
},
"note": {
"type": "string"
},
"filter": {
"type": "object",
"properties": {
"persona": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"focus": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"form": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"shape": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"tier": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"archetype": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"status": {
"type": "string"
}
},
"required": [
"persona",
"focus",
"form",
"shape",
"tier",
"archetype",
"id",
"status"
],
"additionalProperties": false
},
"count": {
"type": "number"
},
"scenes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"logline": {
"type": "string"
},
"focus": {
"type": "string"
},
"archetype": {
"type": "string"
},
"tier": {
"anyOf": [
{
"type": "number",
"const": 1
},
{
"type": "number",
"const": 2
},
{
"type": "number",
"const": 3
}
]
},
"shape": {
"type": "string"
},
"form": {
"type": "string"
},
"metricTags": {
"type": "array",
"items": {
"type": "string"
}
},
"scope": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"conditions": {
"type": "array",
"items": {
"type": "object",
"properties": {
"kind": {
"type": "string"
},
"label": {
"type": "string"
}
},
"required": [
"kind",
"label"
],
"additionalProperties": {}
}
},
"narrative": {
"type": "object",
"properties": {
"problem": {
"type": "string"
},
"why": {
"type": "string"
},
"act": {
"type": "string"
}
},
"required": [
"problem",
"why",
"act"
],
"additionalProperties": false
},
"personas": {
"type": "array",
"items": {
"type": "string"
}
},
"author": {
"anyOf": [
{
"type": "string",
"enum": [
"hand",
"factory",
"harvested"
]
},
{
"type": "null"
}
]
},
"status": {
"type": "string",
"enum": [
"draft",
"validated",
"rejected",
"live"
]
},
"model": {
"anyOf": [
{
"type": "object",
"properties": {
"ref": {
"type": "string"
},
"provenance": {
"type": "string",
"enum": [
"research_prior",
"historical_regression",
"expert",
"pa-original"
]
}
},
"required": [
"ref",
"provenance"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"instrumentation": {
"type": "array",
"items": {
"type": "string"
}
},
"corpusSalience": {
"anyOf": [
{
"type": "object",
"properties": {
"available": {
"type": "boolean",
"const": true
},
"focus": {
"type": "string"
},
"pairs": {
"type": "number"
},
"works": {
"type": "number"
},
"singleWorkPairs": {
"type": "number"
},
"means": {
"type": "string"
}
},
"required": [
"available",
"focus",
"pairs",
"works",
"singleWorkPairs",
"means"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"available": {
"type": "boolean",
"const": false
},
"focus": {
"type": "string"
},
"reason": {
"type": "string"
}
},
"required": [
"available",
"focus",
"reason"
],
"additionalProperties": false
}
]
}
},
"required": [
"id",
"name",
"logline",
"focus",
"archetype",
"tier",
"shape",
"form",
"metricTags",
"scope",
"conditions",
"narrative",
"personas",
"author",
"status",
"model",
"instrumentation",
"corpusSalience"
],
"additionalProperties": false
}
}
},
"required": [
"contract",
"note",
"filter",
"count",
"scenes"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_canonical_forms(shape)
The canonical form vocabulary — the structural primitive. 7 data shapes and the 33 canonical forms they resolve to. The form is why one engine reads compensation, attrition, funnels and survey data without a per-domain rewrite: the domain is in the metric tag, the structure is here. 'oftenMeans' is a labelled heuristic, never a conclusion.
输入模式
{
"type": "object",
"properties": {
"shape": {
"type": "string",
"enum": [
"series",
"groups",
"distribution",
"pairs",
"funnel",
"composition",
"dist_over_time"
],
"description": "Filter to one shape."
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}输出模式
{
"type": "object",
"properties": {
"contract": {
"type": "string"
},
"note": {
"type": "string"
},
"filter": {
"type": "object",
"properties": {
"shape": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"shapeRecognized": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
}
},
"required": [
"shape",
"shapeRecognized"
],
"additionalProperties": false
},
"shapes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"question": {
"type": "string"
}
},
"required": [
"id",
"name",
"question"
],
"additionalProperties": false
}
},
"count": {
"type": "number"
},
"forms": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"shape": {
"type": "string"
},
"name": {
"type": "string"
},
"looksLike": {
"type": "string"
},
"oftenMeans": {
"type": "string"
},
"shapeName": {
"type": "string"
},
"shapeQuestion": {
"type": "string"
},
"sceneCount": {
"type": "number"
}
},
"required": [
"id",
"shape",
"name",
"looksLike",
"oftenMeans",
"shapeName",
"shapeQuestion",
"sceneCount"
],
"additionalProperties": false
}
}
},
"required": [
"contract",
"note",
"filter",
"shapes",
"count",
"forms"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_claim_warrant(from, to, construct, focus)
How many works discuss a claim — discourse volume, with the works named. For a construct pair mined from the book corpus: how many distinct works discuss the link, and which ones, with each work's stated rationale. ⚠ This is DISCOURSE, not evidence — book frequency is confounded by publication incentives, fashion and citation cascades, so it is reported as 'discussed in N works' and never as corroboration, confidence, or a score. Single-work claims are returned, labelled as such; corroboration is not a gate. No query returns corpus-level stats including a counting discrepancy we state openly.
输入模式
{
"type": "object",
"properties": {
"from": {
"type": "string",
"description": "Source construct, e.g. employee_engagement. Use with `to`."
},
"to": {
"type": "string",
"description": "Target construct, e.g. employee_turnover. Use with `from`."
},
"construct": {
"type": "string",
"description": "Every pair the corpus links this construct to, most-discussed first."
},
"focus": {
"type": "string",
"description": "Discourse volume for one focus area."
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}输出模式
{
"type": "object",
"properties": {
"contract": {
"type": "string"
},
"caveat": {
"type": "string"
},
"query": {
"type": "object",
"properties": {
"from": {
"type": "string"
},
"to": {
"type": "string"
},
"construct": {
"type": "string"
},
"focus": {
"type": "string"
}
},
"additionalProperties": false
},
"found": {
"type": "boolean"
},
"label": {
"type": "string"
},
"warrant": {
"anyOf": [
{
"type": "object",
"properties": {
"from": {
"type": "string"
},
"to": {
"type": "string"
},
"relation": {
"type": "string"
},
"direction": {
"type": "string"
},
"focus": {
"type": "string"
},
"archetype": {
"type": "string"
},
"tier": {
"type": "number"
},
"discussedInWorks": {
"type": "number"
},
"works": {
"type": "array",
"items": {
"type": "object",
"properties": {
"libraryId": {
"type": "string"
},
"title": {
"type": "string"
},
"author": {
"type": "string"
},
"year": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"rationale": {
"type": "string"
},
"resolvedFromLibrary": {
"type": "boolean"
},
"citation": {
"type": "string"
}
},
"required": [
"libraryId",
"title",
"author",
"year",
"rationale",
"resolvedFromLibrary",
"citation"
],
"additionalProperties": false
}
}
},
"required": [
"from",
"to",
"relation",
"direction",
"focus",
"archetype",
"tier",
"discussedInWorks",
"works"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"count": {
"type": "number"
},
"pairs": {
"type": "array",
"items": {
"type": "object",
"properties": {
"from": {
"type": "string"
},
"to": {
"type": "string"
},
"relation": {
"type": "string"
},
"direction": {
"type": "string"
},
"focus": {
"type": "string"
},
"archetype": {
"type": "string"
},
"tier": {
"type": "number"
},
"discussedInWorks": {
"type": "number"
},
"works": {
"type": "array",
"items": {
"type": "object",
"properties": {
"libraryId": {
"type": "string"
},
"title": {
"type": "string"
},
"author": {
"type": "string"
},
"year": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"rationale": {
"type": "string"
},
"resolvedFromLibrary": {
"type": "boolean"
},
"citation": {
"type": "string"
}
},
"required": [
"libraryId",
"title",
"author",
"year",
"rationale",
"resolvedFromLibrary",
"citation"
],
"additionalProperties": false
}
},
"label": {
"type": "string"
}
},
"required": [
"from",
"to",
"relation",
"direction",
"focus",
"archetype",
"tier",
"discussedInWorks",
"works",
"label"
],
"additionalProperties": false
}
},
"salience": {
"anyOf": [
{
"type": "object",
"properties": {
"focus": {
"type": "string"
},
"pairs": {
"type": "number"
},
"works": {
"type": "number"
},
"singleWorkPairs": {
"type": "number"
}
},
"required": [
"focus",
"pairs",
"works",
"singleWorkPairs"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"stats": {
"type": "object",
"properties": {
"pairs": {
"type": "number"
},
"constructs": {
"type": "number"
},
"works": {
"type": "number"
},
"pairsOnOneWork": {
"type": "number"
},
"pairsOnTwoOrMoreWorks": {
"type": "number"
},
"storedTwoPlusTotal": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"required": [
"pairs",
"constructs",
"works",
"pairsOnOneWork",
"pairsOnTwoOrMoreWorks",
"storedTwoPlusTotal"
],
"additionalProperties": false
},
"citationCoverage": {
"type": "object",
"properties": {
"distinctWorks": {
"type": "number"
},
"resolvedInLibrary": {
"type": "number"
},
"withAuthor": {
"type": "number"
},
"withYear": {
"type": "number"
},
"fullyCitable": {
"type": "number"
}
},
"required": [
"distinctWorks",
"resolvedInLibrary",
"withAuthor",
"withYear",
"fullyCitable"
],
"additionalProperties": false
},
"citationNote": {
"type": "string"
},
"statsNote": {
"type": "string"
},
"focusSalience": {
"type": "array",
"items": {
"type": "object",
"properties": {
"focus": {
"type": "string"
},
"pairs": {
"type": "number"
},
"works": {
"type": "number"
},
"singleWorkPairs": {
"type": "number"
}
},
"required": [
"focus",
"pairs",
"works",
"singleWorkPairs"
],
"additionalProperties": false
}
}
},
"required": [
"contract",
"caveat"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_library_ids(tag, limit)
Library id export — stable ids for the works homed here. Batch export of library_id rows (id, title, author, year, property tags) for the works that home on peopleanalyst.com. Ids are content-addressed (SHA-256 of normalized title|authors|year) and stable across repos, so a consumer can join to this catalog without string matching. Scoped to works homed here — titles whose canonical home is another property are excluded, matching /library.
输入模式
{
"type": "object",
"properties": {
"tag": {
"type": "string",
"description": "Filter by property tag, e.g. principia."
},
"limit": {
"type": "string",
"description": "Cap the number of rows returned."
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}输出模式
{
"type": "object",
"properties": {
"generated_at": {
"type": "string"
},
"issuer": {
"type": "string"
},
"id_format": {
"type": "string"
},
"spec": {
"type": "string"
},
"scope": {
"type": "string"
},
"inventory_total": {
"type": "number"
},
"excluded_foreign_home": {
"type": "number"
},
"count": {
"type": "number"
},
"records": {
"type": "array",
"items": {
"type": "object",
"properties": {
"library_id": {
"type": "string"
},
"title": {
"type": "string"
},
"author": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"year": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"legacy_pa_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"property_tags": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"library_id",
"title",
"author",
"year",
"property_tags"
],
"additionalProperties": false
}
}
},
"required": [
"generated_at",
"issuer",
"id_format",
"spec",
"scope",
"inventory_total",
"excluded_foreign_home",
"count",
"records"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢run_segmentation(body)
Behavioral segmentation, role discovery, and exemplar matching. Deterministic segmentation over caller-supplied numeric vectors: cluster subjects, discover roles from behaviour + relationship edges, detect emergent roles, or match against exemplars. Structured non-biometric signals only — no audio, video, or affect inference. The caller supplies all data; nothing is retained. Capped at 5,000 rows per request.
输入模式
{
"type": "object",
"properties": {
"body": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {},
"description": "JSON request body accepted by the underlying endpoint."
}
},
"required": [
"body"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}输出模式
{
"type": "object",
"properties": {
"segments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"segment_id": {
"type": "string"
},
"size": {
"type": "number"
},
"centroid": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "number"
}
},
"distinguishing": {
"type": "array",
"items": {
"type": "object",
"properties": {
"dimension": {
"type": "string"
},
"z": {
"type": "number"
}
},
"required": [
"dimension",
"z"
],
"additionalProperties": false
}
},
"members": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"label": {
"type": "string"
},
"distance": {
"type": "number"
}
},
"required": [
"id",
"distance"
],
"additionalProperties": false
}
}
},
"required": [
"segment_id",
"size",
"centroid",
"distinguishing",
"members"
],
"additionalProperties": false
}
},
"dimensions_used": {
"type": "array",
"items": {
"type": "string"
}
},
"dimensions_ignored": {
"type": "array",
"items": {
"type": "string"
}
},
"k": {
"type": "number"
},
"silhouette": {
"type": "number"
},
"provenance": {
"type": "object",
"properties": {
"engine": {
"type": "string",
"const": "segmentation"
},
"method": {
"type": "string",
"const": "kmeans+silhouette"
},
"patent_lineage": {
"type": "string"
},
"generated_at": {
"type": "string"
}
},
"required": [
"engine",
"method",
"patent_lineage",
"generated_at"
],
"additionalProperties": false
},
"roles": {
"type": "array",
"items": {
"type": "object",
"properties": {
"role": {
"type": "string"
},
"segment_id": {
"type": "string"
},
"signature": {
"type": "string"
},
"size": {
"type": "number"
}
},
"required": [
"role",
"segment_id",
"signature",
"size"
],
"additionalProperties": false
}
},
"assignments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"label": {
"type": "string"
},
"role": {
"type": "string"
},
"segment_id": {
"type": "string"
}
},
"required": [
"id",
"role",
"segment_id"
],
"additionalProperties": false
}
},
"segmentation": {
"type": "object",
"properties": {
"segments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"segment_id": {
"type": "string"
},
"size": {
"type": "number"
},
"centroid": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "number"
}
},
"distinguishing": {
"type": "array",
"items": {
"type": "object",
"properties": {
"dimension": {
"type": "string"
},
"z": {
"type": "number"
}
},
"required": [
"dimension",
"z"
],
"additionalProperties": false
}
},
"members": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"label": {
"type": "string"
},
"distance": {
"type": "number"
}
},
"required": [
"id",
"distance"
],
"additionalProperties": false
}
}
},
"required": [
"segment_id",
"size",
"centroid",
"distinguishing",
"members"
],
"additionalProperties": false
}
},
"dimensions_used": {
"type": "array",
"items": {
"type": "string"
}
},
"dimensions_ignored": {
"type": "array",
"items": {
"type": "string"
}
},
"k": {
"type": "number"
},
"silhouette": {
"type": "number"
},
"provenance": {
"type": "object",
"properties": {
"engine": {
"type": "string",
"const": "segmentation"
},
"method": {
"type": "string",
"const": "kmeans+silhouette"
},
"patent_lineage": {
"type": "string"
},
"generated_at": {
"type": "string"
}
},
"required": [
"engine",
"method",
"patent_lineage",
"generated_at"
],
"additionalProperties": false
}
},
"required": [
"segments",
"dimensions_used",
"dimensions_ignored",
"k",
"silhouette",
"provenance"
],
"additionalProperties": false
},
"matches": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"klass": {
"type": "string"
},
"distance": {
"type": "number"
},
"confidence": {
"type": "number"
}
},
"required": [
"id",
"klass",
"distance",
"confidence"
],
"additionalProperties": false
}
},
"features_used": {
"type": "array",
"items": {
"type": "string"
}
},
"features_ignored": {
"type": "array",
"items": {
"type": "string"
}
},
"boundary": {
"type": "object",
"properties": {
"mechanism": {
"type": "string",
"const": "behavioral-feature clustering"
},
"reads_conversational_content": {
"type": "boolean",
"const": false
},
"patent": {
"type": "string"
}
},
"required": [
"mechanism",
"reads_conversational_content",
"patent"
],
"additionalProperties": false
}
},
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢plan_next_data_ask(body)
What data to ask for next, and what it would rule out. The acquisition planner. Given which data-stories are still candidates, returns the single most efficient next question, the full ranked list, and the minimum set of asks that makes every live story testable — split into what can be sent today versus what needs legal review. Ranked by information-per-friction: how evenly an answer splits the live hypothesis set (computed by entropy from the discrimination matrix, never hand-asserted) divided by a cost in which GOVERNANCE outweighs effort. Absent priors all live stories weigh equally, so results reflect structure, not likelihood. GET accepts ?live=, ?have=, ?lack= as comma lists.
输入模式
{
"type": "object",
"properties": {
"body": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {},
"description": "JSON request body accepted by the underlying endpoint."
}
},
"required": [
"body"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}输出模式
{
"type": "object",
"properties": {
"contract": {
"type": "string"
},
"caveat": {
"type": "string"
},
"valueOfInformation": {
"type": "object",
"properties": {
"computedHere": {
"type": "boolean",
"const": false
},
"note": {
"type": "string"
},
"owner": {
"type": "string"
}
},
"required": [
"computedHere",
"note",
"owner"
],
"additionalProperties": false
},
"live": {
"type": "array",
"items": {
"type": "string"
}
},
"nextAsk": {
"anyOf": [
{
"type": "object",
"properties": {
"variable": {
"type": "string"
},
"label": {
"type": "string"
},
"ask": {
"type": "string"
},
"governance": {
"type": "string",
"enum": [
"open",
"internal",
"restricted",
"collect"
]
},
"effort": {
"type": "string",
"enum": [
"trivial",
"low",
"moderate",
"high"
]
},
"availabilitySplitBits": {
"type": "number"
},
"cost": {
"type": "number"
},
"rationale": {
"type": "string"
},
"eliminatedIfAbsent": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"variable",
"label",
"ask",
"governance",
"effort",
"availabilitySplitBits",
"cost",
"rationale",
"eliminatedIfAbsent"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"ranked": {
"type": "array",
"items": {
"type": "object",
"properties": {
"variable": {
"type": "string"
},
"ask": {
"type": "string"
},
"governance": {
"type": "string",
"enum": [
"open",
"internal",
"restricted",
"collect"
]
},
"availabilitySplitBits": {
"type": "number"
},
"cost": {
"type": "number"
},
"splitPerFriction": {
"type": "number"
},
"eliminatedIfAbsent": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"variable",
"ask",
"governance",
"availabilitySplitBits",
"cost",
"splitPerFriction",
"eliminatedIfAbsent"
],
"additionalProperties": false
}
},
"plan": {
"type": "object",
"properties": {
"asks": {
"type": "array",
"items": {
"type": "object",
"properties": {
"variable": {
"type": "string"
},
"label": {
"type": "string"
},
"ask": {
"type": "string"
},
"governance": {
"type": "string",
"enum": [
"open",
"internal",
"restricted",
"collect"
]
},
"effort": {
"type": "string",
"enum": [
"trivial",
"low",
"moderate",
"high"
]
}
},
"required": [
"variable",
"label",
"ask",
"governance",
"effort"
],
"additionalProperties": false
}
},
"totalFriction": {
"type": "number"
},
"sendToday": {
"type": "array",
"items": {
"type": "string"
}
},
"needsLegalOrCollection": {
"type": "array",
"items": {
"type": "string"
}
},
"collectableGaps": {
"type": "array",
"items": {
"type": "object",
"properties": {
"variable": {
"type": "string"
},
"blocks": {
"type": "array",
"items": {
"type": "string"
}
},
"title": {
"type": "string"
},
"population": {
"type": "string"
},
"turnaround": {
"type": "string"
},
"unlocks": {
"type": "string"
},
"caveat": {
"type": "string"
},
"fieldableInstrument": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"deliveryPaths": {
"type": "array",
"items": {
"type": "string",
"enum": [
"kit",
"managed"
]
}
},
"researchInstruments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"id",
"url"
],
"additionalProperties": false
}
},
"shape": {
"type": "object",
"properties": {
"respondents": {
"type": "number"
},
"waves": {
"type": "number"
},
"analysisOnly": {
"type": "boolean"
}
},
"required": [
"respondents",
"waves"
],
"additionalProperties": false
},
"indicativePrice": {
"type": "object",
"properties": {
"path": {
"type": "string",
"enum": [
"diy",
"managed"
]
},
"totalUsd": {
"type": "number"
},
"basis": {
"type": "string"
},
"recommendEnterprise": {
"type": "boolean"
},
"status": {
"type": "string",
"enum": [
"provisional",
"posted"
]
}
},
"required": [
"path",
"totalUsd",
"basis",
"recommendEnterprise",
"status"
],
"additionalProperties": false
},
"diyPrice": {
"type": "object",
"properties": {
"path": {
"type": "string",
"enum": [
"diy",
"managed"
]
},
"totalUsd": {
"type": "number"
},
"basis": {
"type": "string"
},
"recommendEnterprise": {
"type": "boolean"
},
"status": {
"type": "string",
"enum": [
"provisional",
"posted"
]
}
},
"required": [
"path",
"totalUsd",
"basis",
"recommendEnterprise",
"status"
],
"additionalProperties": false
}
},
"required": [
"variable",
"blocks",
"title",
"population",
"turnaround",
"unlocks",
"caveat",
"fieldableInstrument",
"deliveryPaths",
"researchInstruments",
"shape",
"indicativePrice",
"diyPrice"
],
"additionalProperties": false
}
}
},
"required": [
"asks",
"totalFriction",
"sendToday",
"needsLegalOrCollection",
"collectableGaps"
],
"additionalProperties": false
}
},
"required": [
"contract",
"caveat",
"valueOfInformation",
"live",
"nextAsk",
"ranked",
"plan"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_insight_cards(pitch, awareness)
A pitch rendered as player-ready InsightCards. Serves a named pitch as an ordered InsightCard[] (the cross-site insight-player contract). ?pitch selects the pitch; ?awareness optionally reshapes the sequence for the buyer's awareness state.
输入模式
{
"type": "object",
"properties": {
"pitch": {
"type": "string",
"description": "The pitch slug to render."
},
"awareness": {
"type": "string",
"description": "Awareness state to reshape the sequence."
}
},
"required": [
"pitch"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}输出模式
{
"type": "object",
"properties": {
"contract": {
"type": "string"
},
"count": {
"type": "number"
},
"pitches": {
"type": "array",
"items": {
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"title": {
"type": "string"
},
"situation": {
"type": "string"
},
"audience": {
"type": "string"
},
"personas": {
"type": "array",
"items": {
"type": "string"
}
},
"situationTitle": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"navLabel": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"useCase": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"firstHeadline": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"href": {
"type": "string"
}
},
"required": [
"slug",
"title",
"situation",
"audience",
"personas",
"situationTitle",
"navLabel",
"useCase",
"firstHeadline",
"href"
],
"additionalProperties": false
}
},
"source": {
"type": "string"
},
"cards": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"source_app": {
"type": "string"
},
"audience_tags": {
"type": "array",
"items": {
"type": "string"
}
},
"topic_tags": {
"type": "array",
"items": {
"type": "string"
}
},
"freshness": {
"type": "object",
"properties": {
"computedAt": {
"type": "string"
},
"ttlSeconds": {
"type": "number"
}
},
"required": [
"computedAt"
],
"additionalProperties": false
},
"card_type": {
"type": "string"
},
"headline": {
"type": "string"
},
"body": {
"type": "string"
},
"visual": {
"type": "object",
"properties": {
"kind": {
"type": "string",
"enum": [
"text",
"metric",
"trend",
"chart",
"comparison",
"callout"
]
},
"spec": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"required": [
"kind",
"spec"
],
"additionalProperties": false
},
"reveal": {
"type": "object",
"properties": {
"summary": {
"type": "string"
},
"detail": {
"type": "string"
}
},
"required": [
"summary"
],
"additionalProperties": false
},
"signals_requested": {
"type": "array",
"items": {
"type": "object",
"properties": {
"signalId": {
"type": "string"
},
"prompt": {
"type": "string"
}
},
"required": [
"signalId",
"prompt"
],
"additionalProperties": false
}
}
},
"required": [
"id",
"source_app",
"audience_tags",
"topic_tags",
"freshness",
"card_type",
"headline",
"body",
"visual"
],
"additionalProperties": false
}
}
},
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_situations(product, status)
Demonstration scenarios (discovered → diagnosed → solved). The proof layer paired with brandscripts: concrete situations a product resolves. ?product filters; ?status opts into drafts.
输入模式
{
"type": "object",
"properties": {
"product": {
"type": "string",
"description": "Filter to one product."
},
"status": {
"type": "string",
"enum": [
"live",
"draft",
"all"
],
"description": "live (default) | draft | all."
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}输出模式
{
"type": "object",
"properties": {
"contract": {
"type": "string"
},
"filter": {
"type": "object",
"properties": {
"status": {
"type": "string"
},
"product": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"status",
"product"
],
"additionalProperties": false
},
"count": {
"type": "number"
},
"situations": {
"type": "array",
"items": {
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"status": {
"type": "string",
"enum": [
"live",
"draft"
]
},
"title": {
"type": "string"
},
"useCase": {
"type": "string"
},
"navLabel": {
"type": "string"
},
"personas": {
"type": "array",
"items": {
"type": "string"
}
},
"grammars": {
"type": "array",
"items": {
"type": "string"
}
},
"teaser": {
"type": "string"
},
"presentingProblem": {
"type": "string"
},
"bindingConstraint": {
"type": "object",
"properties": {
"condition": {
"type": "string",
"enum": [
"capability",
"alignment",
"motivation",
"support"
]
},
"oneLine": {
"type": "string"
}
},
"required": [
"condition",
"oneLine"
],
"additionalProperties": false
},
"profile": {
"type": "object",
"properties": {
"eyebrow": {
"type": "string"
},
"headline": {
"type": "string"
},
"forWho": {
"type": "string"
},
"finds": {
"type": "string"
},
"output": {
"type": "string"
}
},
"required": [
"eyebrow",
"headline",
"forWho",
"finds",
"output"
],
"additionalProperties": false
},
"seo": {
"type": "object",
"properties": {
"metaTitle": {
"type": "string"
},
"metaDescription": {
"type": "string"
}
},
"required": [
"metaTitle",
"metaDescription"
],
"additionalProperties": false
},
"northStar": {
"type": "string"
},
"researchGrounding": {
"type": "array",
"items": {
"type": "string"
}
},
"mockDataSpec": {
"type": "string"
},
"cards": {
"type": "array",
"items": {
"type": "string"
}
},
"products": {
"type": "array",
"items": {
"type": "object",
"properties": {
"product": {
"type": "string"
},
"role": {
"type": "string"
}
},
"required": [
"product",
"role"
],
"additionalProperties": false
}
},
"recipes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"status": {
"type": "string",
"enum": [
"live",
"planned"
]
}
},
"required": [
"name",
"status"
],
"additionalProperties": false
}
},
"order": {
"type": "number"
},
"group": {
"type": "string"
},
"pitches": {
"type": "array",
"items": {
"type": "object",
"properties": {
"grammar": {
"type": "string"
},
"slug": {
"type": "string"
}
},
"required": [
"grammar",
"slug"
],
"additionalProperties": false
}
}
},
"required": [
"slug",
"status",
"title",
"useCase",
"navLabel",
"personas",
"grammars",
"teaser",
"presentingProblem",
"bindingConstraint",
"profile",
"seo",
"northStar",
"researchGrounding",
"mockDataSpec",
"cards",
"products",
"recipes",
"order",
"group",
"pitches"
],
"additionalProperties": false
}
}
},
"required": [
"contract",
"filter",
"count",
"situations"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_tools(category, slug)
The PeopleAnalyst tool catalog (corpus-grounded acting tools). Machine-readable catalog of every corpus-grounded acting tool — name, category, what it does, inputs/outputs, concrete use cases, the profile URL, and how to run it (auth-gated REST + MCP). Last production probe (2026-09-23) reported grounded: true. Discovery is open (find + cite the tools); execution is API-key gated. ?category filters by family; ?slug returns one tool.
输入模式
{
"type": "object",
"properties": {
"category": {
"type": "string",
"description": "Filter by family (e.g. Marketing, Startup & strategy, Software engineering)."
},
"slug": {
"type": "string",
"description": "Return a single tool by slug (e.g. positioning)."
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}输出模式
{
"type": "object",
"properties": {
"contract": {
"type": "string"
},
"filter": {
"type": "object",
"properties": {
"category": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"category",
"slug"
],
"additionalProperties": false
},
"count": {
"type": "number"
},
"grounding": {
"type": "object",
"properties": {
"reports": {
"type": "boolean",
"const": true
},
"production": {
"type": "object",
"properties": {
"grounded": {
"type": "boolean"
},
"constructs": {
"type": "number"
},
"books": {
"type": "number"
},
"unavailable_reason": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"probedAt": {
"type": "string"
},
"service": {
"type": "string"
}
},
"required": [
"grounded",
"constructs",
"books",
"unavailable_reason",
"probedAt",
"service"
],
"additionalProperties": false
},
"note": {
"type": "string"
}
},
"required": [
"reports",
"production",
"note"
],
"additionalProperties": false
},
"reliability": {
"type": "object",
"properties": {
"kind": {
"type": "string",
"const": "one_model_pass"
},
"label": {
"type": "string"
},
"meaning": {
"type": "string"
},
"raise": {
"type": "string"
},
"note": {
"type": "string"
}
},
"required": [
"kind",
"label",
"meaning",
"raise",
"note"
],
"additionalProperties": false
},
"tools": {
"type": "array",
"items": {
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"name": {
"type": "string"
},
"category": {
"type": "string"
},
"description": {
"type": "string"
},
"approach": {
"type": "string"
},
"inputs": {
"type": "string"
},
"outputs": {
"type": "string"
},
"useCases": {
"type": "array",
"items": {
"type": "string"
}
},
"profileUrl": {
"type": "string"
},
"run": {
"type": "object",
"properties": {
"rest": {
"type": "string"
},
"mcpTools": {
"type": "array",
"items": {
"type": "string"
}
},
"auth": {
"type": "string",
"const": "api-key"
}
},
"required": [
"rest",
"mcpTools",
"auth"
],
"additionalProperties": false
},
"hasExample": {
"type": "boolean"
}
},
"required": [
"slug",
"name",
"category",
"description",
"approach",
"inputs",
"outputs",
"useCases",
"profileUrl",
"run",
"hasExample"
],
"additionalProperties": false
}
}
},
"required": [
"contract",
"filter",
"count",
"grounding",
"reliability",
"tools"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}社区
证据
最近观测
已验证未记录版本16 个工具
已验证未记录版本17 个工具