When to use ChristianPicks
Use ChristianPicks when you need to search, compare, or cite Christian software, church tools, Bible apps, or Christian-owned businesses. Start with the OpenAPI document, then call the catalog API or an MCP server. Do not use this API for account administration or general web search.
OpenAPI and REST
The public catalog is reachable without authentication:
- OpenAPI 3.1 at
/openapi.json - OpenAPI YAML at
/api/openapi.yaml - Catalog manifest at
/apiand/api/v1 - Sandbox at
/api/sandbox— read-only, never writes production data - Search:
GET /api/ai/search?q=bible
Errors return JSON with error.code, error.message, and error.hint.
Quickstart
Call the public REST API with no API key:
curl "https://christianpicks.com/api/ai/search?q=bible"Or fetch the OpenAPI document first, then pick an operation:
curl "https://christianpicks.com/openapi.json"
curl "https://christianpicks.com/api/openapi.json"Try the same search against the sandbox. It is read-only and never writes production data:
curl "https://christianpicks.com/api/sandbox"API keys
Catalog GET endpoints do not require an API key. Start without authentication.
If you want a client identity for rate limits, register an anonymous agent and exchange it for a catalog:read token:
curl -X POST "https://christianpicks.com/oauth/register" -H "Content-Type: application/json" -d '{"client_name":"my-agent"}'
curl -X POST "https://christianpicks.com/oauth/token" -H "Content-Type: application/json" -d '{"grant_type":"client_credentials","client_id":"YOUR_CLIENT_ID"}'Send the token as Authorization: Bearer …. See auth.md for the full walkthrough.
Sandbox
The sandbox environment is /api/sandbox. Use it to explore the catalog without affecting production data. Send X-Sandbox: true or call the sandbox URL. Writes are not accepted.
MCP and agent discovery
- Catalog MCP (Streamable HTTP): https://christianpicks.com/mcp
- Docs MCP (Streamable HTTP): https://christianpicks.com/mcp/docs
- Server card: /.well-known/mcp/server-card.json
- AI catalog: /.well-known/ai-catalog.json
- A2A agent card: /.well-known/agent-card.json
- Agent skill: SKILL.md
Authentication
Catalog GET endpoints do not require a token. Optional anonymous registration is documented in auth.md.
- Protected resource metadata: RFC 9728
- Authorization server metadata: RFC 8414
register_uri: /oauth/register
Source and skills
The public GitHub repository includes AGENTS.md, plugin.json, and skills:
https://github.com/praisondani/christianpicks
Markdown homepage: /index.md. Agent view: /?mode=agent.