# Estevão — liturgical API

> REST API for the Anglican liturgical calendar: day, season, celebrations, collects, lectionary readings, prayer books and Bible versions, with docs, playground and an MCP server.

Estevão is a REST API published by Caminho Anglicano. It answers questions about
the Anglican liturgical calendar — what day it is liturgically, which celebrations
fall on a date, which readings and collects belong to it, which prayer book and
lectionary variant selected them, and which Bible translations are available.
Responses are JSON. Calls are authenticated with an `X-API-Key` header.

- API base URL: https://api.caminhoanglicano.com.br/api/v1
- MCP server: https://mcp.caminhoanglicano.com.br/mcp
- Portal: https://estevao.caminhoanglicano.com.br
- Languages of this portal: Portuguese (default, unprefixed), English (/en), Spanish (/es)

## Endpoints

- `GET /calendar/today` — The current liturgical day: season, celebrations, collects and readings.
- `GET /calendar/{year}` — The liturgical year.
- `GET /calendar/{year}/{month}` — One month of the liturgical calendar.
- `GET /calendar/{year}/{month}/{day}` — One liturgical day.
- `GET /calendar/{year}/overview` — An overview of the liturgical year.
- `GET /calendar/{year}/seasons` — The liturgical seasons of a year, with their boundaries.
- `GET /calendar/{year}/celebrations` — The celebrations of a year.
- `GET /calendar/{year}/key_dates` — The movable dates a year turns on.
- `GET /liturgical_explanation/{year}/{month}/{day}` — Why a day resolved the way it did: precedence, transfers and the origin of each reading.
- `GET /prayer_books` — The prayer book catalogue, with the offices of each edition.
- `GET /prayer_books/{prayer_book_code}/preferences` — The preferences a given prayer book accepts.
- `GET /bible_versions` — The available Bible translations, with language, publisher and licence.

## Documentation

### Português (Brasil)

- [API litúrgica — calendário, lecionário, coletas e Bíblia](https://estevao.caminhoanglicano.com.br/): Consulte o calendário litúrgico anglicano, as leituras do lecionário, as coletas, os livros de oração e as versões bíblicas em uma única API REST documentada.
- [Documentação da API litúrgica](https://estevao.caminhoanglicano.com.br/docs): Referência da API Estevão: como autenticar, escolher a fonte dos dados litúrgicos e conferir cada resposta em JSON.
- [Autenticação da API — chave X-API-Key](https://estevao.caminhoanglicano.com.br/docs/auth): Como autenticar chamadas à API litúrgica Estevão com o cabeçalho X-API-Key, proteger a chave e entender os limites por plano.
- [API de calendário litúrgico — dia, mês e ano](https://estevao.caminhoanglicano.com.br/docs/calendar): Endpoints para consultar o dia litúrgico, o mês, o ano, os tempos, as celebrações, as datas-chave, as coletas e as leituras do calendário anglicano.
- [API de explicação litúrgica — precedência e origem das leituras](https://estevao.caminhoanglicano.com.br/docs/explanations): Como a API Estevão registra a precedência entre celebrações, as transferências de data e a origem de cada leitura devolvida.
- [API de livros de oração — edições, ofícios e preferências](https://estevao.caminhoanglicano.com.br/docs/prayer-books): Edições de livros de oração disponíveis na API, com os ofícios de cada uma e as preferências aceitas para selecionar leituras e coletas.
- [API da Bíblia — versões e traduções disponíveis](https://estevao.caminhoanglicano.com.br/docs/bible): Traduções bíblicas disponíveis na API Estevão, com idioma, editora e licença de cada versão usada nas leituras.
- [Servidor MCP litúrgico — Claude, Codex e outros clientes](https://estevao.caminhoanglicano.com.br/mcp): Conecte Claude, Codex, Gemini CLI, VS Code e outros clientes MCP ao calendário litúrgico, ao lecionário e ao Ofício Diário pela API Estevão.
- [Perguntas frequentes sobre a API litúrgica](https://estevao.caminhoanglicano.com.br/faq): O que a API Estevão devolve, como autenticar, quais livros de oração e versões da Bíblia estão disponíveis, e como conectá-la por MCP.
- [Feito com Estevão — projetos que usam a API litúrgica](https://estevao.caminhoanglicano.com.br/showcase): Aplicativos, sites, plugins, dispositivos e assistentes que consultam o calendário litúrgico, o lecionário e o Ofício Diário pela API Estevão.
- [Planos e preços da API litúrgica](https://estevao.caminhoanglicano.com.br/pricing): Planos da API Estevão: limites de requisição por chave, sete dias de teste e cobrança em reais ou dólares.
- [Status da API litúrgica](https://estevao.caminhoanglicano.com.br/status): Disponibilidade e tempo de resposta da API Estevão, atualizados a partir do monitoramento externo.

### English

- [Liturgical API — calendar, lectionary, collects and Bible](https://estevao.caminhoanglicano.com.br/en/): Query the Anglican liturgical calendar, lectionary readings, collects, prayer books and Bible versions through a single documented REST API.
- [Liturgical API documentation](https://estevao.caminhoanglicano.com.br/en/docs): The Estevão API reference: how to authenticate, choose the source of the liturgical data and check every JSON response.
- [API authentication — the X-API-Key header](https://estevao.caminhoanglicano.com.br/en/docs/auth): How to authenticate calls to the Estevão liturgical API with the X-API-Key header, keep the key safe and read the per-plan limits.
- [Liturgical calendar API — day, month and year](https://estevao.caminhoanglicano.com.br/en/docs/calendar): Endpoints for the liturgical day, month, year, seasons, celebrations, key dates, collects and readings of the Anglican calendar.
- [Liturgical explanation API — precedence and reading sources](https://estevao.caminhoanglicano.com.br/en/docs/explanations): How the Estevão API records precedence between celebrations, transferred feasts and the origin of every reading it returns.
- [Prayer book API — editions, offices and preferences](https://estevao.caminhoanglicano.com.br/en/docs/prayer-books): Prayer book editions available in the API, the offices each one carries and the preferences accepted when selecting readings and collects.
- [Bible API — available versions and translations](https://estevao.caminhoanglicano.com.br/en/docs/bible): Bible translations available in the Estevão API, each with its language, publisher and licence, used for the readings.
- [Liturgical MCP server — Claude, Codex and other clients](https://estevao.caminhoanglicano.com.br/en/mcp): Connect Claude, Codex, Gemini CLI, VS Code and other MCP clients to the liturgical calendar, the lectionary and the Daily Office through the Estevão API.
- [Liturgical API — frequently asked questions](https://estevao.caminhoanglicano.com.br/en/faq): What the Estevão API returns, how to authenticate, which prayer books and Bible versions are available, and how to connect it over MCP.
- [Built with Estevão — projects using the liturgical API](https://estevao.caminhoanglicano.com.br/en/showcase): Apps, sites, plugins, devices and assistants querying the liturgical calendar, the lectionary and the Daily Office through the Estevão API.
- [Liturgical API plans and pricing](https://estevao.caminhoanglicano.com.br/en/pricing): Estevão API plans: per-key request limits, a seven-day trial, and billing in reais or dollars.
- [Liturgical API status](https://estevao.caminhoanglicano.com.br/en/status): Availability and response time of the Estevão API, from external monitoring.

### Español

- [API litúrgica — calendario, leccionario, colectas y Biblia](https://estevao.caminhoanglicano.com.br/es/): Consulta el calendario litúrgico anglicano, las lecturas del leccionario, las colectas, los libros de oración y las versiones bíblicas en una sola API REST documentada.
- [Documentación de la API litúrgica](https://estevao.caminhoanglicano.com.br/es/docs): Referencia de la API Estevão: cómo autenticar, elegir la fuente de los datos litúrgicos y verificar cada respuesta en JSON.
- [Autenticación de la API — cabecera X-API-Key](https://estevao.caminhoanglicano.com.br/es/docs/auth): Cómo autenticar llamadas a la API litúrgica Estevão con la cabecera X-API-Key, proteger la clave y conocer los límites por plan.
- [API de calendario litúrgico — día, mes y año](https://estevao.caminhoanglicano.com.br/es/docs/calendar): Endpoints para consultar el día litúrgico, el mes, el año, los tiempos, las celebraciones, las fechas clave, las colectas y las lecturas del calendario anglicano.
- [API de explicación litúrgica — precedencia y origen de las lecturas](https://estevao.caminhoanglicano.com.br/es/docs/explanations): Cómo la API Estevão registra la precedencia entre celebraciones, los traslados de fecha y el origen de cada lectura devuelta.
- [API de libros de oración — ediciones, oficios y preferencias](https://estevao.caminhoanglicano.com.br/es/docs/prayer-books): Ediciones de libros de oración disponibles en la API, con los oficios de cada una y las preferencias aceptadas para elegir lecturas y colectas.
- [API de la Biblia — versiones y traducciones disponibles](https://estevao.caminhoanglicano.com.br/es/docs/bible): Traducciones bíblicas disponibles en la API Estevão, cada una con su idioma, editorial y licencia, usadas en las lecturas.
- [Servidor MCP litúrgico — Claude, Codex y otros clientes](https://estevao.caminhoanglicano.com.br/es/mcp): Conecta Claude, Codex, Gemini CLI, VS Code y otros clientes MCP al calendario litúrgico, al leccionario y al Oficio Diario con la API Estevão.
- [Preguntas frecuentes sobre la API litúrgica](https://estevao.caminhoanglicano.com.br/es/faq): Qué devuelve la API Estevão, cómo autenticar, qué libros de oración y versiones bíblicas hay disponibles, y cómo conectarla por MCP.
- [Hecho con Estevão — proyectos que usan la API litúrgica](https://estevao.caminhoanglicano.com.br/es/showcase): Aplicaciones, sitios, plugins, dispositivos y asistentes que consultan el calendario litúrgico, el leccionario y el Oficio Diario con la API Estevão.
- [Planes y precios de la API litúrgica](https://estevao.caminhoanglicano.com.br/es/pricing): Planes de la API Estevão: límites de solicitudes por clave, siete días de prueba y cobro en reales o dólares.
- [Estado de la API litúrgica](https://estevao.caminhoanglicano.com.br/es/status): Disponibilidad y tiempo de respuesta de la API Estevão, según el monitoreo externo.

## Optional

- [Full text of this brief](https://estevao.caminhoanglicano.com.br/llms-full.txt): every documented endpoint and every answered question, expanded.
- [Sitemap](https://estevao.caminhoanglicano.com.br/sitemap_index.xml)