Skip to main content
Glama
alansafahi

soapbox-faith

by alansafahi
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Hybrid

SoapBox Faith — MCP Server

Faith tools for AI agents: cited, public-domain (KJV) Scripture, ORA Bible Q&A, real sermon search, a church directory, and consent-gated prayer & giving. This is the official Model Context Protocol server for SoapBox Super App.

It's a thin protocol adapter: it speaks MCP (JSON-RPC 2.0 over Streamable HTTP) and forwards each tool call to SoapBox's hosted Faith Content API, which owns the auth, metering, and content logic.

Auth — keyless-first

The read tools need no API key — point your client at the endpoint and call them (per-IP rate-limited). A key is required only for tools that cost money to run or act on a user's behalf. Pass it as Authorization: Bearer <key> when needed; self-serve one at https://soapboxsuperapp.com/developers.

Free (no key)

Key required

verify_scripture · get_verse · lookup_strongs · find_churches · ask_ora · search_sermons · get_sermon · get_lectionary · browse_catalog · score_doctrinal_fit · pay_with_x402

synthesize_speech · get_api_key_status · submit_prayer_request · check_prayer_status · give_to_church · get_faith_context

Prayer and giving additionally require an explicit, user-issued consent token (they act on a real person's behalf). Prayer submits a request to a live human community prayer wall — the AI does not "pray for you." Giving is passthrough — SoapBox takes no cut of donations.

Buying content. pay_with_x402 is keyless — the payment itself is the credential — and it is the only way an agent buys a paid sermon or bundle. The prepaid marketplace-credit tools (purchase_sermon, purchase_bundle) were retired on 2026-07-15: their endpoints answer HTTP 410, and they are no longer listed. A purchase is a content sale, never a donation — the church keeps 70% of net and SoapBox is Merchant of Record on sales only. get_api_key_status (called get_credit_balance before 2.0.0, which still routes but is unlisted) survives only to report your key's tier and daily rate limit; its balance field is always 0 and gates nothing.

Related MCP server: SolaGuard MCP Server

Connect from Claude (remote MCP)

Add a custom connector with the hosted URL above. Free tools work immediately; add an Authorization: Bearer <key> header to unlock the key-gated tools.

Highlights

  • Anti-hallucination: call verify_scripture before presenting any Bible quote — it confirms the quote is real and cited to the correct KJV reference.

  • Grounded Q&A: ask_ora returns KJV-cited answers (a study aid, crisis-safe — not a counselor).

  • Real, consented content: search_sermons covers sermons pastors explicitly opted in to share with agents.

  • Agent-native payments: pay_with_x402 pays per-call in USDC on Base (x402) — no account required. The paying wallet signs for its own payment, so a transaction hash alone can't be spent by anyone who sees it on-chain.

Run it yourself

# Deno 2.x
deno run --allow-net --allow-env index.ts        # serves on http://localhost:8000

# or Docker
docker build -t soapbox-faith .
docker run -p 8000:8000 soapbox-faith

SUPABASE_URL defaults to the production host, so read tools work out of the box. The MCP handshake (initialize, tools/list, resources/list) needs no configuration.

Resources

  • soapbox://catalog — the live faith-content catalog as JSON (via MCP resources/read).

License

MIT © SoapBox Super App. See LICENSE.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Bible MCP Server

    geosp
    F
    license
    A
    quality
    F
    maintenance
    Enables AI assistants to retrieve Bible passages from multiple translations (ESV, NIV, KJV, NASB, NKJV, NLT, AMP, MSG). Supports querying single or multiple passages and provides both MCP protocol integration and REST API endpoints.
    1
    10
    -

  • SolaGuard MCP Server

    jissac
    A
    license
    A
    quality
    D
    maintenance
    Provides comprehensive Biblical research tools including scripture lookup, interlinear Greek/Hebrew data, and Strong's concordance within a Protestant theological framework. It enables AI applications to perform full-text biblical searches, topical studies, and cross-referencing using authoritative theological data.
    MIT

  • Echo Prayer MCP Server

    faith-tools
    A
    license
    Not graded
    quality
    D
    maintenance
    Provides guided prayers, semantic search, and pastoral care tools (encouragement, condolence, advice) via a read-only database without authentication.
    MIT