Opening the portal
An API by Caminho Anglicano
Check statusThe questions that come up before the first call, answered from what this portal documents.
01
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.
02
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.
03
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.
04
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
The /bible_versions endpoint lists the available translations, each with its language, publisher and licence. There are more than twenty versions, and the chosen version follows the readings returned by the calendar.
06
Send your key in the X-API-Key header. The key is created in the portal dashboard and belongs in a server-side environment variable, never in code that runs in the browser. The calendar and explanation endpoints require preferences with at least prayer_book_code.
07
Yes. The hosted server lives at https://mcp.caminhoanglicano.com.br/mcp and connects Claude, Codex, Gemini CLI, VS Code, Cursor and other Model Context Protocol clients. On the hosted server you sign in through the browser instead of pasting a key.
08
The first seven days are a trial. After that, the plan you pick sets the request limit of each key, and billing runs through Stripe in reais or dollars. The plans are on the pricing page.
09
Each key is limited by the account's plan, with a daily limit that resets every 24 hours and a per-minute limit against spikes. When a limit is reached the response is a 429 carrying the Retry-After header.
10
The portal and the documentation are in Portuguese, English and Spanish. In the data, each Bible version declares its own language, and the preferences of each prayer book set the tradition being followed.
11
Yes. The playground runs the call through the portal's own proxy — you pick the endpoint and the parameters and read the full response, without exposing your key in the browser.
12
It shows the reasoning behind the date: precedence between competing celebrations, transfers when a feast is moved, and the origin of each reading. It is the endpoint that makes the answer checkable rather than merely asserted.
The documentation covers each endpoint in detail, and the playground runs the call before you write it into your code.