Data Collection

peopleprincipia.com

This MCP server provides tools to list, search, and resolve research constructs and measurement instruments, supporting data collection and survey design.

1 endpoint35 known toolsFirst detected September 9, 2026Last detected September 9, 2026

ENDPOINT 1

https://peopleprincipia.com/api/mcp

No auth detected

MCP server metadata

Name: principia
Version: 0.1.0

Capabilities

tools.listChanged

Server instructions

Principia MCP gateway (PRN-014). Canonical organizational-measurement registry. Tools: principia.constructs.{list,lookup,search,resolve}, principia.instruments.{list,lookup,search}, principia.items.{lookup,search} (usage_restrictions gated), principia.citations.{lookup,search}, principia.measures.{list,lookup}, principia.models.{list,lookup,search}, principia.effects.search (Phase 2), principia.evidence.for (Phase 2), principia.canonical_priors.{lookup,search} (PRN-021 pending).

Known tools 35

principia.constructs.list

List canonical constructs (resolved CanonicalVariable rows).

Inferred read-only

principia.constructs.lookup

Lookup one canonical construct by variable_id.

Inferred read-only

principia.constructs.search

Keyword search over construct name + definition + alternative_names + variable_codes.

Inferred read-only

principia.constructs.resolve

Resolve a source-side construct {name, definition?

Inferred read-only

principia.instruments.list

List InstrumentCard rows.

Inferred read-only

principia.instruments.lookup

Lookup one instrument by instrument_id.

Inferred read-only

principia.instruments.search

Keyword search over instrument_name + developer + constructs_covered.

Inferred read-only

principia.items.lookup

Lookup one survey item by item_id.

Inferred read-only

principia.items.search

Search items by text.

Inferred read-only

principia.citations.lookup

Lookup one citation by id OR doi.

Inferred read-only

principia.citations.search

Keyword search over title + apa_reference + doi + authors.

Inferred read-only

principia.measures.list

List Measure rows.

Inferred read-only

principia.measures.lookup

Lookup one Measure by measure_id.

Inferred read-only

principia.constructs.measures

Return instruments that measure a given construct, ranked by composite score (reliability + validity + literature usage + recency).

Inferred read-only

principia.models.list

List Model rows (theoretical / structural frameworks).

Inferred read-only

principia.models.lookup

Lookup one Model by model_id.

Inferred read-only

principia.models.search

Keyword search over model_name + description.

Inferred read-only

principia.effects.search

Search EffectSize rows by from/to/statistic_type.

Inferred read-only

principia.evidence.for

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

Inferred read-only

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.

Inferred read-only

principia.canonical_priors.lookup

Lookup a synthesized Bayesian prior by id OR (from_construct_id, predicate, to_construct_id).

Inferred read-only

principia.canonical_priors.search

Search canonical priors by from/predicate/to.

Inferred read-only

principia.theoretical_models.list

List canonical theoretical models (JD-R, COR, SDT, AET, JCM, Goal-Setting, Equity, Two-Factor, etc.

Inferred read-only

principia.theoretical_models.lookup

Look up one CanonicalTheoreticalModel by id (e.

Inferred read-only

principia.theoretical_models.search

Search theoretical models by keyword over name/summary/constructs.

Inferred read-only

principia.equivalences.lookup

Look up InstrumentEquivalence rows by `id` OR by the canonical tuple (`construct_id` + `instrument_a` + `instrument_b` [+ optional `mapping_method`]).

Inferred read-only

principia.equivalences.search

Search InstrumentEquivalence rows by `construct_id` and/or `instrument_id`.

Inferred read-only

principia.critiques.lookup

Look up one MethodologyCritique by `critique_id`.

Inferred read-only

principia.critiques.search

Search MethodologyCritique rows by composite filter (`subject_id`, `subject_type`, `critique_type`, `severity`).

Inferred read-only

principia.canonical_items.list

List CanonicalSurveyItem rows (PRN-050 item-level dedup spine).

Inferred read-only

principia.canonical_items.lookup

Lookup one CanonicalSurveyItem by canonical_item_id (e.

Inferred read-only

principia.canonical_items.search

Keyword search over normalized_text + alternative_texts.

Inferred read-only

principia.evidence.trace

Retrieve the full causal chain from a construct, condition, or problem to interventions, with evidence grades at each hop.

Inferred read-only

principia.interventions.lookup

Look up one Intervention by `intervention_id`.

Inferred read-only

principia.interventions.search

Search Intervention rows by composite filter (`construct_id` — matches when `targets_constructs[]` includes the id; `modality` — matches when `delivery_modality[]` includes the modality; `cost_band` — exact match on `typical_cost_band`).

Inferred read-only

CONNECT WITH APPROVAL

Client installation

Review this server and its permissions before adding it. Secret placeholders must be set locally.

Codex

~/.codex/config.toml

[mcp_servers.principia]
url = "https://peopleprincipia.com/api/mcp"
enabled = true

Claude Code

.mcp.json

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

Claude Desktop

Settings → Connectors → Add custom connector

Name: principia
Remote MCP URL: https://peopleprincipia.com/api/mcp

Add this remote URL as a custom connector in Claude Desktop. Availability depends on the user plan and workspace policy.

Cursor

.cursor/mcp.json

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

Visual Studio Code

.vscode/mcp.json

Add to Visual Studio Code

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

Generic MCP

Client-specific MCP configuration

{
  "name": "principia",
  "transport": "streamable-http",
  "url": "https://peopleprincipia.com/api/mcp"
}

MCP Inspector

Run the official MCP Inspector locally and enter the indexed Streamable HTTP endpoint.

TRUST AND VERIFICATION EVIDENCE

Loading Trust v2 evidence…

Checking the associated registrable domain. The BuiltWith key remains server-side.

Indexed

Evidence is source-attributed and does not guarantee that a third-party server is safe. Risk labels are conservative metadata heuristics.