mcpField
K

kairos

Local

About kairos

Astrology decision support: accurate Swiss Ephemeris charts with calibrated classical verdicts.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
"mcpServers": {
"stardustxx-kairos": {
"command": "npx",
"args": [
"-y",
"kairos-astrology"
]
}
}
}
Run commandnpx -y kairos-astrology

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmkairos-astrology1.1.0

Tools

15

Saved tool list · updated 2w ago

ParameterTypeRequiredDescription
kindenumYesChart kind. Drives which other fields are required.natal | transit | horary | electional
natalobjectNoRequired only for kind "transit": the natal chart.
natal.latitudenumberYes
natal.timezonestringNoIANA zone, e.g. "America/New_York".
natal.longitudenumberYes
natal.houseSystemstringNoSingle-letter house system code, default "P".
natal.datetimeLocalstringYesLocal civil datetime, ISO without offset, e.g. "1990-05-21T14:30:00".
momentobjectNoThe chart's own moment. Required for natal/transit/horary; for "transit" use now.
moment.latitudenumberYes
moment.timezonestringNoIANA zone, e.g. "America/New_York".
moment.longitudenumberYes
moment.houseSystemstringNoSingle-letter house system code, default "P".
moment.datetimeLocalstringYesLocal civil datetime, ISO without offset, e.g. "1990-05-21T14:30:00".
windowobjectNoRequired for "electional": local-time window to scan (ISO without offset).
window.endLocalstringYes
window.startLocalstringYes
journalobjectNoOptional auto-logging: when present, the compute appends a journal entry (the engine-derived fields plus this question) and returns the new entry id.
journal.questionstringYes
journal.verdictTextstringNo
locationobjectNoRequired for "electional": the place to cast each candidate chart for.
location.latitudenumberYes
location.timezonestringNo
location.longitudenumberYes
location.houseSystemstringNo
location.datetimeLocalstringNo
relocationobjectNoOptional: recast the chart's houses/angles for another place (same moment).
relocation.latitudenumberYes
relocation.timezonestringNo
relocation.longitudenumberYes
relocation.houseSystemstringNo
relocation.datetimeLocalstringNo
stepMinutesnumberNoRequired for "electional": scan interval in minutes (e.g. 15).
querentHouseintegerNoHorary only. Radix house (1..12) the QUERENT's significator is read from (default 1, the asker). Set to TURN THE CHART for a third-party question: the querent house becomes the radix house of the person the matter is about (e.g. 7 for a partner), and quesitedHouse becomes their concern's DERIVED radix house.
quesitedHouseintegerNoHouse of the matter (2..12). Required for horary; reused by electional.
significatorHintsobjectNoOptional for "electional": steer significator choice/weighting.
significatorHints.planetstringNo
significatorHints.beneficWeightingnumberNo

Details

The maintainer has not added details yet. Check the README in the repository.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.