---
title: Photo96 Documentation - Public API, MCP Servers & Agent Guides
description: Keyless public endpoints, OpenAPI 3.1 spec, Streamable HTTP MCP servers, WebMCP tools, and sandbox testing for Photo96.
canonical: https://photo96.com/docs
last-updated: 2026-11-22
---

# Photo96 Documentation

Photo96 turns one printed photo and one real video clip into a playable keepsake ($9.99 once, no viewer app or account). Every public documentation, search, validation, and MCP endpoint on this domain is **free, keyless, and requires no sign-up**.

> Paid photo creation and checkout always happen in the person's own browser at [photo96.com/#create](https://photo96.com/#create) through Polar. Private upload and checkout routes are not exposed as a public API.

## Quickstart (No API Key Required)

```bash
# 1. Check current pricing and file limits
curl -s https://photo96.com/v1/pricing

# 2. Validate photo & video specs in the stateless sandbox
curl -s -X POST https://photo96.com/v1/validate-media \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: demo-check-1" \
  -d '{"photo_format":"jpg","photo_size_mb":8,"video_format":"mp4","video_size_mb":42,"video_codec":"h264","sandbox":true}'

# 3. Search Photo96 guides using NLWeb v0.55
curl -s -X POST https://photo96.com/v1/ask \
  -H "Content-Type: application/json" \
  -d '{"query":{"text":"supported video formats and pricing"}}'
```

## Public REST & NLWeb Endpoints

- `GET /openapi.json` - Complete [OpenAPI 3.1 specification](https://photo96.com/openapi.json)
- `GET /.well-known/api-catalog` - RFC 9727 API catalog linkset
- `GET /v1/pricing` - One-time USD price, file formats, size limits, and demo URL
- `GET /v1/pages?limit=10&cursor=...` - Cursor-paginated catalog of Photo96 guides and Markdown URLs
- `GET /v1/occasions?category=wedding` - Filter occasion pages and gift guides
- `POST /v1/validate-media` - Stateless media compatibility check (accepts `Idempotency-Key`)
- `GET /ask` / `POST /ask` / `GET /v1/ask` / `POST /v1/ask` - NLWeb v0.55 search (JSON or SSE streaming via `prefer.streaming: true`)

## Streamable HTTP MCP Servers

Photo96 runs two public Streamable HTTP MCP servers (no authentication required):

- **Product MCP**: `https://photo96.com/mcp` ([server card](https://photo96.com/mcp/server-card)) - `get_pricing_and_limits`, `validate_media_specs`, `search_gift_ideas`, `get_order_recovery_guide`, and `preview_playable_photo` (includes an interactive `ui://photo96/keepsake-preview` MCP App view).
- **Docs MCP**: `https://photo96.com/docs/mcp` ([server card](https://photo96.com/docs/mcp/server-card)) - `search_docs`, `get_docs_page`, and `list_docs_pages`.

```json
{
  "mcpServers": {
    "photo96": {
      "type": "streamable-http",
      "url": "https://photo96.com/mcp"
    },
    "photo96-docs": {
      "type": "streamable-http",
      "url": "https://photo96.com/docs/mcp"
    }
  }
}
```

## Sandbox & Test Environment

All `/v1/*`, `/ask`, `/mcp`, and `/docs/mcp` endpoints run statelessly with **no credentials and zero production side effects**. Pass `"sandbox": true` to `POST /v1/validate-media` to test validation flows, and use our live public demo keepsake at [photo96.com/p/KpGcB7eH](https://photo96.com/p/KpGcB7eH) to test phone camera scanning without paying.

## Conventions

- **Versioning & Deprecation**: Public endpoints are URL-versioned (`/v1/...`) and return `X-API-Version: 2026-11-01`. Any breaking change is announced at least 90 days ahead with RFC 8594 `Deprecation` and `Sunset` headers.
- **Rate Limits**: Every `/v1/*` and `/ask` response includes `RateLimit`, `RateLimit-Limit`, `RateLimit-Remaining`, and `RateLimit-Reset` headers (plus `Retry-After` on `429`).
- **Idempotency**: Send an optional `Idempotency-Key` header on `POST /v1/validate-media`, `POST /v1/ask`, or `POST /ask` for safe retries.
- **Errors**: Invalid calls return structured JSON `{"error":{"code","message","hint","request_id"}}`.

## Discovery & Machine-Readable Files

- [Developer Portal](https://photo96.com/developers)
- [OpenAPI 3.1 spec](https://photo96.com/openapi.json)
- [ARD catalog](https://photo96.com/.well-known/ard.json) & [AI Catalog](https://photo96.com/.well-known/ai-catalog.json)
- [A2A agent card](https://photo96.com/.well-known/agent-card.json)
- [Agent Skills index](https://photo96.com/.well-known/agent-skills/index.json)
- [llms.txt](https://photo96.com/llms.txt) & [agents.md](https://photo96.com/agents.md)
