Uwierz Bogu

Dla agentów AI i programistów

Treści uwierzbogu.pl — webinary biblijne z transkrypcjami, artykuły i odpowiedzi na pytania — są dostępne dla asystentów AI i aplikacji. Wszystko jest publiczne, tylko do odczytu i nie wymaga logowania. Limit: 60 zapytań na minutę z jednego adresu. Przy cytowaniu podawaj adres url z odpowiedzi. Wyjątek: agent może też — po zalogowaniu czytelnika (OAuth 2.1) — zapisywać go na webinary; zobacz Zapisy na webinary przez agenta.

Serwer MCP

Adres: https://uwierzbogu.pl/mcp (Streamable HTTP). Konfiguracja klienta:

{
  "mcpServers": {
    "uwierzbogu": { "type": "http", "url": "https://uwierzbogu.pl/mcp" }
  }
}

Karta serwera: /.well-known/mcp/server-card.json

Narzędzia

  • search_content (Szukaj w serwisie) — Wyszukuje webinary biblijne, artykuły z Czytelni i odpowiedzi z działu Pytania i Odpowiedzi na uwierzbogu.pl. Zwraca tytuł, krótkie streszczenie, kategorię, datę i adres url do zacytowania. Zapytanie po polsku, np. „zmartwychwstanie”, „Trójca”, „modlitwa”. REST: GET /api/v1/search
  • list_webinars (Lista webinarów) — Najnowsze nagrane webinary albo (upcoming=true) najbliższe zaplanowane webinary z datą i godziną (UTC) oraz stroną zapisu. Opcjonalnie filtr po temacie (slug z list_topics). REST: GET /api/v1/webinars
  • get_webinar (Szczegóły webinaru) — Pełny opis webinaru po slugu (z adresu /webinary/<slug>): temat, prowadzący, data, link do nagrania na YouTube i wersji audio. include_transcript=true dodaje pełną transkrypcję wykładu (długi tekst). Slug znajdziesz przez search_content albo list_webinars. REST: GET /api/v1/webinars/{slug}
  • get_article (Artykuł z Czytelni) — Pełna treść artykułu po slugu (z adresu /czytelnia/<slug>) w Markdown, z kategorią i datą publikacji. Slug znajdziesz przez search_content. REST: GET /api/v1/articles/{slug}
  • search_faq (Pytania i odpowiedzi biblijne) — Krótkie odpowiedzi na pytania biblijne (dział Pytania i Odpowiedzi) z wersetami źródłowymi i adresem url każdej odpowiedzi. Bez zapytania zwraca pierwsze pytania w kolejności z serwisu. REST: GET /api/v1/faq
  • list_topics (Tematy) — Tematy (kategorie) serwisu ze slugami do filtrowania webinarów i adresami stron tematów. REST: GET /api/v1/topics

REST API

Baza: https://uwierzbogu.pl/api/v1/, opis OpenAPI 3.1: /openapi.json, katalog API: /.well-known/api-catalog.

curl "https://uwierzbogu.pl/api/v1/search?q=zmartwychwstanie"

Markdown i llms.txt

Każdy artykuł, webinar i strona Pytań i Odpowiedzi jest dostępna jako Markdown po wysłaniu nagłówka Accept: text/markdown. Mapa całej treści: /llms.txt. Skill dla agentów: /.well-known/agent-skills/index.json.

Zapisy na webinary przez agenta (OAuth 2.1)

Czytelnik może pozwolić asystentowi AI zapisywać się na webinary w swoim imieniu. Logowanie odbywa się bez hasła: czytelnik podaje e-mail, klika link (albo wpisuje 6-cyfrowy kod) i na ekranie zgody widzi, która aplikacja prosi o dostęp i do czego. Zapis przez agenta działa tak samo jak formularz na stronie webinaru — przypomnienia przychodzą e-mailem. Zgoda na newsletter jest osobnym, nieobowiązkowym polem na ekranie zgody.

  • list_my_webinar_registrations (webinars:read) — Wymaga zalogowania (OAuth, scope webinars:read). Nadchodzące i minione webinary Uwierz Bogu, na które zapisany jest czytelnik: tytuł, termin (UTC), adres strony i data zapisu.
  • register_for_webinar (webinars:write) — Wymaga zalogowania (OAuth, scope webinars:write). Zapisuje czytelnika na nadchodzący webinar (tylko status upcoming) — tak samo jak formularz na stronie webinaru: przypomnienia przyjdą e-mailem na adres czytelnika. Ponowny zapis na ten sam webinar nic nie zmienia. Limit: 20 zapisów na dobę.
  • cancel_webinar_registration (webinars:write) — Wymaga zalogowania (OAuth, scope webinars:write). Usuwa zapis czytelnika na jeden webinar (slug z list_my_webinar_registrations). Newsletter i inne zapisy zostają.

Zakresy:

  • webinars:read — zobaczyć, na które webinary Uwierz Bogu jesteś zapisany (tytuły i terminy)
  • webinars:write — zapisywać Cię na webinary Uwierz Bogu i wypisywać z nich (przypomnienia przyjdą e-mailem, tak jak po zapisie przez formularz na stronie)

Klienci MCP odkrywają wszystko sami: wywołanie chronionego narzędzia bez tokenu daje HTTP 401 z nagłówkiem WWW-Authenticate wskazującym metadane zasobu, a te — metadane serwera autoryzacji (dynamiczna rejestracja klienta, PKCE S256). Agent bez przeglądarki może się zarejestrować metodą auth.md (adres e-mail czytelnika + kod potwierdzany przez czytelnika na naszej stronie). Pełna instrukcja: /auth.md.

Czytelnik w każdej chwili sprawdzi i odwoła dostęp na stronie Twoje połączone aplikacje; odwołanie działa natychmiast.

English

uwierzbogu.pl offers a public, read-only MCP server (https://uwierzbogu.pl/mcp), a REST API with an OpenAPI description and Markdown versions of every content page (Accept: text/markdown). No authentication; 60 requests per minute per IP. Please cite the url field. With the reader's consent (OAuth 2.1, e-mail sign-in, PKCE S256, dynamic client registration or auth.md agent registration) the MCP server also lets an agent list, add and cancel the reader's webinar registrations — see /auth.md.