discovery
PeopleAnalyst's free people-analytics feeds: answers, tools, evidence, story and scene catalogs.
¿Debería usar esto?
Calidad y seguridad
A
Hallazgos (3)
- HIGHTool poisoning patterns detected
- MEDIUMTool description contains URL to non-standard domainen list_peopleanalyst_feeds
- LOWTool 'get_scene_templates' description lacks action verben get_scene_templates
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
~12,706Tokens (definiciones de herramientas)
~8.7 KBTamaño de respuesta típico
Impacto significativo en la atención (9.93% del contexto de 128k)
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"discovery": {
"url": "https://peopleanalyst.com/mcp"
}
}
}Puntos de conexión remotos
https://peopleanalyst.com/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (16)
🟢 Solo lectura🟡 Escritura🔴 Eliminación⚪ Desconocido
🟢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.
Esquema de entrada
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}Esquema de salida
{
"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.
Esquema de entrada
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}Esquema de salida
{
"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, ….
Esquema de entrada
{
"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#"
}Esquema de salida
{
"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, status)
Machine-readable description of each PeopleAnalyst product. Versioned, CORS-open descriptions of every product in the portfolio — general positioning plus structured personas, goals, problems, journeys, and associated BrandScripts where the product has that canon. Assembled from source records. Pass ?product to filter; live nested journeys are the default and ?status=draft|all opts into authoring records.
Esquema de entrada
{
"type": "object",
"properties": {
"product": {
"type": "string",
"description": "Filter to one product id (e.g. performix, anycomp, compensation-toolbox)."
},
"status": {
"type": "string",
"enum": [
"live",
"draft",
"all"
],
"description": "Nested journey editorial status: live (default) | draft | all."
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}Esquema de salida
{
"type": "object",
"properties": {
"contract": {
"type": "string"
},
"filter": {
"type": "object",
"properties": {
"product": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"status": {
"type": "string",
"enum": [
"live",
"draft",
"all"
]
}
},
"required": [
"product",
"status"
],
"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"
}
},
"personas": {
"type": "array",
"items": {
"type": "object",
"properties": {
"persona": {
"type": "string"
},
"personaLabel": {
"type": "string"
},
"reference": {
"oneOf": [
{
"type": "object",
"properties": {
"status": {
"type": "string",
"const": "resolved"
},
"slug": {
"type": "string"
},
"libraryId": {
"type": "string"
},
"canonicalPersonaId": {
"type": "string"
},
"sourcePersonaLabel": {
"type": "string"
},
"sourcePersonaScope": {
"type": "string"
},
"roleIdentityEvidence": {
"type": "string",
"const": "matched-public-persona-record"
},
"personframeAddress": {
"type": "string"
},
"jobRefs": {
"type": "array",
"items": {
"type": "string"
}
},
"sourceContract": {
"type": "string"
},
"observedAt": {
"type": "string"
}
},
"required": [
"status",
"slug",
"libraryId",
"canonicalPersonaId",
"sourcePersonaLabel",
"sourcePersonaScope",
"roleIdentityEvidence",
"jobRefs",
"sourceContract",
"observedAt"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"status": {
"type": "string",
"const": "unresolved"
},
"requestedRole": {
"type": "string"
},
"reason": {
"type": "string"
},
"reconciliation": {
"type": "string"
},
"sourceContract": {
"type": "string"
},
"observedAt": {
"type": "string"
}
},
"required": [
"status",
"requestedRole",
"reason",
"reconciliation",
"sourceContract",
"observedAt"
],
"additionalProperties": false
}
]
},
"scriptIds": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"persona",
"personaLabel",
"reference",
"scriptIds"
],
"additionalProperties": false
}
},
"goals": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"scriptId": {
"type": "string"
},
"persona": {
"type": "string"
},
"intent": {
"type": "string"
},
"goal": {
"type": "string"
},
"goalProvenance": {
"type": "object",
"properties": {
"source": {
"type": "string",
"const": "mike-approved-jobframe-intent"
},
"personaLibraryGoalValidated": {
"type": "boolean",
"const": false
}
},
"required": [
"source",
"personaLibraryGoalValidated"
],
"additionalProperties": false
},
"editorialStatus": {
"type": "string",
"enum": [
"live",
"draft"
]
},
"capabilityReadiness": {
"type": "string",
"enum": [
"available",
"partial",
"in-development",
"planned",
"future",
"design-only"
]
}
},
"required": [
"id",
"scriptId",
"persona",
"intent",
"goal",
"goalProvenance",
"editorialStatus",
"capabilityReadiness"
],
"additionalProperties": false
}
},
"problems": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"scriptId": {
"type": "string"
},
"persona": {
"type": "string"
},
"external": {
"type": "string"
},
"internal": {
"type": "string"
},
"philosophical": {
"type": "string"
},
"refs": {
"type": "array",
"items": {
"type": "object",
"properties": {
"address": {
"type": "string"
},
"edition": {
"type": "string",
"const": "v1"
},
"slug": {
"type": "string"
},
"slot": {
"type": "string",
"enum": [
"villain",
"external",
"internal",
"philosophical"
]
}
},
"required": [
"address",
"edition"
],
"additionalProperties": false
}
},
"refStatus": {
"oneOf": [
{
"type": "object",
"properties": {
"status": {
"type": "string",
"const": "resolved"
}
},
"required": [
"status"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"status": {
"type": "string",
"const": "unresolved"
},
"reason": {
"type": "string"
},
"reconciliation": {
"type": "string"
}
},
"required": [
"status",
"reason",
"reconciliation"
],
"additionalProperties": false
}
]
}
},
"required": [
"id",
"scriptId",
"persona",
"external",
"internal",
"philosophical",
"refs",
"refStatus"
],
"additionalProperties": false
}
},
"journeys": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"scriptId": {
"type": "string"
},
"persona": {
"type": "string"
},
"facet": {
"type": "string"
},
"intent": {
"type": "string"
},
"goal": {
"type": "string"
},
"goalProvenance": {
"type": "object",
"properties": {
"source": {
"type": "string",
"const": "mike-approved-jobframe-intent"
},
"personaLibraryGoalValidated": {
"type": "boolean",
"const": false
}
},
"required": [
"source",
"personaLibraryGoalValidated"
],
"additionalProperties": false
},
"steps": {
"type": "array",
"items": {
"type": "string"
}
},
"editorialStatus": {
"type": "string",
"enum": [
"live",
"draft"
]
},
"capabilityReadiness": {
"type": "string",
"enum": [
"available",
"partial",
"in-development",
"planned",
"future",
"design-only"
]
},
"action": {
"oneOf": [
{
"type": "object",
"properties": {
"availability": {
"type": "string",
"const": "available"
},
"label": {
"type": "string"
},
"href": {
"type": "string"
}
},
"required": [
"availability",
"label",
"href"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"availability": {
"type": "string",
"const": "intended"
},
"label": {
"type": "string"
}
},
"required": [
"availability",
"label"
],
"additionalProperties": false
}
]
}
},
"required": [
"id",
"scriptId",
"persona",
"facet",
"intent",
"goal",
"goalProvenance",
"steps",
"editorialStatus",
"capabilityReadiness",
"action"
],
"additionalProperties": false
}
},
"associatedScripts": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"persona": {
"type": "string"
},
"variant": {
"type": "string"
},
"primary": {
"type": "boolean"
},
"editorialStatus": {
"type": "string",
"enum": [
"live",
"draft"
]
},
"journeyId": {
"type": "string"
}
},
"required": [
"id",
"persona",
"variant",
"primary",
"editorialStatus",
"journeyId"
],
"additionalProperties": false
}
},
"status": {
"type": "string"
}
},
"required": [
"product",
"name",
"category",
"oneLiner",
"problemFrames",
"capabilities",
"beachheads",
"whenNotToUse",
"canonicalUrls",
"relatedProducts",
"personas",
"goals",
"problems",
"journeys",
"associatedScripts",
"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.
Esquema de entrada
{
"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#"
}Esquema de salida
{
"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, variant, id, status)
Per-persona StoryBrand arguments for each product. The persona × goal argument layer (SB7-shaped). Stable ?id is globally exact; ?product + ?persona + ?variant selects one exact scoped variant, while ?variant alone remains a compatible filter. Live is the default; ?status=draft|all opts into authoring records with capability readiness kept separate.
Esquema de entrada
{
"type": "object",
"properties": {
"product": {
"type": "string",
"description": "Filter to one product's arguments."
},
"persona": {
"type": "string",
"description": "Filter to one persona slug."
},
"variant": {
"type": "string",
"description": "Stable goal variant scoped to product + persona; use all three to select exactly."
},
"id": {
"type": "string",
"description": "Select one stable BrandScript id exactly."
},
"status": {
"type": "string",
"enum": [
"live",
"draft",
"all"
],
"description": "live (default) | draft | all."
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}Esquema de salida
{
"type": "object",
"properties": {
"contract": {
"type": "string"
},
"filter": {
"type": "object",
"properties": {
"product": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"persona": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"variant": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"status": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"product",
"persona",
"variant",
"id",
"status"
],
"additionalProperties": false
},
"count": {
"type": "number"
},
"brandscripts": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"variant": {
"type": "string"
},
"variantExplicit": {
"type": "boolean"
},
"primary": {
"type": "boolean"
},
"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"
}
},
"journey": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"facet": {
"type": "string",
"enum": [
"public",
"job-assist",
"enterprise",
"research"
]
},
"intent": {
"type": "string"
},
"goal": {
"type": "string"
},
"goalProvenance": {
"type": "object",
"properties": {
"source": {
"type": "string",
"const": "mike-approved-jobframe-intent"
},
"personaLibraryGoalValidated": {
"type": "boolean",
"const": false
}
},
"required": [
"source",
"personaLibraryGoalValidated"
],
"additionalProperties": false
},
"personaRef": {
"oneOf": [
{
"type": "object",
"properties": {
"status": {
"type": "string",
"const": "resolved"
},
"slug": {
"type": "string"
},
"libraryId": {
"type": "string"
},
"canonicalPersonaId": {
"type": "string"
},
"sourcePersonaLabel": {
"type": "string"
},
"sourcePersonaScope": {
"type": "string"
},
"roleIdentityEvidence": {
"type": "string",
"const": "matched-public-persona-record"
},
"personframeAddress": {
"type": "string"
},
"jobRefs": {
"type": "array",
"items": {
"type": "string"
}
},
"sourceContract": {
"type": "string"
},
"observedAt": {
"type": "string"
}
},
"required": [
"status",
"slug",
"libraryId",
"canonicalPersonaId",
"sourcePersonaLabel",
"sourcePersonaScope",
"roleIdentityEvidence",
"jobRefs",
"sourceContract",
"observedAt"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"status": {
"type": "string",
"const": "unresolved"
},
"requestedRole": {
"type": "string"
},
"reason": {
"type": "string"
},
"reconciliation": {
"type": "string"
},
"sourceContract": {
"type": "string"
},
"observedAt": {
"type": "string"
}
},
"required": [
"status",
"requestedRole",
"reason",
"reconciliation",
"sourceContract",
"observedAt"
],
"additionalProperties": false
}
]
},
"problemRefs": {
"type": "array",
"items": {
"type": "object",
"properties": {
"address": {
"type": "string"
},
"edition": {
"type": "string",
"const": "v1"
},
"slug": {
"type": "string"
},
"slot": {
"type": "string",
"enum": [
"villain",
"external",
"internal",
"philosophical"
]
}
},
"required": [
"address",
"edition"
],
"additionalProperties": false
}
},
"problemRefStatus": {
"oneOf": [
{
"type": "object",
"properties": {
"status": {
"type": "string",
"const": "resolved"
}
},
"required": [
"status"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"status": {
"type": "string",
"const": "unresolved"
},
"reason": {
"type": "string"
},
"reconciliation": {
"type": "string"
}
},
"required": [
"status",
"reason",
"reconciliation"
],
"additionalProperties": false
}
]
},
"editorialStatus": {
"type": "string",
"enum": [
"live",
"draft"
]
},
"capabilityReadiness": {
"type": "string",
"enum": [
"available",
"partial",
"in-development",
"planned",
"future",
"design-only"
]
},
"action": {
"oneOf": [
{
"type": "object",
"properties": {
"availability": {
"type": "string",
"const": "available"
},
"label": {
"type": "string"
},
"href": {
"type": "string"
}
},
"required": [
"availability",
"label",
"href"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"availability": {
"type": "string",
"const": "intended"
},
"label": {
"type": "string"
}
},
"required": [
"availability",
"label"
],
"additionalProperties": false
}
]
},
"sourceRefs": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"id",
"facet",
"intent",
"goal",
"goalProvenance",
"personaRef",
"problemRefs",
"problemRefStatus",
"editorialStatus",
"capabilityReadiness",
"action",
"sourceRefs"
],
"additionalProperties": false
},
"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": [
"id",
"variant",
"variantExplicit",
"primary",
"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.
Esquema de entrada
{
"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#"
}Esquema de salida
{
"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.
Esquema de entrada
{
"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#"
}Esquema de salida
{
"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.
Esquema de entrada
{
"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#"
}Esquema de salida
{
"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.
Esquema de entrada
{
"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#"
}Esquema de salida
{
"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.
Esquema de entrada
{
"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#"
}Esquema de salida
{
"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.
Esquema de entrada
{
"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#"
}Esquema de salida
{
"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.
Esquema de entrada
{
"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#"
}Esquema de salida
{
"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.
Esquema de entrada
{
"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#"
}Esquema de salida
{
"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.
Esquema de entrada
{
"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#"
}Esquema de salida
{
"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.
Esquema de entrada
{
"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#"
}Esquema de salida
{
"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
}Comunidad
Evidencia
Observaciones recientes
verificadoversión no registrada16 herramientas
verificadoversión no registrada16 herramientas
verificadoversión no registrada17 herramientas