MCP 서버

corpus

study.vela/corpus
지식 및 문서 검색 및 리서치 공개 · 연결 가능 MCP 2025-11-25

이 MCP로 할 수 있는 일

Queries and cites a corpus of human-experience writings by topic coordinates, themes, emotions, genre, and free text, with research and magazine-path tools.

vela.corpus.describe_topic
vela.corpus.describe_topic
Describe ONE topic in full — its axes and their operative definitions, its complete controlled theme and quality vocabularies, plus the vocabulary actually IN USE across the corpus with counts. The declared vocabulary and the used vocabulary are different facts; this returns both. FREE and read-only. [capability: topic-coordinate-systems · mirrors: GET /api/corpus/topics/:slug]
읽기 전용
입력 스키마
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'topic': {'type': 'string', 'default': 'being-human'}}}
출력 스키마
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['declared', 'inUse'], 'properties': {'inUse': {'type': 'object', 'required': ['cards', 'themes', 'qualities', 'genres', 'axes'], 'properties': {'axes': {'type': 'array', 'items': {'type': 'object', 'required': ['key', 'weights'], 'properties': {'key': {'type': 'string'}, 'weights': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'type': 'number'}}}, 'additionalProperties': False}}, 'cards': {'type': 'number'}, 'genres': {'type': 'array', 'items': {'type': 'object', 'required': ['slug', 'count'], 'properties': {'slug': {'type': 'string'}, 'count': {'type': 'number'}}, 'additionalProperties': False}}, 'themes': {'type': 'array', 'items': {'type': 'object', 'required': ['slug', 'count'], 'properties': {'slug': {'type': 'string'}, 'count': {'type': 'number'}}, 'additionalProperties': False}}, 'qualities': {'type': 'array', 'items': {'type': 'object', 'required': ['slug', 'count'], 'properties': {'slug': {'type': 'string'}, 'count': {'type': 'number'}}, 'additionalProperties': False}}}, 'additionalProperties': {}}, 'declared': {'type': 'object', 'required': ['slug', 'name', 'axes', 'themes', 'qualities'], 'properties': {'axes': {'type': 'array', 'items': {}}, 'name': {'type': 'string'}, 'slug': {'type': 'string'}, 'themes': {'type': 'array', 'items': {}}, 'thesis': {'type': 'string'}, 'qualities': {'type': 'array', 'items': {}}, 'axisWeights': {'type': 'array', 'items': {'type': 'string'}}}, 'additionalProperties': {}}}, 'additionalProperties': False}
vela.corpus.ground_claim
vela.corpus.ground_claim
Ground a claim in the corpus: hybrid semantic + theme retrieval over real passages, returning citations with source, passage code, scores, and a SHORT snippet. Use to check whether the corpus supports, complicates or is silent on an assertion. COSTS a small amount (one embedding per call). [capability: corpus-ingestion-dual-grade · mirrors: internal — lib/audit/retrieve.ts]
읽기 전용
입력 스키마
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['claim'], 'properties': {'claim': {'type': 'string', 'minLength': 3, 'description': 'The claim to ground.'}, 'limit': {'type': 'integer', 'default': 8, 'maximum': 20, 'minimum': 1}}}
출력 스키마
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['claim', 'hits'], 'properties': {'hits': {'type': 'array', 'items': {'type': 'object', 'required': ['passageCode', 'sourceTitle', 'themes', 'score', 'rationale', 'snippet', 'snippetTruncated'], 'properties': {'score': {'type': 'number'}, 'themes': {'type': 'array', 'items': {'type': 'string'}}, 'snippet': {'type': 'string'}, 'rationale': {'type': 'string'}, 'passageCode': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'sourceTitle': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'snippetTruncated': {'type': 'boolean'}}, 'additionalProperties': False}}, 'claim': {'type': 'string'}}, 'additionalProperties': False}
vela.corpus.list_topics
vela.corpus.list_topics
List the coordinate systems the corpus can be queried through — each with its thesis, axes, and controlled vocabularies. Call this before vela.corpus.query to learn what axes and themes exist. FREE and read-only. [capability: topic-coordinate-systems · mirrors: GET /api/corpus/topics]
읽기 전용
입력 스키마
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
출력 스키마
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['topics'], 'properties': {'topics': {'type': 'array', 'items': {'type': 'object', 'required': ['slug', 'name', 'axes', 'axisWeights', 'themeCount', 'qualityCount'], 'properties': {'axes': {'type': 'array', 'items': {'type': 'object', 'required': ['key', 'label'], 'properties': {'key': {'type': 'string'}, 'label': {'type': 'string'}, 'description': {'type': 'string'}}, 'additionalProperties': {}}}, 'name': {'type': 'string'}, 'slug': {'type': 'string'}, 'thesis': {'type': 'string'}, 'themeCount': {'type': 'number'}, 'axisWeights': {'type': 'array', 'items': {'type': 'string'}}, 'qualityCount': {'type': 'number'}}, 'additionalProperties': False}}}, 'additionalProperties': False}
vela.corpus.query
vela.corpus.query
Ask the corpus by COORDINATE rather than keyword. Filter works by axis weights (e.g. religion ∈ {T,s} AND work ∈ {T,s} returns the God-and-Work source set across genres), controlled themes, qualities/emotions, genre, and free text. Returns card metadata: the one-line claim, themes, coordinates, qualities. FREE and read-only. [capability: library-extraction-cards · mirrors: POST /api/corpus/query]
읽기 전용
입력 스키마
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'axes': {'type': 'object', 'description': 'Axis → allowed weights. ALL listed axes must match. e.g. {"religion":["T","s"],"work":["T","s"]}', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'type': 'array', 'items': {'type': 'string'}}}, 'text': {'type': 'string', 'description': 'Substring match over title / author / one-line claim.'}, 'genre': {'type': 'string'}, 'limit': {'type': 'integer', 'default': 50, 'maximum': 200, 'minimum': 1}, 'topic': {'type': 'string', 'default': 'being-human', 'description': 'Coordinate system to query (topic_configs.slug).'}, 'offset': {'type': 'integer', 'default': 0, 'maximum': 9007199254740991, 'minimum': 0}, 'themes': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Cards citing ANY of these controlled themes.'}, 'qualities': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Cards carrying ANY of these qualities (emotions, for being-human).'}, 'include_passages': {'type': 'boolean', 'default': False, 'description': 'Include theme-anchored passage pointers.'}}}
출력 스키마
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['topic', 'total', 'returned', 'hits', 'applied'], 'properties': {'hits': {'type': 'array', 'items': {'type': 'object', 'required': ['sourceSlug', 'libraryId', 'title', 'author', 'year', 'genre', 'oneLineClaim', 'themes', 'coordinates', 'qualities'], 'properties': {'url': {'type': 'string'}, 'year': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'genre': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'title': {'type': 'string'}, 'author': {'type': 'string'}, 'themes': {'type': 'array', 'items': {'type': 'string'}}, 'libraryId': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'qualities': {'type': 'array', 'items': {'type': 'string'}}, 'sourceSlug': {'type': 'string'}, 'coordinates': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'type': 'string'}}, 'oneLineClaim': {'type': 'string'}, 'signaturePassages': {'type': 'array', 'items': {'type': 'object', 'required': ['code', 'theme', 'quote'], 'properties': {'code': {'type': 'string'}, 'quote': {'type': 'string'}, 'theme': {'type': 'string'}}, 'additionalProperties': False}}}, 'additionalProperties': {}}}, 'topic': {'type': 'string'}, 'total': {'type': 'number'}, 'applied': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'returned': {'type': 'number'}, 'truncated': {'type': 'boolean'}}, 'additionalProperties': False}
vela.corpus.witness
vela.corpus.witness
Literary Witness Rail (ASN-1577): return passages and one-line claims from Vela's 762-work corpus that illuminate the given themes and/or emotions. Designed for frame-family profile pages — PersonFrame × ProblemFrame × ConditionFrame — to add an inside-out layer (what writers who lived this say) alongside the outside-in portrait the frame join produces. Results carry evidence_grade 'T1' (single-extractor) until PRN-282 lands. FREE for claims; costs one embedding for the passage path. [capability: literary-witness · mirrors: GET /api/vela/witness]
읽기 전용
입력 스키마
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'axes': {'type': 'object', 'description': 'Axis weight filters for claims only — same format as vela.corpus.query (e.g. {work:["T","s"]}).', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'type': 'array', 'items': {'type': 'string'}}}, 'themes': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}, 'description': "Controlled themes from Vela's vocabulary (e.g. 'fairness', 'recognition')."}, 'emotions': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}, 'description': "Emotions to match (e.g. 'shame', 'betrayal', 'grief'). At least one of themes or emotions is required."}, 'max_claims': {'type': 'integer', 'default': 3, 'maximum': 8, 'minimum': 1, 'description': 'Max one-line claims to return (default 3).'}, 'max_passages': {'type': 'integer', 'default': 5, 'maximum': 10, 'minimum': 1, 'description': 'Max passages to return (default 5).'}, 'problem_slug': {'type': 'string', 'description': 'ProblemFrame entity slug (echoed in response; reserved for frame_tags[] pre-cache after PA-1153 ID-freeze).'}, 'condition_slug': {'type': 'string', 'description': 'ConditionFrame entity slug (same reservation as problem_slug).'}}}
출력 스키마
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['passages', 'claims', 'evidence_grade', 'query'], 'properties': {'query': {'type': 'object', 'required': ['themes', 'emotions'], 'properties': {'axes': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'type': 'array', 'items': {'type': 'string'}}}, 'themes': {'type': 'array', 'items': {'type': 'string'}}, 'emotions': {'type': 'array', 'items': {'type': 'string'}}, 'problem_slug': {'type': 'string'}, 'condition_slug': {'type': 'string'}}, 'additionalProperties': {}}, 'claims': {'type': 'array', 'items': {'type': 'object', 'required': ['claim', 'source_title', 'author', 'themes'], 'properties': {'claim': {'type': 'string'}, 'author': {'type': 'string'}, 'themes': {'type': 'array', 'items': {'type': 'string'}}, 'source_title': {'type': 'string'}}, 'additionalProperties': False}}, 'passages': {'type': 'array', 'items': {'type': 'object', 'required': ['passage_code', 'text', 'source_title', 'author', 'charge', 'themes', 'page_range'], 'properties': {'text': {'type': 'string'}, 'author': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'charge': {'type': 'number'}, 'themes': {'type': 'array', 'items': {'type': 'string'}}, 'page_range': {'type': 'null'}, 'passage_code': {'type': 'string'}, 'source_title': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': False}}, 'evidence_grade': {'type': 'string', 'const': 'T1'}}, 'additionalProperties': False}
vela.magazine.relation_floor
vela.magazine.relation_floor
Whether a magazine's corpus can support the adaptive promise its pages render. Reports, per property, each relational dimension's fill AND its separating power — a field present on every piece with one distinct value carries no information, so fill rate alone is misleading. Read-only. [capability: adaptive-magazine-engine · mirrors: npm run magazine:relation-floor]
읽기 전용
입력 스키마
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'property': {'type': 'string', 'maxLength': 64, 'minLength': 1, 'description': 'Restrict to one property id; omit for every property with published pieces.'}}}
출력 스키마
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['properties'], 'properties': {'properties': {'type': 'array', 'items': {'type': 'object', 'required': ['property', 'published', 'dimensions', 'curatorConfirmed', 'usableCount', 'inert'], 'properties': {'inert': {'type': 'boolean'}, 'property': {'type': 'string'}, 'published': {'type': 'number'}, 'dimensions': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'key', 'fill', 'distinct', 'separation', 'usable', 'verdict'], 'properties': {'key': {'type': 'string'}, 'fill': {'type': 'number'}, 'name': {'type': 'string'}, 'usable': {'type': 'boolean'}, 'verdict': {'type': 'string'}, 'distinct': {'type': 'number'}, 'separation': {'type': 'number'}}, 'additionalProperties': False}}, 'usableCount': {'type': 'number'}, 'curatorConfirmed': {'type': 'number'}}, 'additionalProperties': False}}}, 'additionalProperties': False}
vela.magazine.sequence_path
vela.magazine.sequence_path
Ask what this magazine would actually give a reader who said they wanted these things. Returns the REAL sequenced path with the rationale for each piece — the same core the anonymous intake calls, not a preview. Read-only: writes nothing and records no signal. [capability: adaptive-magazine-engine · mirrors: POST /api/magazine/start-path]
읽기 전용
입력 스키마
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'forms': {'type': 'array', 'items': {'type': 'string', 'maxLength': 64, 'minLength': 1}, 'maxItems': 12, 'description': 'Article forms to steer by. At least one of emotions/forms is required.'}, 'limit': {'type': 'integer', 'maximum': 12, 'minimum': 1, 'description': 'Pieces to return (default 4).'}, 'emotions': {'type': 'array', 'items': {'type': 'string', 'maxLength': 64, 'minLength': 1}, 'maxItems': 12, 'description': 'Emotions the reader is steering by.'}, 'property': {'type': 'string', 'maxLength': 64, 'minLength': 1, 'description': 'Property id; defaults to vela.'}}}
출력 스키마
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['property', 'path'], 'properties': {'path': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'slug', 'title', 'rationale', 'personalized'], 'properties': {'id': {'type': 'string'}, 'slug': {'type': 'string'}, 'title': {'type': 'string'}, 'rationale': {'type': 'string'}, 'personalized': {'type': 'boolean'}}, 'additionalProperties': False}}, 'property': {'type': 'string'}}, 'additionalProperties': False}
vela.research.get_study
vela.research.get_study
One FieldStation study as a library-kit ProfileDTO plus the raw StudyRecord. Unknown id is an error. FREE and read-only. [capability: study-catalogue · mirrors: GET /api/research/studies/:id]
읽기 전용
입력 스키마
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'minLength': 1, 'description': 'Catalogue id, e.g. S-01.'}}}
출력 스키마
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ok', 'note', 'problems', 'profile', 'study'], 'properties': {'ok': {'type': 'boolean', 'const': True}, 'note': {'type': 'string'}, 'study': {'type': 'object', 'required': ['id', 'title', 'claim'], 'properties': {'id': {'type': 'string'}, 'claim': {'type': 'string'}, 'title': {'type': 'string'}}, 'additionalProperties': {}}, 'profile': {'type': 'object', 'required': ['id', 'title', 'author', 'year', 'kicker', 'body', 'meta'], 'properties': {'id': {'type': 'string'}, 'body': {'type': 'array', 'items': {'type': 'object', 'required': ['kind'], 'properties': {'kind': {'type': 'string'}}, 'additionalProperties': {}}}, 'meta': {'type': 'object', 'required': ['title', 'description'], 'properties': {'title': {'type': 'string'}, 'description': {'type': 'string'}}, 'additionalProperties': False}, 'year': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'title': {'type': 'string'}, 'author': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'kicker': {'type': 'string'}}, 'additionalProperties': {}}, 'problems': {'type': 'array', 'items': {'type': 'string'}}}, 'additionalProperties': False}
vela.research.list_studies
vela.research.list_studies
List FieldStation research ideas as a library-kit DiscoveryDTO. Each card is a study we can support, not a running participant surface. The honesty gate (limitations, readiness, doNotClaim) is enforced by research:catalog-check — this tool publishes that same file. FREE and read-only. Presence is gated; truth is not. [capability: study-catalogue · mirrors: GET /api/research/studies]
읽기 전용
입력 스키마
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
출력 스키마
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ok', 'note', 'problems', 'sendable', 'count', 'discovery', 'studies'], 'properties': {'ok': {'type': 'boolean', 'const': True}, 'note': {'type': 'string'}, 'count': {'type': 'number'}, 'studies': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'title', 'claim', 'repo', 'readiness', 'ethicsBurden', 'stage', 'disciplines', 'needs'], 'properties': {'id': {'type': 'string'}, 'repo': {'type': 'string'}, 'claim': {'type': 'string'}, 'needs': {'type': 'array', 'items': {'type': 'string'}}, 'stage': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'title': {'type': 'string'}, 'readiness': {'type': 'string'}, 'disciplines': {'type': 'array', 'items': {'type': 'string'}}, 'ethicsBurden': {'type': 'string'}}, 'additionalProperties': False}}, 'problems': {'type': 'array', 'items': {'type': 'string'}}, 'sendable': {'type': 'number'}, 'discovery': {'type': 'object', 'required': ['facetGroups', 'cards', 'labels'], 'properties': {'cards': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'href', 'eyebrow', 'title', 'claim'], 'properties': {'id': {'type': 'string'}, 'href': {'type': 'string'}, 'chips': {'type': 'array', 'items': {'type': 'object', 'required': ['slug', 'label'], 'properties': {'slug': {'type': 'string'}, 'label': {'type': 'string'}}, 'additionalProperties': False}}, 'claim': {'type': 'string'}, 'title': {'type': 'string'}, 'eyebrow': {'type': 'string'}}, 'additionalProperties': False}}, 'labels': {'type': 'object', 'required': ['filterHeading', 'clear', 'resultNoun'], 'properties': {'clear': {'type': 'string'}, 'resultNoun': {'type': 'array', 'items': [{'type': 'string'}, {'type': 'string'}]}, 'filterHeading': {'type': 'string'}}, 'additionalProperties': False}, 'facetGroups': {'type': 'array', 'items': {'type': 'object', 'required': ['key', 'heading', 'combine', 'facets'], 'properties': {'key': {'type': 'string'}, 'facets': {'type': 'array', 'items': {'type': 'object', 'required': ['value', 'label', 'count'], 'properties': {'count': {'type': 'number'}, 'label': {'type': 'string'}, 'value': {'type': 'string'}}, 'additionalProperties': False}}, 'combine': {'enum': ['and', 'or'], 'type': 'string'}, 'heading': {'type': 'string'}}, 'additionalProperties': False}}}, 'additionalProperties': False}}, 'additionalProperties': False}
변경됨
vela.corpus.query
2026년 9월 29일 2:59 AM
삭제됨
get_membership_offer
2026년 9월 27일 2:50 AM
추가됨
vela.research.get_study
2026년 9월 21일 2:57 AM
추가됨
vela.research.list_studies
2026년 9월 21일 2:57 AM
추가됨
get_membership_offer
2026년 9월 17일 12:55 PM
추가됨
vela.magazine.relation_floor
2026년 9월 17일 12:55 PM
추가됨
vela.magazine.sequence_path
2026년 9월 17일 12:55 PM
추가됨
vela.corpus.witness
2026년 9월 17일 12:55 PM
추가됨
vela.corpus.ground_claim
2026년 9월 17일 12:55 PM
추가됨
vela.corpus.describe_topic
2026년 9월 17일 12:55 PM
추가됨
vela.corpus.list_topics
2026년 9월 17일 12:55 PM
추가됨
vela.corpus.query
2026년 9월 17일 12:55 PM