---
title: "ChristianPicks developer resources"
description: "API docs, OpenAPI, MCP, authentication, and agent instructions for ChristianPicks."
canonical: "https://christianpicks.com/developers"
last-updated: "2026-08-28"
---
# ChristianPicks developer resources

> API docs, OpenAPI, MCP, authentication, and agent instructions for ChristianPicks.

This page is the developer entry point for ChristianPicks. Agents should start here, then fetch the OpenAPI document and `/auth.md`.

## When to use this

Use the ChristianPicks API when you need to search or cite Christian software, church tools, Bible apps, or Christian-owned businesses. Prefer `GET /api/ai/search` for discovery and Markdown mirrors (`/products/{slug}.md`) for citations.

## OpenAPI and REST

- [OpenAPI 3.1](https://christianpicks.com/openapi.json)
- [OpenAPI YAML](https://christianpicks.com/api/openapi.yaml)
- [Catalog manifest](https://christianpicks.com/api)
- [Versioned API](https://christianpicks.com/api/v1)
- [Sandbox](https://christianpicks.com/api/sandbox) — read-only; never writes production data

All catalog GET endpoints are publicly reachable and return JSON. Errors use a structured `error.code`, `error.message`, and `error.hint` body.

## Quickstart

```bash
curl "https://christianpicks.com/api/ai/search?q=bible"
curl "https://christianpicks.com/openapi.json"
curl "https://christianpicks.com/api/openapi.json"
curl "https://christianpicks.com/api/sandbox"
```

## API keys

Catalog GET endpoints do not require an API key. Optional anonymous `catalog:read` tokens come from `POST https://christianpicks.com/oauth/register` then `POST https://christianpicks.com/oauth/token`.

## Sandbox

Use `https://christianpicks.com/api/sandbox` or send `X-Sandbox: true`. The sandbox is read-only and never writes production data.

## MCP servers

- Catalog MCP (Streamable HTTP): https://christianpicks.com/mcp
- Docs MCP (Streamable HTTP): https://christianpicks.com/mcp/docs
- Server card: https://christianpicks.com/.well-known/mcp/server-card.json
- Well-known MCP: https://christianpicks.com/.well-known/mcp

## Authentication

- [auth.md](https://christianpicks.com/auth.md) — WorkOS auth.md skill with Discover, Register, Claim, and Errors
- Protected resource metadata (RFC 9728): https://christianpicks.com/.well-known/oauth-protected-resource
- Authorization server metadata (RFC 8414): https://christianpicks.com/.well-known/oauth-authorization-server
- `register_uri`: https://christianpicks.com/oauth/register
- Public catalog access is anonymous. Optional `catalog:read` tokens identify clients for rate limits.

## Agent discovery files

- [llms.txt](https://christianpicks.com/llms.txt)
- [AI catalog](https://christianpicks.com/.well-known/ai-catalog.json)
- [A2A agent card](https://christianpicks.com/.well-known/agent-card.json)
- [GitHub repository](https://github.com/praisondani/christianpicks) — includes AGENTS.md, plugin.json, and skills
- [Agent skill](https://christianpicks.com/.well-known/agent-skills/christianpicks-catalog/SKILL.md)

## Webhooks

ChristianPicks does not currently publish public outbound webhooks. Poll the catalog API or subscribe to RSS feeds instead:

- https://christianpicks.com/feed/products.xml
- https://christianpicks.com/feed/launches.xml
- https://christianpicks.com/feed.xml