discovery
PeopleAnalyst's free people-analytics feeds: answers, tools, evidence, story and scene catalogs.
Sollte ich dies verwenden
Qualität und Sicherheit
A
Befunde (3)
- HIGHTool poisoning patterns detected
- MEDIUMTool description contains URL to non-standard domainin list_peopleanalyst_feeds
- LOWTool 'get_scene_templates' description lacks action verbin get_scene_templates
Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.
Kontextkosten
~12,706Tokens (Tool-Definitionen)
~8.7 KBTypische Antwortgröße
Erhebliche Auswirkung auf die Aufmerksamkeit (9.93% von 128k Kontext)
Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.
Installieren
Installation mit einem Klick
Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:
{
"mcpServers": {
"discovery": {
"url": "https://peopleanalyst.com/mcp"
}
}
}Remote-Endpunkte
https://peopleanalyst.com/mcpstreamable-httpWas es kann
Tool-Inventar
Tools (16)
🟢 Nur lesen🟡 Schreiben🔴 Löschen⚪ Unbekannt
🟢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.
Eingabe-Schema
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}Ausgabe-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.
Eingabe-Schema
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}Ausgabe-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, ….
Eingabe-Schema
{
"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#"
}Ausgabe-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, 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.
Eingabe-Schema
{
"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#"
}Ausgabe-Schema
{
"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.
Eingabe-Schema
{
"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#"
}Ausgabe-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, 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.
Eingabe-Schema
{
"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#"
}Ausgabe-Schema
{
"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.
Eingabe-Schema
{
"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#"
}Ausgabe-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.
Eingabe-Schema
{
"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#"
}Ausgabe-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.
Eingabe-Schema
{
"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#"
}Ausgabe-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.
Eingabe-Schema
{
"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#"
}Ausgabe-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.
Eingabe-Schema
{
"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#"
}Ausgabe-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.
Eingabe-Schema
{
"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#"
}Ausgabe-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.
Eingabe-Schema
{
"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#"
}Ausgabe-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.
Eingabe-Schema
{
"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#"
}Ausgabe-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.
Eingabe-Schema
{
"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#"
}Ausgabe-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.
Eingabe-Schema
{
"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#"
}Ausgabe-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
}Community
Nachweis
Aktuelle Beobachtungen
verifiziertVersion nicht aufgezeichnet16 Tools
verifiziertVersion nicht aufgezeichnet16 Tools
verifiziertVersion nicht aufgezeichnet17 Tools