Server definition
- Hash
- sha256:62059653bf94856fe881e7dcebf79e533d2e4c231008595c00f31083536880e3
- What it is
- What a remote MCP server returned when asked what it offers: 36 tools
The blob, as servednamed by its sha256
{
"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).",
"tools": [
{
"description": "Return the Bicycle Cooperative membership offer for the Measurement chapter, with chapter tokens substituted and this host's /join URL.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"type": "object"
},
"name": "get_membership_offer",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"api_version": {
"type": "string"
},
"chapter": {
"type": "string"
},
"join_url": {
"type": "string"
},
"offer": {
"additionalProperties": false,
"properties": {
"headline": {
"type": "string"
},
"lede": {
"type": "string"
},
"legal": {
"additionalProperties": false,
"properties": {
"decision": {
"type": "string"
},
"membershipCleared": {
"type": "boolean"
},
"membershipClearedNote": {
"type": "string"
}
},
"required": [
"membershipCleared",
"membershipClearedNote",
"decision"
],
"type": "object"
},
"options": {
"items": {
"additionalProperties": false,
"properties": {
"action": {
"enum": [
"interest",
"rent-link"
],
"type": "string"
},
"button_label": {
"type": "string"
},
"class": {
"type": "string"
},
"cta": {
"additionalProperties": false,
"properties": {
"interest": {
"type": "string"
},
"live": {
"type": "string"
}
},
"required": [
"live",
"interest"
],
"type": "object"
},
"for": {
"type": "string"
},
"gets": {
"items": {
"type": "string"
},
"type": "array"
},
"gives": {
"items": {
"type": "string"
},
"type": "array"
},
"id": {
"type": "string"
},
"kind": {
"enum": [
"membership",
"rent"
],
"type": "string"
},
"name": {
"type": "string"
},
"pitch": {
"type": "string"
},
"price": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"capital": {
"items": {
"type": "number"
},
"type": "array"
},
"duesPerMonth": {
"type": "number"
},
"duesPerYear": {
"type": "number"
},
"perMonth": {
"type": "number"
},
"perYear": {
"type": "number"
},
"status": {
"type": "string"
}
},
"type": "object"
},
{
"type": "null"
}
]
},
"price_label": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"rent_href": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"requires": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"seller": {
"type": "string"
}
},
"required": [
"id",
"class",
"kind",
"name",
"for",
"pitch",
"gives",
"gets",
"price",
"cta",
"requires",
"action",
"button_label",
"price_label",
"rent_href"
],
"type": "object"
},
"type": "array"
},
"pricing": {
"additionalProperties": false,
"properties": {
"confirmed": {
"type": "boolean"
},
"confirmedNote": {
"type": "string"
},
"currency": {
"type": "string"
}
},
"required": [
"confirmed",
"confirmedNote",
"currency"
],
"type": "object"
},
"reinforcement": {
"additionalProperties": false,
"properties": {
"landing_cta": {
"additionalProperties": false,
"properties": {
"body": {
"type": "string"
},
"button": {
"type": "string"
},
"headline": {
"type": "string"
}
},
"required": [
"headline",
"body",
"button"
],
"type": "object"
},
"nav_label": {
"type": "string"
}
},
"required": [
"nav_label",
"landing_cta"
],
"type": "object"
},
"version": {
"type": "string"
}
},
"required": [
"version",
"headline",
"lede",
"legal",
"pricing",
"options",
"reinforcement"
],
"type": "object"
}
},
"required": [
"api_version",
"chapter",
"join_url",
"offer"
],
"type": "object"
}
},
{
"description": "List CanonicalSurveyItem rows (PRN-050 item-level dedup spine). Each row aggregates one normalized item stem across N source instruments via source_items[].",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"exclusiveMinimum": 0,
"maximum": 500,
"type": "integer"
},
"offset": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
}
},
"type": "object"
},
"name": "principia.canonical_items.list",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"canonical_items": {
"items": {
"additionalProperties": {},
"properties": {
"alternative_texts": {
"items": {
"type": "string"
},
"type": "array"
},
"canonical_item_id": {
"type": "string"
},
"normalized_text": {
"type": "string"
},
"reverse_scored": {
"const": true,
"type": "boolean"
},
"reverse_scored_basis": {
"enum": [
"source_marker_paren_r",
"curator"
],
"type": "string"
},
"source_items": {
"items": {
"type": "string"
},
"type": "array"
},
"source_text_markers": {
"items": {
"additionalProperties": false,
"properties": {
"field": {
"enum": [
"normalized_text",
"alternative_texts"
],
"type": "string"
},
"marker": {
"enum": [
"leading_asterisk",
"trailing_paren_r",
"trailing_asterisk"
],
"type": "string"
},
"removed": {
"type": "string"
}
},
"required": [
"marker",
"removed",
"field"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"canonical_item_id",
"normalized_text"
],
"type": "object"
},
"type": "array"
},
"total": {
"type": "number"
}
},
"required": [
"canonical_items",
"total"
],
"type": "object"
}
},
{
"description": "Lookup one CanonicalSurveyItem by canonical_item_id (e.g., CITM_7350938cb42d). Unknown ids return found:false.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"id": {
"minLength": 1,
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "principia.canonical_items.lookup",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"canonical_item": {
"anyOf": [
{
"additionalProperties": {},
"properties": {
"alternative_texts": {
"items": {
"type": "string"
},
"type": "array"
},
"canonical_item_id": {
"type": "string"
},
"normalized_text": {
"type": "string"
},
"reverse_scored": {
"const": true,
"type": "boolean"
},
"reverse_scored_basis": {
"enum": [
"source_marker_paren_r",
"curator"
],
"type": "string"
},
"source_items": {
"items": {
"type": "string"
},
"type": "array"
},
"source_text_markers": {
"items": {
"additionalProperties": false,
"properties": {
"field": {
"enum": [
"normalized_text",
"alternative_texts"
],
"type": "string"
},
"marker": {
"enum": [
"leading_asterisk",
"trailing_paren_r",
"trailing_asterisk"
],
"type": "string"
},
"removed": {
"type": "string"
}
},
"required": [
"marker",
"removed",
"field"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"canonical_item_id",
"normalized_text"
],
"type": "object"
},
{
"type": "null"
}
]
},
"found": {
"type": "boolean"
}
},
"required": [
"found",
"canonical_item"
],
"type": "object"
}
},
{
"description": "Keyword search over normalized_text + alternative_texts. Optional instrument_id filter narrows to canonical items whose source_items[] reference that instrument.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"instrument_id": {
"minLength": 1,
"type": "string"
},
"limit": {
"exclusiveMinimum": 0,
"maximum": 100,
"type": "integer"
},
"q": {
"minLength": 1,
"type": "string"
}
},
"required": [
"q"
],
"type": "object"
},
"name": "principia.canonical_items.search",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"matches": {
"items": {
"additionalProperties": {},
"properties": {
"alternative_texts": {
"items": {
"type": "string"
},
"type": "array"
},
"canonical_item_id": {
"type": "string"
},
"normalized_text": {
"type": "string"
},
"reverse_scored": {
"const": true,
"type": "boolean"
},
"reverse_scored_basis": {
"enum": [
"source_marker_paren_r",
"curator"
],
"type": "string"
},
"source_items": {
"items": {
"type": "string"
},
"type": "array"
},
"source_text_markers": {
"items": {
"additionalProperties": false,
"properties": {
"field": {
"enum": [
"normalized_text",
"alternative_texts"
],
"type": "string"
},
"marker": {
"enum": [
"leading_asterisk",
"trailing_paren_r",
"trailing_asterisk"
],
"type": "string"
},
"removed": {
"type": "string"
}
},
"required": [
"marker",
"removed",
"field"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"canonical_item_id",
"normalized_text"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"matches"
],
"type": "object"
}
},
{
"description": "Lookup a synthesized Bayesian prior by id OR (from_construct_id, predicate, to_construct_id). Empty until PRN-021 synthesis engine ships.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"from_construct_id": {
"type": "string"
},
"id": {
"type": "string"
},
"predicate": {
"type": "string"
},
"sample_culture": {
"type": "string"
},
"to_construct_id": {
"type": "string"
}
},
"type": "object"
},
"name": "principia.canonical_priors.lookup",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"found": {
"type": "boolean"
},
"note": {
"type": "string"
},
"prior": {
"anyOf": [
{
"additionalProperties": {},
"properties": {
"canonical_prior_id": {
"type": "string"
},
"contributing_effect_size_ids": {
"items": {
"type": "string"
},
"type": "array"
},
"cultural_sub_priors": {
"additionalProperties": {
"additionalProperties": {},
"properties": {
"distribution_family": {
"type": "string"
},
"informativeness": {
"type": "string"
},
"k_studies": {
"type": "number"
},
"moderation_icc": {
"type": "number"
},
"n_total": {
"type": "number"
},
"parameters": {
"additionalProperties": {
"type": "number"
},
"propertyNames": {
"type": "string"
},
"type": "object"
}
},
"type": "object"
},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"distribution_family": {
"type": "string"
},
"freshness_score": {
"type": "number"
},
"from_construct_id": {
"type": "string"
},
"informativeness": {
"type": "string"
},
"k_studies": {
"type": "number"
},
"last_evidence_added_at": {
"type": "string"
},
"last_updated": {
"type": "string"
},
"n_total": {
"type": "number"
},
"next_synthesis_due_at": {
"type": "string"
},
"parameters": {
"additionalProperties": {
"type": "number"
},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"predicate": {
"type": "string"
},
"quality_distribution": {
"additionalProperties": false,
"properties": {
"A": {
"type": "number"
},
"B": {
"type": "number"
},
"C": {
"type": "number"
},
"D": {
"type": "number"
}
},
"type": "object"
},
"replication_status": {
"type": "string"
},
"synthesis_method": {
"type": "string"
},
"temporal_coverage": {
"additionalProperties": false,
"properties": {
"max_year": {
"type": "number"
},
"median_year": {
"type": "number"
},
"min_year": {
"type": "number"
},
"weight_centroid_year": {
"type": "number"
}
},
"required": [
"min_year",
"max_year",
"median_year",
"weight_centroid_year"
],
"type": "object"
},
"to_construct_id": {
"type": "string"
},
"validity_decay_half_life_years": {
"type": "number"
}
},
"type": "object"
},
{
"type": "null"
}
]
},
"reason": {
"enum": [
"construct_unknown",
"no_prior_synthesized",
"bad_input"
],
"type": "string"
},
"resolved_construct_ids": {
"additionalProperties": {
"type": "string"
},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"unknown_construct_ids": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"found",
"prior"
],
"type": "object"
}
},
{
"description": "Search canonical priors by from/predicate/to. Empty until PRN-021 synthesis engine ships.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"from": {
"type": "string"
},
"from_construct_id": {
"type": "string"
},
"limit": {
"exclusiveMinimum": 0,
"maximum": 500,
"type": "integer"
},
"min_freshness_score": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"min_informativeness": {
"enum": [
"uninformative",
"weakly_informative",
"informative",
"highly_informative"
],
"type": "string"
},
"predicate": {
"type": "string"
},
"to": {
"type": "string"
},
"to_construct_id": {
"type": "string"
}
},
"type": "object"
},
"name": "principia.canonical_priors.search",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"matches": {
"items": {
"additionalProperties": {},
"properties": {
"canonical_prior_id": {
"type": "string"
},
"contributing_effect_size_ids": {
"items": {
"type": "string"
},
"type": "array"
},
"cultural_sub_priors": {
"additionalProperties": {
"additionalProperties": {},
"properties": {
"distribution_family": {
"type": "string"
},
"informativeness": {
"type": "string"
},
"k_studies": {
"type": "number"
},
"moderation_icc": {
"type": "number"
},
"n_total": {
"type": "number"
},
"parameters": {
"additionalProperties": {
"type": "number"
},
"propertyNames": {
"type": "string"
},
"type": "object"
}
},
"type": "object"
},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"distribution_family": {
"type": "string"
},
"freshness_score": {
"type": "number"
},
"from_construct_id": {
"type": "string"
},
"informativeness": {
"type": "string"
},
"k_studies": {
"type": "number"
},
"last_evidence_added_at": {
"type": "string"
},
"last_updated": {
"type": "string"
},
"n_total": {
"type": "number"
},
"next_synthesis_due_at": {
"type": "string"
},
"parameters": {
"additionalProperties": {
"type": "number"
},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"predicate": {
"type": "string"
},
"quality_distribution": {
"additionalProperties": false,
"properties": {
"A": {
"type": "number"
},
"B": {
"type": "number"
},
"C": {
"type": "number"
},
"D": {
"type": "number"
}
},
"type": "object"
},
"replication_status": {
"type": "string"
},
"synthesis_method": {
"type": "string"
},
"temporal_coverage": {
"additionalProperties": false,
"properties": {
"max_year": {
"type": "number"
},
"median_year": {
"type": "number"
},
"min_year": {
"type": "number"
},
"weight_centroid_year": {
"type": "number"
}
},
"required": [
"min_year",
"max_year",
"median_year",
"weight_centroid_year"
],
"type": "object"
},
"to_construct_id": {
"type": "string"
},
"validity_decay_half_life_years": {
"type": "number"
}
},
"type": "object"
},
"type": "array"
},
"note": {
"type": "string"
},
"resolved_construct_ids": {
"additionalProperties": {
"type": "string"
},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"total": {
"type": "number"
}
},
"required": [
"matches"
],
"type": "object"
}
},
{
"description": "Lookup one citation by id OR doi. Scans both id-keyed and doi-keyed candidates.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"doi": {
"type": "string"
},
"id": {
"type": "string"
}
},
"type": "object"
},
"name": "principia.citations.lookup",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"citation": {
"anyOf": [
{
"additionalProperties": {},
"properties": {
"apa_reference": {
"type": "string"
},
"citation_id": {
"type": "string"
},
"doi": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"title": {
"type": "string"
}
},
"type": "object"
},
{
"type": "null"
}
]
},
"found": {
"type": "boolean"
}
},
"required": [
"found",
"citation"
],
"type": "object"
}
},
{
"description": "Keyword search over title + apa_reference + doi + authors.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"exclusiveMinimum": 0,
"maximum": 100,
"type": "integer"
},
"q": {
"minLength": 1,
"type": "string"
}
},
"required": [
"q"
],
"type": "object"
},
"name": "principia.citations.search",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"matches": {
"items": {
"additionalProperties": {},
"properties": {
"apa_reference": {
"type": "string"
},
"citation_id": {
"type": "string"
},
"doi": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"title": {
"type": "string"
}
},
"type": "object"
},
"type": "array"
}
},
"required": [
"matches"
],
"type": "object"
}
},
{
"description": "List canonical constructs (resolved CanonicalVariable rows). Supports limit/offset, engagement_family_only, and abstraction_level (PRN-271).",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"abstraction_level": {
"enum": [
"broad_trait",
"facet",
"competency",
"condition",
"process",
"composite"
],
"type": "string"
},
"engagement_family_only": {
"type": "boolean"
},
"limit": {
"exclusiveMinimum": 0,
"maximum": 500,
"type": "integer"
},
"offset": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
}
},
"type": "object"
},
"name": "principia.constructs.list",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"constructs": {
"items": {
"additionalProperties": {},
"properties": {
"abstraction_level": {
"anyOf": [
{
"enum": [
"broad_trait",
"facet",
"competency",
"condition",
"process",
"composite"
],
"type": "string"
},
{
"type": "null"
}
]
},
"alternative_names": {
"items": {
"type": "string"
},
"type": "array"
},
"construct_id": {
"type": "string"
},
"construct_ids": {
"items": {
"type": "string"
},
"type": "array"
},
"definition": {
"type": "string"
},
"normalized_name": {
"type": "string"
},
"variable_codes": {
"items": {
"type": "string"
},
"type": "array"
},
"variable_id": {
"type": "string"
},
"variable_name": {
"type": "string"
}
},
"required": [
"variable_name"
],
"type": "object"
},
"type": "array"
},
"total": {
"type": "number"
}
},
"required": [
"constructs",
"total"
],
"type": "object"
}
},
{
"description": "Lookup one canonical construct by variable_id. Unknown ids return found:false (soft validation).",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"id": {
"minLength": 1,
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "principia.constructs.lookup",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"construct": {
"anyOf": [
{
"additionalProperties": {},
"properties": {
"abstraction_level": {
"anyOf": [
{
"enum": [
"broad_trait",
"facet",
"competency",
"condition",
"process",
"composite"
],
"type": "string"
},
{
"type": "null"
}
]
},
"alternative_names": {
"items": {
"type": "string"
},
"type": "array"
},
"construct_id": {
"type": "string"
},
"construct_ids": {
"items": {
"type": "string"
},
"type": "array"
},
"definition": {
"type": "string"
},
"normalized_name": {
"type": "string"
},
"variable_codes": {
"items": {
"type": "string"
},
"type": "array"
},
"variable_id": {
"type": "string"
},
"variable_name": {
"type": "string"
}
},
"required": [
"variable_name"
],
"type": "object"
},
{
"type": "null"
}
]
},
"found": {
"type": "boolean"
}
},
"required": [
"found",
"construct"
],
"type": "object"
}
},
{
"description": "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).",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"construct_id": {
"minLength": 1,
"type": "string"
},
"cross_cultural_only": {
"type": "boolean"
},
"length_lte": {
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"limit": {
"exclusiveMinimum": 0,
"maximum": 100,
"type": "integer"
},
"min_reliability": {
"maximum": 1,
"minimum": 0,
"type": "number"
}
},
"required": [
"construct_id"
],
"type": "object"
},
"name": "principia.constructs.measures",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"construct_id": {
"type": "string"
},
"generated_at": {
"type": "string"
},
"items": {
"items": {
"additionalProperties": false,
"properties": {
"composite_score": {
"type": "number"
},
"deploy_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"instrument": {
"additionalProperties": {},
"properties": {
"instrument_id": {
"type": "string"
},
"instrument_name": {
"type": "string"
}
},
"type": "object"
},
"recency_year": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"reliability_summary": {
"additionalProperties": false,
"properties": {
"best_alpha": {
"type": "number"
},
"best_icc": {
"type": "number"
},
"best_omega": {
"type": "number"
},
"best_test_retest": {
"type": "number"
}
},
"type": "object"
},
"top_citation_ids": {
"items": {
"type": "string"
},
"type": "array"
},
"usage_count": {
"type": "number"
},
"validity_summary": {
"additionalProperties": false,
"properties": {
"by_grade": {
"additionalProperties": false,
"properties": {
"A": {
"type": "number"
},
"B": {
"type": "number"
},
"C": {
"type": "number"
},
"D": {
"type": "number"
}
},
"type": "object"
},
"evidence_count": {
"type": "number"
}
},
"required": [
"evidence_count",
"by_grade"
],
"type": "object"
}
},
"required": [
"instrument",
"reliability_summary",
"validity_summary",
"usage_count",
"recency_year",
"composite_score",
"top_citation_ids",
"deploy_url"
],
"type": "object"
},
"type": "array"
},
"total": {
"type": "number"
}
},
"required": [
"items",
"total",
"construct_id",
"generated_at"
],
"type": "object"
}
},
{
"description": "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]).",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"definition": {
"type": "string"
},
"name": {
"minLength": 1,
"type": "string"
},
"variable_code": {
"type": "string"
}
},
"required": [
"name"
],
"type": "object"
},
"name": "principia.constructs.resolve",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"confidence": {
"type": "number"
},
"construct": {
"anyOf": [
{
"additionalProperties": {},
"properties": {
"abstraction_level": {
"anyOf": [
{
"enum": [
"broad_trait",
"facet",
"competency",
"condition",
"process",
"composite"
],
"type": "string"
},
{
"type": "null"
}
]
},
"alternative_names": {
"items": {
"type": "string"
},
"type": "array"
},
"construct_id": {
"type": "string"
},
"construct_ids": {
"items": {
"type": "string"
},
"type": "array"
},
"definition": {
"type": "string"
},
"normalized_name": {
"type": "string"
},
"variable_codes": {
"items": {
"type": "string"
},
"type": "array"
},
"variable_id": {
"type": "string"
},
"variable_name": {
"type": "string"
}
},
"required": [
"variable_name"
],
"type": "object"
},
{
"type": "null"
}
]
},
"kind": {
"enum": [
"matched",
"no_match"
],
"type": "string"
},
"match_type": {
"enum": [
"name",
"code",
"definition"
],
"type": "string"
}
},
"required": [
"kind",
"construct"
],
"type": "object"
}
},
{
"description": "Keyword search over construct name + definition + alternative_names + variable_codes.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"exclusiveMinimum": 0,
"maximum": 100,
"type": "integer"
},
"q": {
"minLength": 1,
"type": "string"
}
},
"required": [
"q"
],
"type": "object"
},
"name": "principia.constructs.search",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"matches": {
"items": {
"additionalProperties": {},
"properties": {
"abstraction_level": {
"anyOf": [
{
"enum": [
"broad_trait",
"facet",
"competency",
"condition",
"process",
"composite"
],
"type": "string"
},
{
"type": "null"
}
]
},
"alternative_names": {
"items": {
"type": "string"
},
"type": "array"
},
"construct_id": {
"type": "string"
},
"construct_ids": {
"items": {
"type": "string"
},
"type": "array"
},
"definition": {
"type": "string"
},
"normalized_name": {
"type": "string"
},
"variable_codes": {
"items": {
"type": "string"
},
"type": "array"
},
"variable_id": {
"type": "string"
},
"variable_name": {
"type": "string"
}
},
"required": [
"variable_name"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"matches"
],
"type": "object"
}
},
{
"description": "Look up one MethodologyCritique by `critique_id`. Returns `{matches, total, note?}` — array-shaped for parity with equivalences. Matches list contains 0 or 1 element.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"id": {
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "principia.critiques.lookup",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"matches": {
"items": {
"additionalProperties": {},
"properties": {
"citation_ids": {
"items": {
"type": "string"
},
"type": "array"
},
"critique_id": {
"type": "string"
},
"critique_type": {
"type": "string"
},
"curator_note": {
"type": "string"
},
"rebuttal_citation_ids": {
"items": {
"type": "string"
},
"type": "array"
},
"severity": {
"type": "string"
},
"subject_id": {
"type": "string"
},
"subject_type": {
"type": "string"
},
"summary": {
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"note": {
"type": "string"
},
"total": {
"type": "number"
}
},
"required": [
"matches",
"total"
],
"type": "object"
}
},
{
"description": "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).",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"critique_type": {
"enum": [
"construct_validity",
"method_bias",
"sampling",
"scoring",
"reliability",
"applicability",
"factor_structure",
"common_method_variance",
"other"
],
"type": "string"
},
"limit": {
"exclusiveMinimum": 0,
"maximum": 500,
"type": "integer"
},
"severity": {
"enum": [
"minor",
"moderate",
"major",
"fatal"
],
"type": "string"
},
"subject_id": {
"type": "string"
},
"subject_type": {
"enum": [
"instrument",
"construct",
"model",
"theoretical_model",
"effect_size",
"citation"
],
"type": "string"
}
},
"type": "object"
},
"name": "principia.critiques.search",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"matches": {
"items": {
"additionalProperties": {},
"properties": {
"citation_ids": {
"items": {
"type": "string"
},
"type": "array"
},
"critique_id": {
"type": "string"
},
"critique_type": {
"type": "string"
},
"curator_note": {
"type": "string"
},
"rebuttal_citation_ids": {
"items": {
"type": "string"
},
"type": "array"
},
"severity": {
"type": "string"
},
"subject_id": {
"type": "string"
},
"subject_type": {
"type": "string"
},
"summary": {
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"note": {
"type": "string"
},
"total": {
"type": "number"
}
},
"required": [
"matches",
"total"
],
"type": "object"
}
},
{
"description": "Search EffectSize rows by from/to/statistic_type. Phase 2 — empty result today (note carries the gating).",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"from": {
"type": "string"
},
"from_construct_id": {
"type": "string"
},
"limit": {
"exclusiveMinimum": 0,
"maximum": 100,
"type": "integer"
},
"statistic_type": {
"type": "string"
},
"to": {
"type": "string"
},
"to_construct_id": {
"type": "string"
}
},
"type": "object"
},
"name": "principia.effects.search",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"matches": {
"items": {
"additionalProperties": {},
"properties": {
"effect_size_id": {
"type": "string"
},
"from_construct_id": {
"type": "string"
},
"statistic_type": {
"type": "string"
},
"to_construct_id": {
"type": "string"
},
"value": {
"type": "number"
}
},
"type": "object"
},
"type": "array"
},
"note": {
"type": "string"
}
},
"required": [
"matches"
],
"type": "object"
}
},
{
"description": "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, note?}` — array-shaped because a (construct, pair) can carry multiple methods.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"construct_id": {
"type": "string"
},
"id": {
"type": "string"
},
"instrument_a": {
"type": "string"
},
"instrument_b": {
"type": "string"
},
"mapping_method": {
"enum": [
"linear",
"equipercentile",
"irt_concordance",
"linking_study",
"expert_judgment"
],
"type": "string"
}
},
"type": "object"
},
"name": "principia.equivalences.lookup",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"matches": {
"items": {
"additionalProperties": {},
"properties": {
"citation_ids": {
"items": {
"type": "string"
},
"type": "array"
},
"construct_id": {
"type": "string"
},
"cross_cultural_validated": {
"type": "boolean"
},
"equivalence_id": {
"type": "string"
},
"instrument_pair": {
"items": [
{
"type": "string"
},
{
"type": "string"
}
],
"type": "array"
},
"mapping_method": {
"type": "string"
},
"mapping_parameters": {
"additionalProperties": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"notes": {
"type": "string"
},
"quality_grade": {
"type": "string"
},
"sample_n": {
"type": "number"
}
},
"type": "object"
},
"type": "array"
},
"note": {
"type": "string"
},
"total": {
"type": "number"
}
},
"required": [
"matches",
"total"
],
"type": "object"
}
},
{
"description": "Search InstrumentEquivalence rows by `construct_id` and/or `instrument_id`. `instrument_id` matches either side of the pair. Optional `mapping_method` filter.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"construct_id": {
"type": "string"
},
"instrument_id": {
"type": "string"
},
"limit": {
"exclusiveMinimum": 0,
"maximum": 500,
"type": "integer"
},
"mapping_method": {
"enum": [
"linear",
"equipercentile",
"irt_concordance",
"linking_study",
"expert_judgment"
],
"type": "string"
}
},
"type": "object"
},
"name": "principia.equivalences.search",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"matches": {
"items": {
"additionalProperties": {},
"properties": {
"citation_ids": {
"items": {
"type": "string"
},
"type": "array"
},
"construct_id": {
"type": "string"
},
"cross_cultural_validated": {
"type": "boolean"
},
"equivalence_id": {
"type": "string"
},
"instrument_pair": {
"items": [
{
"type": "string"
},
{
"type": "string"
}
],
"type": "array"
},
"mapping_method": {
"type": "string"
},
"mapping_parameters": {
"additionalProperties": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"notes": {
"type": "string"
},
"quality_grade": {
"type": "string"
},
"sample_n": {
"type": "number"
}
},
"type": "object"
},
"type": "array"
},
"note": {
"type": "string"
},
"total": {
"type": "number"
}
},
"required": [
"matches",
"total"
],
"type": "object"
}
},
{
"description": "Return Evidence[] edges that name a given entity_id as the claim subject. Phase 2 — empty result today.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"entity_id": {
"minLength": 1,
"type": "string"
},
"limit": {
"exclusiveMinimum": 0,
"maximum": 1000,
"type": "integer"
},
"subject_type": {
"enum": [
"construct",
"instrument",
"model",
"effect_size"
],
"type": "string"
}
},
"required": [
"entity_id"
],
"type": "object"
},
"name": "principia.evidence.for",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"evidence": {
"items": {
"additionalProperties": {},
"properties": {
"citation_id": {
"type": "string"
},
"claim": {
"additionalProperties": {},
"properties": {
"predicate": {
"type": "string"
},
"subject_id": {
"type": "string"
},
"subject_type": {
"type": "string"
}
},
"type": "object"
},
"evidence_id": {
"type": "string"
},
"verdict": {
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"note": {
"type": "string"
}
},
"required": [
"evidence"
],
"type": "object"
}
},
{
"description": "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 join (landed 2026-09-11); an address with no join coverage yet resolves the problem frame with an honestly empty linked_constructs[], not an error. condition_id accepts bicycle-guide's minted cond_<slug> ConditionFrame ids and resolves via the PRN-281 crosswalk (landed 2026-09-11); a condition with no construct match yet resolves honestly empty the same way. All three entry points are fully resolved today — no path is gated.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"condition_id": {
"type": "string"
},
"construct_id": {
"type": "string"
},
"limit_interventions": {
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"limit_priors": {
"maximum": 20,
"minimum": 1,
"type": "integer"
},
"problem_id": {
"type": "string"
}
},
"type": "object"
},
"name": "principia.evidence.trace",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": {},
"properties": {
"d_range": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"ci": {
"type": "number"
},
"d_high": {
"type": "number"
},
"d_low": {
"type": "number"
}
},
"required": [
"d_low",
"d_high",
"ci"
],
"type": "object"
},
{
"type": "null"
}
]
},
"entry_point": {
"additionalProperties": false,
"properties": {
"id": {
"type": "string"
},
"kind": {
"enum": [
"construct_id",
"condition_id",
"problem_id"
],
"type": "string"
},
"label": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"kind",
"id",
"label"
],
"type": "object"
},
"gate": {
"type": "string"
},
"interventions": {
"items": {
"additionalProperties": false,
"properties": {
"data": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"evidence_grade": {
"enum": [
"A",
"B",
"C",
"D"
],
"type": "string"
},
"resolution_note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"data",
"evidence_grade",
"resolution_note"
],
"type": "object"
},
"type": "array"
},
"linked_conditions": {
"items": {
"additionalProperties": false,
"properties": {
"data": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"evidence_grade": {
"enum": [
"A",
"B",
"C",
"D"
],
"type": "string"
},
"resolution_note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"data",
"evidence_grade",
"resolution_note"
],
"type": "object"
},
"type": "array"
},
"linked_constructs": {
"items": {
"additionalProperties": false,
"properties": {
"data": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"evidence_grade": {
"enum": [
"A",
"B",
"C",
"D"
],
"type": "string"
},
"resolution_note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"data",
"evidence_grade",
"resolution_note"
],
"type": "object"
},
"type": "array"
},
"problem": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"data": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"evidence_grade": {
"enum": [
"A",
"B",
"C",
"D"
],
"type": "string"
},
"resolution_note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"data",
"evidence_grade",
"resolution_note"
],
"type": "object"
},
{
"type": "null"
}
]
},
"representative_priors": {
"items": {
"additionalProperties": false,
"properties": {
"data": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"evidence_grade": {
"enum": [
"A",
"B",
"C",
"D"
],
"type": "string"
},
"resolution_note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"data",
"evidence_grade",
"resolution_note"
],
"type": "object"
},
"type": "array"
},
"resolution_status": {
"enum": [
"resolved",
"pending_freeze",
"not_found"
],
"type": "string"
},
"traced_at": {
"type": "string"
}
},
"required": [
"entry_point",
"resolution_status",
"problem",
"linked_conditions",
"linked_constructs",
"representative_priors",
"d_range",
"interventions",
"traced_at"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"construct": {
"minLength": 1,
"type": "string"
},
"displayable_only": {
"type": "boolean"
},
"from": {
"minLength": 1,
"type": "string"
},
"limit": {
"exclusiveMinimum": 0,
"maximum": 200,
"type": "integer"
},
"min_grade": {
"enum": [
"A",
"B",
"C",
"D"
],
"type": "string"
},
"stance": {
"enum": [
"supports",
"disputes"
],
"type": "string"
},
"to": {
"minLength": 1,
"type": "string"
}
},
"type": "object"
},
"name": "principia.evidence_statements.search",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"note": {
"type": "string"
},
"statements": {
"items": {
"additionalProperties": false,
"properties": {
"cites_backing_doi": {
"type": "string"
},
"citing_doi": {
"type": "string"
},
"citing_title": {
"type": "string"
},
"citing_year": {
"type": "number"
},
"classified_at": {
"type": "string"
},
"classified_by": {
"type": "string"
},
"displayable": {
"type": "boolean"
},
"from_construct_id": {
"type": "string"
},
"grade_provenance": {
"additionalProperties": false,
"properties": {
"backing_doi": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"derivation": {
"enum": [
"effect_exact",
"effect_by_citation",
"ungraded"
],
"type": "string"
},
"derived_at": {
"type": "string"
},
"inherited_from_effect_size_ids": {
"items": {
"type": "string"
},
"type": "array"
},
"note": {
"type": "string"
},
"observed_grades": {
"items": {
"type": "string"
},
"type": "array"
},
"rubric": {
"type": "string"
},
"rubric_version": {
"type": "string"
}
},
"required": [
"derivation",
"rubric",
"rubric_version",
"inherited_from_effect_size_ids",
"observed_grades",
"backing_doi",
"derived_at"
],
"type": "object"
},
"oa_license": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"oa_pdf_url": {
"type": "string"
},
"quality_grade": {
"enum": [
"A",
"B",
"C",
"D",
"ungraded"
],
"type": "string"
},
"snippet": {
"type": "string"
},
"source": {
"type": "string"
},
"sources": {
"items": {
"type": "string"
},
"type": "array"
},
"stance": {
"enum": [
"supports",
"disputes"
],
"type": "string"
},
"statement_id": {
"type": "string"
},
"to_construct_id": {
"type": "string"
}
},
"required": [
"statement_id",
"from_construct_id",
"to_construct_id",
"snippet",
"stance",
"displayable",
"sources",
"source",
"classified_by",
"classified_at"
],
"type": "object"
},
"type": "array"
},
"total": {
"type": "number"
}
},
"required": [
"statements",
"total"
],
"type": "object"
}
},
{
"description": "List InstrumentCard rows. Optional construct_id filter narrows to instruments covering a given construct.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"construct_id": {
"type": "string"
},
"license": {
"type": "string"
},
"limit": {
"exclusiveMinimum": 0,
"maximum": 500,
"type": "integer"
},
"offset": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"owned": {
"type": "boolean"
}
},
"type": "object"
},
"name": "principia.instruments.list",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"instruments": {
"items": {
"additionalProperties": {},
"properties": {
"constructs_covered": {
"items": {
"type": "string"
},
"type": "array"
},
"developer": {
"type": "string"
},
"instrument_id": {
"type": "string"
},
"instrument_name": {
"type": "string"
},
"usage_rights": {
"additionalProperties": false,
"properties": {
"evidence": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"note": {
"type": "string"
},
"type": {
"enum": [
"url",
"citation"
],
"type": "string"
},
"value": {
"minLength": 1,
"type": "string"
}
},
"required": [
"type",
"value"
],
"type": "object"
},
{
"type": "null"
}
]
},
"reviewed_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"reviewed_by": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"id": {
"minLength": 1,
"type": "string"
},
"type": {
"enum": [
"automation",
"human"
],
"type": "string"
}
},
"required": [
"type",
"id"
],
"type": "object"
},
{
"type": "null"
}
]
},
"status": {
"enum": [
"not_reviewed",
"describe_and_cite",
"owned_cc0",
"public_domain",
"permissive_with_conditions",
"metadata_only",
"restricted",
"unknown_after_review"
],
"type": "string"
}
},
"required": [
"status",
"evidence",
"reviewed_by",
"reviewed_at"
],
"type": "object"
}
},
"type": "object"
},
"type": "array"
},
"total": {
"type": "number"
}
},
"required": [
"instruments",
"total"
],
"type": "object"
}
},
{
"description": "Lookup one instrument by instrument_id. Unknown ids return found:false.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"id": {
"minLength": 1,
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "principia.instruments.lookup",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"found": {
"type": "boolean"
},
"instrument": {
"anyOf": [
{
"additionalProperties": {},
"properties": {
"constructs_covered": {
"items": {
"type": "string"
},
"type": "array"
},
"developer": {
"type": "string"
},
"instrument_id": {
"type": "string"
},
"instrument_name": {
"type": "string"
},
"usage_rights": {
"additionalProperties": false,
"properties": {
"evidence": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"note": {
"type": "string"
},
"type": {
"enum": [
"url",
"citation"
],
"type": "string"
},
"value": {
"minLength": 1,
"type": "string"
}
},
"required": [
"type",
"value"
],
"type": "object"
},
{
"type": "null"
}
]
},
"reviewed_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"reviewed_by": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"id": {
"minLength": 1,
"type": "string"
},
"type": {
"enum": [
"automation",
"human"
],
"type": "string"
}
},
"required": [
"type",
"id"
],
"type": "object"
},
{
"type": "null"
}
]
},
"status": {
"enum": [
"not_reviewed",
"describe_and_cite",
"owned_cc0",
"public_domain",
"permissive_with_conditions",
"metadata_only",
"restricted",
"unknown_after_review"
],
"type": "string"
}
},
"required": [
"status",
"evidence",
"reviewed_by",
"reviewed_at"
],
"type": "object"
}
},
"type": "object"
},
{
"type": "null"
}
]
}
},
"required": [
"found",
"instrument"
],
"type": "object"
}
},
{
"description": "Keyword search over instrument_name + developer + constructs_covered.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"exclusiveMinimum": 0,
"maximum": 100,
"type": "integer"
},
"q": {
"minLength": 1,
"type": "string"
}
},
"required": [
"q"
],
"type": "object"
},
"name": "principia.instruments.search",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"matches": {
"items": {
"additionalProperties": {},
"properties": {
"constructs_covered": {
"items": {
"type": "string"
},
"type": "array"
},
"developer": {
"type": "string"
},
"instrument_id": {
"type": "string"
},
"instrument_name": {
"type": "string"
},
"usage_rights": {
"additionalProperties": false,
"properties": {
"evidence": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"note": {
"type": "string"
},
"type": {
"enum": [
"url",
"citation"
],
"type": "string"
},
"value": {
"minLength": 1,
"type": "string"
}
},
"required": [
"type",
"value"
],
"type": "object"
},
{
"type": "null"
}
]
},
"reviewed_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"reviewed_by": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"id": {
"minLength": 1,
"type": "string"
},
"type": {
"enum": [
"automation",
"human"
],
"type": "string"
}
},
"required": [
"type",
"id"
],
"type": "object"
},
{
"type": "null"
}
]
},
"status": {
"enum": [
"not_reviewed",
"describe_and_cite",
"owned_cc0",
"public_domain",
"permissive_with_conditions",
"metadata_only",
"restricted",
"unknown_after_review"
],
"type": "string"
}
},
"required": [
"status",
"evidence",
"reviewed_by",
"reviewed_at"
],
"type": "object"
}
},
"type": "object"
},
"type": "array"
}
},
"required": [
"matches"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"id": {
"minLength": 1,
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "principia.interventions.lookup",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"matches": {
"items": {
"additionalProperties": {},
"properties": {
"citation_ids": {
"items": {
"type": "string"
},
"type": "array"
},
"contraindications": {
"type": "string"
},
"delivery_modality": {
"items": {
"type": "string"
},
"type": "array"
},
"fidelity_notes": {
"type": "string"
},
"intervention_id": {
"type": "string"
},
"mechanism_summary": {
"type": "string"
},
"meta_analytic_effect_size_ids": {
"items": {
"type": "string"
},
"type": "array"
},
"name": {
"type": "string"
},
"targets_constructs": {
"items": {
"type": "string"
},
"type": "array"
},
"typical_cost_band": {
"type": "string"
},
"typical_duration_weeks": {
"type": "number"
}
},
"type": "object"
},
"type": "array"
},
"note": {
"type": "string"
},
"total": {
"type": "number"
}
},
"required": [
"matches",
"total"
],
"type": "object"
}
},
{
"description": "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`; `modality` — matches when `delivery_modality[]` includes the modality; `cost_band` — exact match on `typical_cost_band`). All filters AND together; any subset is valid. Read-only (curator-policy D4).",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"construct_id": {
"type": "string"
},
"cost_band": {
"enum": [
"low",
"medium",
"high",
"enterprise"
],
"type": "string"
},
"limit": {
"exclusiveMinimum": 0,
"maximum": 500,
"type": "integer"
},
"modality": {
"enum": [
"training",
"coaching",
"tech",
"policy",
"structural",
"feedback",
"incentive",
"process_redesign",
"other"
],
"type": "string"
},
"problem_id": {
"type": "string"
}
},
"type": "object"
},
"name": "principia.interventions.search",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"matches": {
"items": {
"additionalProperties": {},
"properties": {
"citation_ids": {
"items": {
"type": "string"
},
"type": "array"
},
"contraindications": {
"type": "string"
},
"delivery_modality": {
"items": {
"type": "string"
},
"type": "array"
},
"fidelity_notes": {
"type": "string"
},
"intervention_id": {
"type": "string"
},
"mechanism_summary": {
"type": "string"
},
"meta_analytic_effect_size_ids": {
"items": {
"type": "string"
},
"type": "array"
},
"name": {
"type": "string"
},
"targets_constructs": {
"items": {
"type": "string"
},
"type": "array"
},
"typical_cost_band": {
"type": "string"
},
"typical_duration_weeks": {
"type": "number"
}
},
"type": "object"
},
"type": "array"
},
"note": {
"type": "string"
},
"total": {
"type": "number"
}
},
"required": [
"matches",
"total"
],
"type": "object"
}
},
{
"description": "Lookup one survey item by item_id. SPEC §6/Q4 enforced: items_license != public_domain|open returns status:'restricted'.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"id": {
"minLength": 1,
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "principia.items.lookup",
"outputSchema": null
},
{
"description": "Search items by text. Restricted items (proprietary instruments) are returned with text fields stripped; restricted_count surfaces how many.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"exclusiveMinimum": 0,
"maximum": 100,
"type": "integer"
},
"q": {
"minLength": 1,
"type": "string"
}
},
"required": [
"q"
],
"type": "object"
},
"name": "principia.items.search",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"matches": {
"items": {
"additionalProperties": {},
"properties": {
"construct_id": {
"type": "string"
},
"instrument_id": {
"type": "string"
},
"item_id": {
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"restricted_count": {
"type": "number"
}
},
"required": [
"matches",
"restricted_count"
],
"type": "object"
}
},
{
"description": "List Measure rows. entity_kind filter selects scientific_construct vs operational_metric.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"entity_kind": {
"enum": [
"scientific_construct",
"operational_metric"
],
"type": "string"
},
"limit": {
"exclusiveMinimum": 0,
"maximum": 500,
"type": "integer"
},
"offset": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
}
},
"type": "object"
},
"name": "principia.measures.list",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"measures": {
"items": {
"additionalProperties": {},
"properties": {
"construct_id": {
"type": "string"
},
"entity_kind": {
"type": "string"
},
"measure_id": {
"type": "string"
},
"measure_name": {
"type": "string"
},
"measurement_type": {
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"total": {
"type": "number"
}
},
"required": [
"measures",
"total"
],
"type": "object"
}
},
{
"description": "Lookup one Measure by measure_id. Unknown ids return found:false.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"id": {
"minLength": 1,
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "principia.measures.lookup",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"found": {
"type": "boolean"
},
"measure": {
"anyOf": [
{
"additionalProperties": {},
"properties": {
"construct_id": {
"type": "string"
},
"entity_kind": {
"type": "string"
},
"measure_id": {
"type": "string"
},
"measure_name": {
"type": "string"
},
"measurement_type": {
"type": "string"
}
},
"type": "object"
},
{
"type": "null"
}
]
}
},
"required": [
"found",
"measure"
],
"type": "object"
}
},
{
"description": "List Model rows (theoretical / structural frameworks).",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"exclusiveMinimum": 0,
"maximum": 500,
"type": "integer"
},
"offset": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
}
},
"type": "object"
},
"name": "principia.models.list",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"models": {
"items": {
"additionalProperties": {},
"properties": {
"description": {
"type": "string"
},
"model_id": {
"type": "string"
},
"model_name": {
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"total": {
"type": "number"
}
},
"required": [
"models",
"total"
],
"type": "object"
}
},
{
"description": "Lookup one Model by model_id. Unknown ids return found:false.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"id": {
"minLength": 1,
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "principia.models.lookup",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"found": {
"type": "boolean"
},
"model": {
"anyOf": [
{
"additionalProperties": {},
"properties": {
"description": {
"type": "string"
},
"model_id": {
"type": "string"
},
"model_name": {
"type": "string"
}
},
"type": "object"
},
{
"type": "null"
}
]
}
},
"required": [
"found",
"model"
],
"type": "object"
}
},
{
"description": "Keyword search over model_name + description.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"exclusiveMinimum": 0,
"maximum": 100,
"type": "integer"
},
"q": {
"minLength": 1,
"type": "string"
}
},
"required": [
"q"
],
"type": "object"
},
"name": "principia.models.search",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"matches": {
"items": {
"additionalProperties": {},
"properties": {
"description": {
"type": "string"
},
"model_id": {
"type": "string"
},
"model_name": {
"type": "string"
}
},
"type": "object"
},
"type": "array"
}
},
"required": [
"matches"
],
"type": "object"
}
},
{
"description": "List canonical theoretical models (JD-R, COR, SDT, AET, JCM, Goal-Setting, Equity, Two-Factor, etc.). Sorted by foundational publication year. Read-only.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"exclusiveMinimum": 0,
"maximum": 500,
"type": "integer"
},
"offset": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
}
},
"type": "object"
},
"name": "principia.theoretical_models.list",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"items": {
"items": {
"additionalProperties": {},
"properties": {
"canonical_constructs": {
"items": {
"type": "string"
},
"type": "array"
},
"descendant_per_study_models": {
"items": {
"type": "string"
},
"type": "array"
},
"first_publication_year": {
"type": "number"
},
"name": {
"type": "string"
},
"originators": {
"items": {
"type": "string"
},
"type": "array"
},
"short_name": {
"type": "string"
},
"summary": {
"type": "string"
},
"theoretical_model_id": {
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"total": {
"type": "number"
}
},
"required": [
"items",
"total"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"id": {
"minLength": 1,
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "principia.theoretical_models.lookup",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"found": {
"type": "boolean"
},
"note": {
"type": "string"
},
"theoretical_model": {
"anyOf": [
{
"additionalProperties": {},
"properties": {
"canonical_constructs": {
"items": {
"type": "string"
},
"type": "array"
},
"descendant_per_study_models": {
"items": {
"type": "string"
},
"type": "array"
},
"first_publication_year": {
"type": "number"
},
"name": {
"type": "string"
},
"originators": {
"items": {
"type": "string"
},
"type": "array"
},
"short_name": {
"type": "string"
},
"summary": {
"type": "string"
},
"theoretical_model_id": {
"type": "string"
}
},
"type": "object"
},
{
"type": "null"
}
]
}
},
"required": [
"found",
"theoretical_model"
],
"type": "object"
}
},
{
"description": "Search theoretical models by keyword over name/summary/constructs. Optional filters: invokes_construct_id (theories that invoke a specific construct), field_domain (classification axis).",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"field_domain": {
"type": "string"
},
"invokes_construct_id": {
"type": "string"
},
"limit": {
"exclusiveMinimum": 0,
"maximum": 100,
"type": "integer"
},
"q": {
"minLength": 1,
"type": "string"
}
},
"required": [
"q"
],
"type": "object"
},
"name": "principia.theoretical_models.search",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"matches": {
"items": {
"additionalProperties": {},
"properties": {
"canonical_constructs": {
"items": {
"type": "string"
},
"type": "array"
},
"descendant_per_study_models": {
"items": {
"type": "string"
},
"type": "array"
},
"first_publication_year": {
"type": "number"
},
"name": {
"type": "string"
},
"originators": {
"items": {
"type": "string"
},
"type": "array"
},
"short_name": {
"type": "string"
},
"summary": {
"type": "string"
},
"theoretical_model_id": {
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"total": {
"type": "number"
}
},
"required": [
"matches",
"total"
],
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:62059653bf94856fe881e7dcebf79e533d2e4c231008595c00f31083536880e3 | sha256sum