Skip to content
docs
UseBuildChangelog
Open Lumin
All tools

Event timing

Electable Events

get_election_catalog

List every electable event with its elected house group, its principal house, the houses it excludes, its default granularity, and its PROVENANCE. Takes no birth data. Call this before guessing an event string. Provenance is one of four values. BOOK_SOURCED means the corpus states this electional group for this matter, with the citation attached. WEB_SOURCED means a published KP source outside the books. DERIVED_TABLE_D means the group was generated by the corpus's own general formula, the matter's houses plus 6 and 11. DERIVED_CUSP_RULE means the corpus states a CUSP SUB LORD rule for this matter and the group was read off that rule, which is a different claim: "the sub lord of the 2nd cusp must stand in the star of a significator of 6 and 11" is not the sentence "elect on the significators of 2, 6 and 11". Both DERIVED values carry a derivation string. Each citation also carries 'quoteKind': VERBATIM (one sentence reproduced exactly), JOINED_SENTENCES (two or more consecutive sentences, the join stated rather than elided), TABLE_ROW_NO_PROSE (the rule is printed as a table row or numbered list item, so there is no sentence to quote), or NONE. 'quoteNote' says what the quote does and does not establish, and it is where a citation admits that it names a different house list than the row elects on. Read it before repeating a quote. Repeat these distinctions when a user asks where a rule comes from, and never present a derived group as a quoted one.

Parameters

NameTypeRequiredDescription
include_sourcesbooleanNoInclude the verbatim book quotes, derivations and cusp sub lord rules. Larger response. Default false.

Example call

Send the request as a standard MCP tools/call:

http
POST https://mcp.lumin.guru/mcp
Authorization: Bearer mcp_yourkey...
Accept: application/json, text/event-stream
Content-Type: application/json

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_election_catalog",
    "arguments": {}
  }
}