# Context Repo

> Save and version your AI context, then retrieve it from ChatGPT or connected
> MCP clients. Prompts, documents, and collections in one place.

## What it is

Context Repo is one place for your **prompts, documents, and collections**.
Use the dashboard, REST API, ChatGPT App, Chrome Extension, or compatible MCP
clients to work with that context.

## Three pillars

- **Prompt Library** — version-controlled prompt templates with
  `${variable}` placeholders stored verbatim for caller-managed use and
  non-destructive restore.
- **Document Hub** — The Context Repo ingestion and upload pipeline supports
  75+ file formats via LlamaIndex. MCP `create_document` accepts plain text or
  Markdown. Web scraping uses Firecrawl.
- **Smart Collections** — group prompts and documents into named
  folders; read collection members directly, or pass `collectionId`
  to `deep_search` or `reason` for document-only retrieval.

## Access points

| Channel | Notes |
|---|---|
| Web dashboard | Real-time Convex sync at `/dashboard` |
| MCP server | 29 MCP tools — 27 power tools + `search`/`fetch` for OpenAI Apps SDK Company Knowledge compatibility — Streamable HTTP at `/mcp` |
| Grok connector | Same 29 MCP tools through the auth-required `/grok-mcp` compatibility entrypoint |
| ChatGPT App | OAuth via Clerk |
| Chrome Extension | Visible-chat and selected-content writes, plus public-page capture through Firecrawl |
| REST API | 35 operations under `/v1/*` with Bearer JWT / API key |
| Ask the Docs | Conversational AI over the docs at `ask.contextrepo.com` |
| `context-repo-mcp` npm | Standalone CLI / programmatic |

## When to use Context Repo

Use Context Repo when an agent needs to retrieve a versioned prompt,
search across stored knowledge, persist a prompt or document for reuse,
sync context across Claude / Cursor / ChatGPT / Grok / VS Code /
Grok Bot / Factory / Amp, save conversations, decisions, and session
handoffs for reuse from other connected clients, save a public web page
by URL and refresh it later, share a prompt or document through a
read-only public link, or call `reason` for one best-effort cited
answer over stored document content. Reason is read-only and does not
search prompts.

**When not to use:** Context Repo searches your stored context, not the
open web, and it runs retrieval for you rather than acting as a raw vector
store. Accounts belong to one person today, with no org or team seats.
Several agents can share one account safely, each with its own scoped key;
revision checks and optional document leases coordinate their edits.

## Agent Discovery

Machine-readable surfaces (no auth required):

- `/llms.txt` — index file, llmstxt.org spec
- `/llms-full.txt` — full curated knowledge pack (≤ 1 MB)
- `/llms-ctx.txt` — extended context with inlined page content
- `/openapi.json` — OpenAPI 3.1 spec for all 35 REST operations
- `/api/openapi.yaml` — YAML mirror of the OpenAPI spec
- `/pricing.md` — plain-markdown pricing reference
- `/agent` — capability catalog (JSON or markdown via `Accept`)
- `/.well-known/mcp.json` — MCP discovery (SEP-1649)
- `/.well-known/agent.json` — OpenAI ai-plugin manifest
- `/.well-known/agent-card.json` — A2A Agent Card
- `/.well-known/mcp/server-card.json` — MCP server card (29 tools)
- `/.well-known/api-catalog` — RFC 9727 linkset
- `/.well-known/oauth-protected-resource/v1` — RFC 9728 (REST)
- `/.well-known/oauth-protected-resource/mcp` — RFC 9728 (MCP)
- `/.well-known/oauth-protected-resource/grok-mcp` — RFC 9728 (Grok MCP compatibility resource)
- `/.well-known/oauth-authorization-server` — RFC 8414

## Document-safe writes

MCP `update_document` and `restore_document_version` require
`expectedRevision` from `get_document` or the latest successful document
acknowledgement. Each invocation makes exactly one REST write with no preflight
GET. On `REVISION_MISMATCH`, read again. If the intended state is already
present, stop; otherwise reapply the change to the latest content and retry
with its revision. Documents using `lease_required` managed editing must use
the REST coordination workflow.

Raw REST clients can use `If-Match` or body `expectedRevision`,
`Idempotency-Key`, and the fenced-lease coordination endpoints and headers.
No-op writes do not create another revision. See `/agent/features/documents`
and `/openapi.json`.

## Pricing snapshot

7-day free trial on Pro and Pro Max. Pro $9.99/mo. Pro Max $19.99/mo (2× the Pro
allowances, plus web scraping). Ultimate $99.99/mo (10× the Pro allowances, plus
web scraping).
See `/pricing.md` or `/pricing` for details.

## Contact

- Support: `support@contextrepo.com`
- X: https://x.com/contextrepo
- GitHub: https://github.com/Gitmaxd/context-repo-mcp
- Docs: https://contextrepo.com/docs

Last verified: 2026-10-02