SoapBox Faith

Verify whether a quote is real Scripture and cited correctly (anti-hallucination). Returns whether it matches a real verse, the canonical KJV reference + text, a confidence score, and — if you pass a claimed reference — whether the attribution is correct. Use this before presenting any Bible quote to avoid misquotes/fabrications.

Look up a public-domain KJV Bible verse by book, chapter, and verse.

Look up a Strong's Greek/Hebrew lexicon entry (lemma, transliteration, gloss, definition).

Find churches near a location from SoapBox's public church directory. Given latitude/longitude (and optional radius, denomination filter), returns nearby churches with name, denomination, city/state/country, website, distance in miles, and whether the church is on SoapBox (with its community id for deep-linking). Public directory data only — no personal contact info.

Post a prayer request to SoapBox's prayer wall ON BEHALF OF A USER, so their community can pray for it. Requires the user's consent_token (which they generate in the SoapBox app and which must include the 'prayer:write' scope) — an API key alone is not enough to act for a user. Returns the new prayer_id; use check_prayer_status to see how many are praying.

Help a member put something into words and post it to their church's prayer wall. Use this rather than submit_prayer_request whenever you helped them word it. TWO CALLS, ON PURPOSE. Call once without `confirmed` and NOTHING is posted: you get back `will_post`, the exact text and visibility, plus `problems` — things worth raising, like a public request naming someone who has not been asked, or a ph

Check how many people are praying for a prayer request previously submitted for a user (and whether it's been marked answered). Requires the same user's consent_token; only returns status for that user's own prayers.

Fetch the member's OWN record of what they gave in a year — every gift, the church, the date, the amount, the fund, and totals per currency. Needs their consent token with the 'giving:read' scope. THIS IS NOT A TAX RECEIPT, and you must not present it as one. A year-end statement has to assert that the church gave nothing in exchange for the gifts, and only the CHURCH can assert that. The document

Make a one-time donation to a church ON BEHALF OF A USER, within the spending caps they pre-authorized. Requires the user's consent_token with the 'giving:write' scope (bound to this agent) and a card they saved in the SoapBox app. The gift goes straight to the church (passthrough — SoapBox takes no cut). Rejected if the amount exceeds the per-gift or monthly cap. Pass a stable idempotency_key to

Ask ORA, SoapBox's Scripture study aid, a Bible or faith question. Returns a grounded answer that cites public-domain (KJV) passages, plus the citations used. ORA is a STUDY AID — not a pastor, counselor, or therapist; for personal crises or pastoral/medical needs it points to a trusted pastor or professional. Use this for explanatory/study questions ('what does Romans 8 teach about...', 'where do

Semantically search real sermons on SoapBox that pastors have explicitly opted in to share with AI agents. Returns ranked transcript excerpts with the sermon title, church, speaker, scripture reference, and a start-time (seconds) so you can cite the exact moment. Use this to find what churches are actually preaching on a topic. Only consented, published sermons are searchable.

Fetch full metadata and (optionally) the transcript for ONE sermon by its id — typically a sermon_id returned by search_sermons. Only returns sermons a pastor has opted in to share with agents; otherwise returns not-found. If the sermon is paid and you haven't purchased it, the transcript is withheld and a price is returned — pay for it with pay_with_x402 (USDC on Base), which returns the transcri

Answer "which churches actually preach on X?". Searches consented sermons for a topic and groups the results BY CHURCH, so instead of scattered passages you get each church with how many of its sermons matched, how closely, and a representative excerpt with its timestamp. Useful for someone looking for a church home who cares what is taught there. No key required. TWO THINGS TO TELL THE PERSON, be

Turn one sermon into material a small group can work through. Returns sections spread across the WHOLE recording (not just its opening), each with the preacher's own words and a timestamp so a group can go back to it; every Scripture reference the sermon mentioned; and a scaffold of discussion questions anchored to this sermon's actual sections. YOU write the final guide. The scaffold is a startin

Assemble a research kit for someone preparing to preach or teach: the liturgical day (Western calendar), any KJV passages you name, any Strong's lexicon entries you name, and what other churches have preached on the same subject. One call instead of five. No key required. READ-ONLY, and it grants no special access. It reads exactly what any agent can already read — public-domain Scripture, the com

Pay for a paid sermon or bundle per-call in USDC on Base using the x402 protocol. This is the only TOOL here that buys SoapBox faith content: the prepaid marketplace-credit tools were retired on 2026-07-15 and their endpoints now answer HTTP 410. (A person can instead buy on the item's web_url in a browser.) No SoapBox account or API key is required — the payment IS the credential (https://github.

Report this API key's tier and daily rate limit — how many calls you have per day, not what you can afford. Nothing here gates a purchase: paid sermons and bundles are bought per-call with pay_with_x402 (USDC on Base), which needs no key and no balance at all. This tool was called get_credit_balance until the prepaid marketplace-credit wallet was retired on 2026-07-15; the old name still works but

Browse purchasable faith-content products on SoapBox (currently consented sermons; reading-plan and devotional bundles coming). Returns products with id, title, church, and price. Then pay for one with pay_with_x402 (USDC on Base). Optional church_id and text filter. No key required.

Assess how well a statement aligns with a named Christian tradition's historic doctrinal positions (e.g. Reformed, Roman Catholic, Pentecostal, Eastern Orthodox). Returns an impartial alignment rating, score, summary, and the relevant doctrinal loci. Analytical, not proselytizing. No key required.

Get the Western (Revised Common Lectionary / Roman) liturgical season, liturgical color, RCL year (A/B/C), and any major feast for a date (defaults to today). Useful for date-aware, season-appropriate faith content. Daily readings are not included (those tables are licensed). No key required.

Build a season-aware daily devotional for a date: the liturgical season and colour, a KJV passage chosen for that season, three reflection QUESTIONS, and a prompt for the member to pray in their own words. No key required. IMPORTANT, two things this is not. (1) It is NOT the lectionary: the reading is SoapBox's own seasonal selection, not the appointed Revised Common Lectionary reading, whose comp

The same daily devotional, SPOKEN — for members who would rather listen, or who read little. Returns audio URLs alongside the text. Requires an API key (speech costs money per character). Language: pass a consent_token with the 'context:read' scope and the member's own preferred language is used, so you need not ask them; or pass `language` explicitly for a one-off. If SoapBox has no voice for tha

Help a member learn a verse by heart. Two modes, no key needed. DRILL (omit `attempt`): returns the verse with words blanked out at the level you ask for — level 1 hides a quarter, 3 hides three quarters, 4 leaves first letters only, 5 shows nothing. The same reference and level always produce the same blanks, so practice builds on itself. CHECK (pass `attempt`): scores what they recalled. Returns

Generate spoken-audio (text-to-speech) for a verse, prayer, or devotional in 50+ languages, and get back a playable audio URL. Pass a BCP-47 language (e.g. en-US, es-ES, sw-KE, fil-PH, cmn-CN), optional voice/gender. Results are cached. Requires an API key (audio generation has real cost).

Read a user's portable 'faith context' to personalize your responses — their denomination, preferred language, faith journey, and ministry interests — shared WITH THE USER'S EXPLICIT CONSENT. Requires the user's consent_token with the 'context:read' scope (bound to this agent). Use it to tailor tone, tradition, and language. It returns only the user's declared profile (never their private prayers