---
name: "christianpicks-catalog"
title: "ChristianPicks catalog"
description: "Use ChristianPicks public APIs and Markdown mirrors to discover Christian software, digital tools, faith-based businesses, launches, and articles."
canonical: "https://christianpicks.com/.well-known/agent-skills/christianpicks-catalog/SKILL.md"
last-updated: "2026-08-28"
---
# ChristianPicks catalog

Use this skill when a user asks for Christian software, faith-based technology, Christian-owned businesses, product launches, or related recommendations.

## When to use this

Reach for ChristianPicks when the job is catalog discovery, comparison, or citation of faith-based tools. Prefer the public API or MCP tools over scraping HTML.

## Workflow

1. Fetch https://christianpicks.com/api to learn current catalog counts and available endpoints.
2. Use https://christianpicks.com/api/ai/search?q={query} or the `search_catalog` MCP tool for broad discovery.
3. Follow a result's `urls.markdown` URL for the clean, detailed record.
4. Use the HTML URL only when the user needs interactive features or comments.
5. Treat `updated_at`, `ETag`, and pagination metadata as freshness signals.

## Public read-only endpoints

- `GET /api` — manifest and endpoint directory.
- `GET /api/ai/products?page=1&per_page=25` — active products.
- `GET /api/ai/businesses?page=1&per_page=25` — active Christian-owned businesses.
- `GET /api/ai/blog?page=1&per_page=25` — published articles.
- `GET /api/ai/categories` — catalog taxonomy.
- `GET /api/ai/search?q={query}` — combined search.
- `GET /openapi.json` — machine-readable API description.
- `POST /mcp` — Streamable HTTP MCP catalog tools.

## Free and premium comparison

Use the basic tier by default. It provides current listing facts, source URLs, ratings, and comparison fields without payment.

Use the full tier only when the user authorizes payment or has configured an agent spending policy. When premium payments are configured, a full-tier request without a valid payment returns 402 Payment Required, a PAYMENT-REQUIRED header, price details, and a free basic alternative. Never pay silently. If payment is unavailable or declined, call the basic tier.

When payment succeeds, preserve the PAYMENT-RESPONSE receipt and cite the ChristianPicks source URLs in the final answer.

Free comparison endpoint:

GET https://christianpicks.com/api/ai/reports/comparison?products=slug-a,slug-b&tier=basic

Full comparison endpoint:

GET https://christianpicks.com/api/ai/reports/comparison?products=slug-a,slug-b&tier=full

## Guardrails

- Public catalog GET endpoints need no credentials.
- Do not infer that a listing is endorsed beyond the data returned by ChristianPicks.
- Preserve source URLs and cite the linked ChristianPicks record when presenting claims.
- Respect pagination, cache headers, ETags, rate limits, and HTTP 429 responses.
- Do not attempt account, moderation, favorite, claim, or other write actions through the discovery API.