# Connect Your AI to Apologetics Wiki

The MCP server is live at https://apologetics.wiki/mcp. Reading every article, hub, common argument, and the King James text with its Greek or Hebrew study data is free. No account is required.

Signing in lets you submit a suggestion or a draft article, credited to your account. GitHub is the preferred sign-in, because the login helps us review who is writing. An emailed one-time code is the fallback. Signing in is not authorship. Every submission goes to a review queue. Nothing publishes directly. A new account is a suggester. We review the account before granting contributor access, which is the reviewed-author role. A contributor is flagged `trusted_author` and has a higher daily cap. The page still waits for a person.

The site will eventually be open source, with agents contributing through GitHub. For now, contributions go only through this MCP process.

## Claude

Open Settings, then Connectors, then Add custom connector. Paste `https://apologetics.wiki/mcp`. Choose Connect to sign in when you want to suggest a change. Reading works before you sign in.

## ChatGPT

Open Settings, then Apps and Connectors (developer mode on some accounts). Create a connector with the URL `https://apologetics.wiki/mcp` and OAuth. The exact menu name varies by account. The URL and the OAuth discovery documents are what the client needs.

## Cursor

Add this to `~/.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "apologetics-wiki": {
      "url": "https://apologetics.wiki/mcp"
    }
  }
}
```

## Claude Code

```
claude mcp add --transport http apologetics-wiki https://apologetics.wiki/mcp
```

## Any other MCP client

Point the client at `https://apologetics.wiki/mcp` (Streamable HTTP). The protected-resource metadata is https://apologetics.wiki/.well-known/oauth-protected-resource/mcp. Register a client at https://apologetics.wiki/oauth/register if the client does not register itself. PKCE S256 is required. MCP Inspector can use the same URL.

## Technical details

| Item | Value |
| --- | --- |
| MCP URL | https://apologetics.wiki/mcp |
| Transport | Streamable HTTP JSON-RPC |
| OAuth issuer | https://apologetics.wiki |
| Authorization | https://apologetics.wiki/oauth/authorize |
| Token | https://apologetics.wiki/oauth/token |
| Registration | https://apologetics.wiki/oauth/register |
| Scopes | read, suggest, offline_access |
| Protected resource | https://apologetics.wiki/.well-known/oauth-protected-resource/mcp |
| Server card | https://apologetics.wiki/.well-known/mcp/server-card.json |
| auth.md | https://apologetics.wiki/auth.md |
| API catalog | https://apologetics.wiki/.well-known/api-catalog |
| Agent skills | https://apologetics.wiki/.well-known/agent-skills/index.json |
| llms.txt | https://apologetics.wiki/llms.txt |
| DNS-AID | `_index._agents`, `_mcp._agents`, and `_a2a._agents` SVCB records point at apologetics.wiki, port 443. DNSSEC is on. |

## Rate limits

| Limit | Amount |
| --- | --- |
| Anonymous reads (tools/list, read tools, public JSON) | 60 per minute per IP |
| Signed-in MCP calls | 120 per minute per account |
| Suggestion submits | 5 per minute per account; 20 per day for a suggester; 60 per day for a contributor; 500 per day for the whole site |
| OAuth client registration | 10 per minute per IP; 30 per day per IP; 300 per day for the whole site |
| Email code requests | 5 per minute per IP; 3 per 15 minutes per address; 10 per day per address; 200 outbound messages per day |
| Code verification | 20 per minute per IP; 5 attempts per code |
| Token endpoint | 30 per minute per IP |
| GitHub callback | 10 per minute per IP |
| MCP request body | 128 KB |
| OAuth request body | 16 KB |
| JSON-RPC batch | 10 calls |

Anonymous reads are 60 per minute per IP. A signed-in call is 120 per minute per account. A suggestion is 5 per minute, 20 per day for a suggester, 60 per day for a contributor, and 500 per day for the whole site.

## Tools

### Free to read

- `search_articles` — Search published articles by title, description, tags, and shelf. [no key]
- `search` — ChatGPT-compatible search. Returns results with id, title, url, and text. [no key]
- `fetch` — ChatGPT-compatible fetch by id (article:, hub:, or bible:). [no key]
- `get_article` — Published Markdown mirror for an article path or slug, with title, canonical URL, and sources. [no key]
- `list_articles` — List published articles, optionally on one shelf. [no key]
- `list_shelves` — Religions, beliefs, denominations, and Islam branches, with hub URLs, sections, and article counts. [no key]
- `get_bible_passage` — King James text plus Greek (New Testament) or Hebrew (Old Testament) word-by-word study data, and Young’s or JPS when that edition has the line. [no key]
- `get_word_study` — Greek or Hebrew word-page data from the same indexes as /bible/greek and /bible/hebrew. Pass a slug or a Strong’s number. [no key]
- `list_common_arguments` — Claims that recur in conversation: the claim, a one-line answer, the texts, and the article URL or Article coming. [no key]
- `site_summary` — Mission, shelves, how to cite, and links to llms.txt, skill.md, and Connect. [no key]

### Sign-in required

- `suggest_article_change` — Submit a change to a published page. It is stored as pending and is not published. [sign-in required]
- `propose_new_article` — Propose a new article. It is stored as pending. A contributor is flagged trusted_author and is still reviewed. [sign-in required]
- `my_suggestions` — The signed-in account’s own suggestions and their review status. [sign-in required]
- `whoami` — Account id, display name, GitHub login, role, and today’s remaining suggestion quota. [sign-in required]