com.peopleanalyst/discovery

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

PeopleAnalyst's free people-analytics feeds: answers, tools, evidence, story and scene catalogs.

Measured statistics

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "discovery": {
      "url": "https://peopleanalyst.com/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (16)

• list_peopleanalyst_feeds read-only

  List PeopleAnalyst's free machine-readable feeds and their MCP/REST availability. OpenAPI is also published at https://peopleanalyst.com/openapi.json.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• list_answers read-only

  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.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_answer read-only

  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, ….

  Parameters:

  • slug (required) — string — Answer slug from the query map (e.g. survey-validity-check).

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_product_description read-only

  Bicycle.LLC product descriptions through the stable PeopleAnalyst feed. 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. Bicycle.LLC owns the company feed; this stable PA route and MCP tool proxy its validated v1 responses. Pass ?product to filter; live nested journeys are the default and ?status=draft|all opts into authoring records.

  Parameters:

  • status — string — Nested journey editorial status: live (default) | draft | all.
  • product — string — Filter to one product id (e.g. performix, anycomp, compensation-toolbox).

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_marketing_registry read-only

  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.

  Parameters:

  • status — string — Filter by lifecycle (e.g. live, draft).
  • product — string — Filter cards to one product.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_brandscripts read-only

  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.

  Parameters:

  • id — string — Select one stable BrandScript id exactly.
  • status — string — live (default) | draft | all.
  • persona — string — Filter to one persona slug.
  • product — string — Filter to one product's arguments.
  • variant — string — Stable goal variant scoped to product + persona; use all three to select exactly.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_story_tracks read-only

  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.

  Parameters:

  • slug — string — Fetch a single story track.
  • metric — string — Filter by metric tag, e.g. attrition.
  • persona — string — Candidate stories for one persona (registry prefixes and aliases are normalized).
  • problem — string — Filter by problem tag, e.g. regretted-attrition.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_scene_templates read-only

  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.

  Parameters:

  • id — string — Fetch a single scene template.
  • form — string — Canonical form the scene presents as, e.g. rising.
  • tier — string — 1 descriptive | 2 model-bound | 3 decision/value.
  • focus — string — Spine focus, e.g. regretted-loss, compensation, cross.
  • shape — string — Data shape, e.g. series, groups, funnel.
  • status — string — published (default) | all.
  • persona — string — Scenes relevant to one persona.
  • archetype — string — Archetype, e.g. trend, where, flow, driver.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_canonical_forms read-only

  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.

  Parameters:

  • shape — string — Filter to one shape.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_claim_warrant read-only

  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.

  Parameters:

  • to — string — Target construct, e.g. employee_turnover. Use with `from`.
  • from — string — Source construct, e.g. employee_engagement. Use with `to`.
  • focus — string — Discourse volume for one focus area.
  • construct — string — Every pair the corpus links this construct to, most-discussed first.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_library_ids read-only

  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.

  Parameters:

  • tag — string — Filter by property tag, e.g. principia.
  • limit — string — Cap the number of rows returned.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• run_segmentation read-only

  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.

  Parameters:

  • body (required) — object — JSON request body accepted by the underlying endpoint.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• plan_next_data_ask read-only

  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.

  Parameters:

  • body (required) — object — JSON request body accepted by the underlying endpoint.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_insight_cards read-only

  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.

  Parameters:

  • pitch (required) — string — The pitch slug to render.
  • awareness — string — Awareness state to reshape the sequence.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_situations read-only

  Demonstration scenarios (discovered → diagnosed → solved). The proof layer paired with brandscripts: concrete situations a product resolves. ?product filters; ?status opts into drafts.

  Parameters:

  • status — string — live (default) | draft | all.
  • product — string — Filter to one product.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_tools read-only

  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.

  Parameters:

  • slug — string — Return a single tool by slug (e.g. positioning).
  • category — string — Filter by family (e.g. Marketing, Startup & strategy, Software engineering).

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

Publisher website Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.