Agents Index

Principia

Online

Source-graded registry of organizational measurement: constructs, priors, instruments, citations.

Visit publisherConnectJSON

What it can do: 36 tools

  • principia.constructs.list read-onlyList canonical constructs (resolved CanonicalVariable rows). Supports limit/offset, engagement_family_only, and abstraction_level (PRN-271).
  • principia.constructs.lookup read-onlyLookup one canonical construct by id (a canonical variable_id, e.g. VAR_000376). Unknown ids return found:false (soft validation).
  • principia.constructs.search read-onlyKeyword search over construct name + definition + alternative_names + variable_codes. Argument is `q` (not `query`).
  • principia.constructs.resolve read-onlyResolve a source-side construct {name, definition?, variable_code?} against the canonical store. READ-ONLY — does not mutate. Uses meta-factory's matcher (name@0.9 / code@0.85 / definition@0.6).
  • principia.instruments.list read-onlyList InstrumentCard rows. Optional construct_id filter narrows to instruments covering a given construct.
  • principia.instruments.lookup read-onlyLookup one instrument by instrument_id. Unknown ids return found:false.
  • principia.instruments.search read-onlyKeyword search over instrument_name + developer + constructs_covered.
  • principia.items.lookup read-onlyLookup one survey item by item_id. SPEC §6/Q4 enforced: items_license != public_domain|open returns status:'restricted'.
  • principia.items.search read-onlySearch items by text. Restricted items (proprietary instruments) are returned with text fields stripped; restricted_count surfaces how many.
  • principia.citations.lookup read-onlyLookup one citation by id OR doi. Scans both id-keyed and doi-keyed candidates.
  • principia.citations.search read-onlyKeyword search over title + apa_reference + doi + authors.
  • principia.measures.list read-onlyList Measure rows. entity_kind filter selects scientific_construct vs operational_metric.
  • principia.measures.lookup read-onlyLookup one Measure by measure_id. Unknown ids return found:false.
  • principia.constructs.measures read-onlyReturn instruments that measure a given construct, ranked by composite score (reliability + validity + literature usage + recency). Optional filters: min_reliability, cross_cultural_only, length_lte. Read-only — no mutat
  • principia.models.list read-onlyList Model rows (theoretical / structural frameworks).
  • principia.models.lookup read-onlyLookup one Model by model_id. Unknown ids return found:false.
  • principia.models.search read-onlyKeyword search over model_name + description.
  • principia.effects.search read-onlySearch EffectSize rows by from/to/statistic_type. Each returned value's observed/corrected basis is named per EFFECT_ESTIMATE_GLOSSARY (@people-analyst/measurement-core) — PRN-N1013-M4; a row with no typed estimates bloc
  • principia.evidence.for read-onlyReturn Evidence[] edges that name a given entity_id as the claim subject.
  • principia.evidence_statements.search read-onlySearch owned, OA-sourced, attributed, stance-classified evidence quotes for a construct→construct relationship (from/to), or any statement naming a single construct. Filters: stance, displayable_only. The display layer f
  • principia.canonical_priors.lookup read-onlyLookup a synthesized Bayesian prior by id OR (from_construct_id, predicate, to_construct_id). Empty until PRN-021 synthesis engine ships. PRN-N1013-M4: a prior's r pools observed and corrected contributing effects withou
  • principia.priors.moderators read-onlyOne canonical prior's moderator groups (`moderated_by[]`, levels in level order, marginal level named) plus the served-prior content ETag. Same ETag the REST route /api/v1/priors/<from>/<predicate>/<to> sends. Unmoderate
  • principia.canonical_priors.search read-onlySearch canonical priors by from/predicate/to. Empty until PRN-021 synthesis engine ships.
  • principia.theoretical_models.list read-onlyList canonical theoretical models (JD-R, COR, SDT, AET, JCM, Goal-Setting, Equity, Two-Factor, etc.). Sorted by foundational publication year. Read-only.
  • principia.theoretical_models.lookup read-onlyLook up one CanonicalTheoreticalModel by id (e.g., theory.jd_r). Returns the theory's canonical constructs, canonical relations (with predicates), descendant per-study models, and foundational citations.
  • principia.theoretical_models.search read-onlySearch theoretical models by keyword over name/summary/constructs. Optional filters: invokes_construct_id (theories that invoke a specific construct), field_domain (classification axis).
  • principia.equivalences.lookup read-onlyLook up InstrumentEquivalence rows by `id` OR by the canonical tuple (`construct_id` + `instrument_a` + `instrument_b` [+ optional `mapping_method`]). Pair ordering is normalized server-side so (Q12, UWES-9) and (UWES-9,
  • principia.equivalences.search read-onlySearch InstrumentEquivalence rows by `construct_id` and/or `instrument_id`. `instrument_id` matches either side of the pair. Optional `mapping_method` filter.
  • principia.critiques.lookup read-onlyLook up one MethodologyCritique by `critique_id`. Returns `{matches, total, note?}` — array-shaped for parity with equivalences. Matches list contains 0 or 1 element.
  • principia.critiques.search read-onlySearch MethodologyCritique rows by composite filter (`subject_id`, `subject_type`, `critique_type`, `severity`). All filters AND together; any subset of the four is valid. Read-only (curator-policy D4).
  • principia.canonical_items.list read-onlyList CanonicalSurveyItem rows (PRN-050 item-level dedup spine). Each row aggregates one normalized item stem across N source instruments via source_items[].
  • principia.canonical_items.lookup read-onlyLookup one CanonicalSurveyItem by canonical_item_id (e.g., CITM_7350938cb42d). Unknown ids return found:false.
  • principia.canonical_items.search read-onlyKeyword search over normalized_text + alternative_texts. Optional instrument_id filter narrows to canonical items whose source_items[] reference that instrument.
  • principia.evidence.trace read-onlyRetrieve the full causal chain from a construct, condition, or problem to interventions, with evidence grades at each hop. problem_id accepts pf.* addresses from the problemframe-2026-v1 frozen registry (cert d0770859) a
  • principia.interventions.lookup read-onlyLook up one Intervention by `intervention_id`, InterventionFrame `frame_node_id` (`ifn_…`) or frame address (`<family>.<class>[.<practice>]`). Returns `{matches, total, note?}` — array-shaped for parity with critiques +
  • principia.interventions.search read-onlySearch Intervention rows by composite filter (`construct_id` — matches when `targets_constructs[]` includes the id; `problem_id` — a ProblemFrame pf.* address, resolved via the MF-711 pf→construct join to one or more con

Connect it

Claude Code
claude mcp add --transport http principia https://peopleprincipia.com/api/mcp
Claude.ai / ChatGPT
Settings → Connectors → Add custom connector
URL: https://peopleprincipia.com/api/mcp
Cursor (~/.cursor/mcp.json)
{
  "mcpServers": {
    "principia": {
      "url": "https://peopleprincipia.com/api/mcp"
    }
  }
}
VS Code (.vscode/mcp.json)
{
  "servers": {
    "principia": {
      "type": "http",
      "url": "https://peopleprincipia.com/api/mcp"
    }
  }
}

Questions

What does Principia do?

Source-graded registry of organizational measurement: constructs, priors, instruments, citations. It exposes 36 tools to AI assistants.

What tools does Principia provide?

36 tools, including principia.constructs.list, principia.constructs.lookup, principia.constructs.search, principia.constructs.resolve, principia.instruments.list, principia.instruments.lookup, principia.instruments.search, principia.items.lookup, principia.items.search, principia.citations.lookup, principia.citations.search, principia.measures.list….

How do I connect Principia to Claude, ChatGPT or Cursor?

Add the remote MCP endpoint https://peopleprincipia.com/api/mcp as a custom connector or MCP server. Copy-paste setup is on this page.

Does Principia require an account or API key?

No sign-in was needed to list its tools. Individual tools may still need an account or API key.

Is Principia online?

As of 2026-11-19 our probe found it online. It answered 100% of our last 3 checks.

Who publishes Principia?

peopleprincipia.com. The official MCP Registry verified that the publisher controls this domain before accepting the listing.

Similar in Web Search & Scraping