# study.vela/corpus

> Read-only MCP access to Vela's corpus of human experience: cited passages, coordinates, reading path

- name: study.vela/corpus
- version: 0.1.0
- connection class: R0 (autonomous)
- trust: 93/100
- quality: 85/100 (good)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/study.vela%2Fcorpus
- tools: https://api.protogrid.dev/v1/servers/study.vela%2Fcorpus/tools

**An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "corpus": {
      "type": "http",
      "url": "https://vela.study/mcp"
    }
  }
}
```


## Trust

- hygiene: 100
- liveness: 100
- freshness: 85
- provenance: 85
- drivers: +repository +dns-namespace +website +reachable +uptime-100% ~updated-42d-ago
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 85/100 (good)

### protocol: 75 (weight 25)

- warn `protocol.modern`: newest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
- n/a `protocol.stateless`: only applies to 2026-07-28 servers
- pass `protocol.transport`: streamable HTTP
- n/a `protocol.list_ttl`: only applies to 2026-07-28 servers

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 86 (weight 30)

- pass `tools.descriptions`: every tool has a description
- pass `tools.description_length`: descriptions are concise
- pass `tools.schemas`: every tool has an object input schema
- pass `tools.annotations`: 10 of 10 tools declare readOnlyHint or destructiveHint
- fail `tools.directory_hints`: no tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: vela.library.reading_list (idempotentHint); vela.corpus.query (idempotentHint); vela.corpus.list_topics (idempotentHint); …
- pass `tools.token_cost`: about 2,182 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: 100 (weight 15)

- pass `stability.changes`: 3 tool changes in 30 days
- pass `stability.rug_pull`: no tool changed its meaning under the same name

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 10, about 2,182 tokens to load them all
- tool set hash: c1a6a6e7396bd937dc5c73b5c6f66f6d
- tools last changed: 2026-10-01T02:16:32.042Z
- badge: [![protogrid quality](https://protogrid.dev/badge/study.vela/corpus.svg)](https://protogrid.dev/servers/study.vela/corpus)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

- 2026-10-01 `vela.library.reading_list` added
  - The reading list an emotion or theme page shows: books with one-line claims and a short attributed passage (≤300 chars). Exactly one of emotion or theme. FREE and read-only. Every url carries ?ref=mcp for citation arrival measurement. [capability: library-extraction-cards · mirrors: GET /api/corpus/reading-list]
- 2026-09-28 `vela.corpus.query` changed (outputSchema)
- 2026-09-25 `get_membership_offer` removed
  - Returns the Psychology & the Humanities chapter of the Bicycle Cooperative membership offer: five options (enterprise member, practitioner member, worker, practitioner rent, enterprise rent) with chapter substitution applied and this front's join URL.

Full history: https://api.protogrid.dev/v1/servers/study.vela%2Fcorpus/changes

## Remotes

- https://vela.study/mcp (streamable-http, auth none, reachable true, uptime30d 1)

## Packages

_none_

## Tools (10)

- `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]
- `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]
- `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]
- `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]
- `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]
- `vela.library.reading_list`: The reading list an emotion or theme page shows: books with one-line claims and a short attributed passage (≤300 chars). Exactly one of emotion or theme. FREE and read-only. Every url carries ?ref=mcp for citation arrival measurement.

[capability: library-extraction-cards · mirrors: GET /api/corpus/reading-list]
- `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]
- `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]
- `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]
- `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]