Koskamo

Vela MCP

Read-only MCP access to Vela's corpus of human experience, allowing agents to query the corpus by controlled theme, emotion, or four-axis coordinates, retrieve emotion or theme reading lists, list coordinate systems, ground claims in cited passages, retrieve witness passages, and get sequenced magazine reading paths.

Endpoint and access

No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.

Vela MCP logo, by VelaVendor evidenceStreamable HTTPNo sign-inEndpoint checked 2026-11-07Operated by Vela
MCP endpoint (Streamable HTTP)
https://vela.study/mcp
Vendor documentation

What its tools do

10 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.

Read-only (10)

10 of 10 have a description · 10 of 10 declare behavior hints · 4 of 8 with parameters document them all

Checks and signals

Each line is separate evidence, not a trust score.

  • Passed Endpoint answered the live check ·
  • Passed Official MCP Registry namespace is tied to vela.study ·
  • Passed Endpoint is on the registry namespace domain ·
  • Availability 1 of 1 checks passed in 30 days

What you can do with it

  • Query the corpus by controlled theme, emotion, or four-axis coordinate
  • Return an emotion or theme reading list with books, claims, and receipts
  • Ground a claim in cited passages from the corpus
  • Get a real sequenced magazine reading path for stated emotions

Source and maintenance

Vendor evidenceRegistry 0.1.0
mcp-registry: study.vela/corpus@0.1.0Source repositoryProject website
Maintenance checked

Protocol and capabilities

Server
vela 0.1.0
MCP protocol negotiated in check
2025-11-25
Tools
10 advertised
Resources
Not advertised
Resource templates
Not advertised
Prompts
Not advertised
Server-advertised capabilities
{
  "tools": {
    "listChanged": true
  }
}

Tools

10 advertised

vela.corpus.query — vela.corpus.query
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.query input schema
{
  "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."
    }
  }
}
vela.corpus.query output schema
{
  "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.query annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}
vela.library.reading_list — vela.library.reading_list
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.library.reading_list input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 24,
      "maximum": 24,
      "minimum": 1
    },
    "theme": {
      "type": "string",
      "description": "Controlled theme slug (e.g. desire). Mutually exclusive with emotion."
    },
    "emotion": {
      "type": "string",
      "description": "Emotion primary slug (e.g. grief). Mutually exclusive with theme."
    }
  }
}
vela.library.reading_list output schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "ok",
    "kind",
    "slug",
    "limit",
    "rows"
  ],
  "properties": {
    "ok": {
      "type": "boolean",
      "const": true
    },
    "kind": {
      "enum": [
        "emotion",
        "theme"
      ],
      "type": "string"
    },
    "rows": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "title",
          "author",
          "year",
          "claim",
          "passage",
          "url",
          "slug"
        ],
        "properties": {
          "url": {
            "type": "string"
          },
          "slug": {
            "type": "string"
          },
          "year": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "claim": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "author": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "passage": {
            "type": "object",
            "required": [
              "quote",
              "theme"
            ],
            "properties": {
              "quote": {
                "type": "string"
              },
              "theme": {
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      }
    },
    "slug": {
      "type": "string"
    },
    "limit": {
      "type": "number"
    }
  },
  "additionalProperties": false
}
vela.library.reading_list annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}
vela.corpus.list_topics — vela.corpus.list_topics
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.list_topics input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}
vela.corpus.list_topics output schema
{
  "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.list_topics annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}
vela.corpus.describe_topic — vela.corpus.describe_topic
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.describe_topic input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "topic": {
      "type": "string",
      "default": "being-human"
    }
  }
}
vela.corpus.describe_topic output schema
{
  "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.describe_topic annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}
vela.corpus.ground_claim — vela.corpus.ground_claim
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.ground_claim input schema
{
  "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
    }
  }
}
vela.corpus.ground_claim output schema
{
  "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.ground_claim annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}
vela.corpus.witness — vela.corpus.witness
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.corpus.witness input schema
{
  "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)."
    }
  }
}
vela.corpus.witness output schema
{
  "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.corpus.witness annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}
vela.magazine.sequence_path — vela.magazine.sequence_path
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.magazine.sequence_path input schema
{
  "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."
    }
  }
}
vela.magazine.sequence_path output schema
{
  "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.magazine.sequence_path annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}
vela.magazine.relation_floor — vela.magazine.relation_floor
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.relation_floor input schema
{
  "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."
    }
  }
}
vela.magazine.relation_floor output schema
{
  "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.relation_floor annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}
vela.research.list_studies — vela.research.list_studies
Advertised by the server during the last successful anonymous check.
Advertised read-only

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]

vela.research.list_studies input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}
vela.research.list_studies output schema
{
  "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.research.list_studies annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}
vela.research.get_study — vela.research.get_study
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.get_study input schema
{
  "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."
    }
  }
}
vela.research.get_study output schema
{
  "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.get_study annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}

Prompts

Not advertised

No prompt definitions available.

Resources

Not advertised

No resource definitions available.

30-day availability

Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.

Successful checks
1 of 1 (100%)
Average latency
508 ms
95th percentile latency
508 ms

Maintenance history

Public check and source-refresh events. Editorial and ownership records remain private.

  • · probe · passed · 508 ms · metadata changed · 10 tool(s)

Connect from your client

Each snippet registers the same endpoint; pick the client you use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.
Claude Code configuration
claude mcp add --transport http vela-mcp https://vela.study/mcp

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).
Codex configuration
codex mcp add vela-mcp --url https://vela.study/mcp

Cursor

Merge this server into .cursor/mcp.json in your project, then enable vela-mcp in your MCP settings.
Cursor configuration
{
  "mcpServers": {
    "vela-mcp": {
      "url": "https://vela.study/mcp"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).
Cline configuration
{
  "mcpServers": {
    "vela-mcp": {
      "type": "streamableHttp",
      "url": "https://vela.study/mcp",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start vela-mcp and inspect its tools.
VS Code configuration
{
  "servers": {
    "vela-mcp": {
      "type": "http",
      "url": "https://vela.study/mcp"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.
Gemini CLI configuration
gemini mcp add --transport http vela-mcp https://vela.study/mcp

Claude Desktop

Open Claude Settings > Connectors > Add custom connector, enter this server URL and enable it for the conversation. This is a manual remote-connector handoff, not a desktop JSON configuration.
Claude Desktop configuration
https://vela.study/mcp

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.
Windsurf configuration
{
  "mcpServers": {
    "vela-mcp": {
      "serverUrl": "https://vela.study/mcp"
    }
  }
}

Let your agent find its tools

Find servers like Vela MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.

Connect Koskamo Explore workflows
See all 5,532

Do you run Vela MCP?

Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.

Claim this listing