Principia

Last 30 days

Uptime

100%

Response time

431 ms typical, 431 ms slowest 5%

Last check

30 min ago

Next check

in 5 h

How to call it

Add it to any MCP client that supports remote servers.

{
  "mcpServers": {
    "principia": {
      "type": "http",
      "url": "https://peopleprincipia.com/api/mcp"
    }
  }
}

35 tools

• principia.constructs.list

  List canonical constructs (resolved CanonicalVariable rows). Supports limit/offset, engagement_family_only, and abstraction_level (PRN-271).

• principia.constructs.lookup

  Lookup one canonical construct by id (a canonical variable_id, e.g. VAR_000376). Unknown ids return found:false (soft validation).

• principia.constructs.search

  Keyword search over construct name + definition + alternative_names + variable_codes. Argument is `q` (not `query`).

• principia.constructs.resolve

  Resolve a source-side construct {name, definition?, variable_code?} against the canonical store. READ-ONLY — does not mutate. Uses meta-factory's matcher ([email protected] / [email protected] / [email protected]).

• principia.instruments.list

  List InstrumentCard rows. Optional construct_id filter narrows to instruments covering a given construct.

• principia.instruments.lookup

  Lookup one instrument by instrument_id. Unknown ids return found:false.

• principia.instruments.search

  Keyword search over instrument_name + developer + constructs_covered.

• principia.items.lookup

  Lookup one survey item by item_id. SPEC §6/Q4 enforced: items_license != public_domain|open returns status:'restricted'.

• principia.items.search

  Search items by text. Restricted items (proprietary instruments) are returned with text fields stripped; restricted_count surfaces how many.

• principia.citations.lookup

  Lookup one citation by id OR doi. Scans both id-keyed and doi-keyed candidates.

• principia.citations.search

  Keyword search over title + apa_reference + doi + authors.

• principia.measures.list

  List Measure rows. entity_kind filter selects scientific_construct vs operational_metric.

• principia.measures.lookup

  Lookup one Measure by measure_id. Unknown ids return found:false.

• principia.constructs.measures

  Return 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 mutation (curator-policy D4).

• principia.models.list

  List Model rows (theoretical / structural frameworks).

• principia.models.lookup

  Lookup one Model by model_id. Unknown ids return found:false.

• principia.models.search

  Keyword search over model_name + description.

• principia.effects.search

  Search EffectSize rows by from/to/statistic_type.

• principia.evidence.for

  Return Evidence[] edges that name a given entity_id as the claim subject.

• principia.evidence_statements.search

  Search 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 for the metric profile page + book.

• principia.canonical_priors.lookup

  Lookup a synthesized Bayesian prior by id OR (from_construct_id, predicate, to_construct_id). Empty until PRN-021 synthesis engine ships.

• principia.canonical_priors.search

  Search canonical priors by from/predicate/to. Empty until PRN-021 synthesis engine ships.

• principia.theoretical_models.list

  List 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

  Look 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

  Search 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

  Look 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, Q12) resolve to the same row. Returns `{matches, total, not

• principia.equivalences.search

  Search InstrumentEquivalence rows by `construct_id` and/or `instrument_id`. `instrument_id` matches either side of the pair. Optional `mapping_method` filter.

• principia.critiques.lookup

  Look 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

  Search 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

  List 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

  Lookup one CanonicalSurveyItem by canonical_item_id (e.g., CITM_7350938cb42d). Unknown ids return found:false.

• principia.canonical_items.search

  Keyword search over normalized_text + alternative_texts. Optional instrument_id filter narrows to canonical items whose source_items[] reference that instrument.

• principia.evidence.trace

  Retrieve 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) and resolves construct mappings via the MF-711 pf→construct j

• principia.interventions.lookup

  Look up one Intervention by `intervention_id`. Returns `{matches, total, note?}` — array-shaped for parity with critiques + equivalences. Matches list contains 0 or 1 element.

• principia.interventions.search

  Search 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 construct ids and then matched the same way as `construct_id`;

Security scan

• No findings. We scan names, descriptions and tool definitions for hidden instructions and other prompt-injection patterns.

Recent checks