01
Liturgical calendar
Days, seasons, colours, celebrations, collects and readings. Query one date, a month, or the whole shape of the year.
Open reference →An API by Caminho AnglicanoThe liturgy, arranged
The liturgy, arranged
to be queried.
Estêvão brings together the calendar, readings, collects, prayer books and Bible versions. Name the tradition and the date to get the liturgical data that belongs to them.
Sources and choices
EESTÊVÃO / V1
Queries
01 / What the catalogue holds
Not a list of dates with saints' names attached.
A single query can carry the liturgical day, the celebration, the colour, the collects and the readings that go with them. Prayer books and lectionary variants stay explicit in the response — the response never hides where a choice came from.
02
Prayer books
Available editions, jurisdiction, language, offices and the preferences each book carries, lectionary variants included.
Open reference →03
Text and context
Bible versions, references and explanations that record the choices used to assemble each liturgical response.
Open reference →02 / A real query
The response shows where it came from.
For 25 March 2026, say, you can ask for the day according to the BCP 1662 and pick the table revised in 1922. The chosen variant comes back alongside the readings.
GET /liturgical_explanation/2026/03/25200 · JSON
{
"data": {
"date": "2026-03-25",
"prayer_book_code": "loc_1662_en",
"reading_guide": {
"lectionary": { "code": "revised_1922" }
},
"readings": [
{ "slot": "first_reading",
"reference": "Isaiah 52:7-12",
"service_type": "morning_prayer" }
]
}
}03 / For MCP clients
Use the catalogue in your MCP client.
The MCP server connects compatible clients to the same catalogue. Sign-in happens in the browser and the tools are read-only.
> what are the readings for next Sunday?
Set up the MCP server →What is the Estevão API?
It is a REST API from Caminho Anglicano that brings the liturgical calendar, readings, collects, prayer books and Bible versions together in one set of endpoints, returning JSON. The relationships between them are preserved: a day points to its liturgical season, its celebrations, its collects and its readings.
How do I query the liturgical calendar through an API?
Call the calendar endpoints with a date. /calendar/today returns the current day; /calendar/2026/03/25 returns a specific day; /calendar/2026 returns the year. There are also views by season, celebrations, key dates and a year overview.
Does the API return the daily readings and the lectionary?
Yes. A day's response carries the readings selected by the lectionary, together with the matching collects. The liturgical explanation records which lectionary variant was used and where each reading came from.
Which prayer books are available?
The prayer books reference lists the available editions — among them LOC 2015 and BCP 2019 — with the offices each one carries (morning, midday, evening and compline) and the preferences it accepts. The /prayer_books endpoint returns the current catalogue.
05 / Getting started
Look at the response first.
The documentation covers authentication, parameters and example responses. In the playground your key is attached on the server, so it never has to be pasted on screen.