{
  "awp_version": "0.2",
  "domain": "contextrepo.com",
  "intent": "Context Repo is the AI Context Repo for agents. Agents use it to (a) retrieve a versioned prompt template, (b) search across stored prompts, documents, and collections, (c) sync context across Claude/Cursor/ChatGPT/Grok and other MCP-compatible clients, (d) progressively navigate large documents via hierarchical chunks, and (e) synthesize a best-effort cited answer over stored document content.",
  "protocols": {
    "mcp": {
      "version": "2025-06-18",
      "endpoint": "https://contextrepo.com/mcp",
      "transport": "streamable-http"
    }
  },
  "capabilities": {
    "streaming": true,
    "streaming_modes": ["chunked", "sse"],
    "pagination": "cursor",
    "idempotency": true,
    "optimistic_concurrency": "etag",
    "document_coordination": "lease_required",
    "document_lease_actions": ["acquire", "renew", "release"],
    "document_write_acknowledgement": "compact",
    "mcp_document_writes": "required_expected_revision"
  },
  "auth": {
    "required_for": [
      "get_user_info",
      "search_prompts",
      "read_prompt",
      "create_prompt",
      "update_prompt",
      "delete_prompt",
      "get_prompt_versions",
      "restore_prompt_version",
      "list_documents",
      "get_document",
      "create_document",
      "update_document",
      "delete_document",
      "get_document_versions",
      "restore_document_version",
      "list_collections",
      "get_collection",
      "create_collection",
      "update_collection",
      "delete_collection",
      "add_to_collection",
      "remove_from_collection",
      "find_items",
      "search",
      "fetch",
      "deep_search",
      "deep_read",
      "deep_expand",
      "reason"
    ],
    "optional_for": [],
    "type": "oauth_or_api_key",
    "oauth_metadata": "https://contextrepo.com/.well-known/oauth-protected-resource",
    "api_key_header": "Authorization: API-Key gm_..."
  },
  "actions": [
    {
      "id": "search",
      "description": "Semantic search across prompts, documents, and collections, returning citation-ready OpenAI Apps SDK Company Knowledge results. For literal search and filtering, use find_items.",
      "auth_required": true,
      "via": "mcp",
      "operation": "search"
    },
    {
      "id": "deep_search",
      "description": "Hierarchical chunk search across document content, optionally scoped to one document or collection.",
      "auth_required": true,
      "via": "mcp",
      "operation": "deep_search"
    },
    {
      "id": "fetch",
      "description": "Retrieve full prompt content, document content up to the REST response limit, or collection metadata plus up to 50 member items, by id. Use Deep Search for targeted retrieval from large documents.",
      "auth_required": true,
      "via": "mcp",
      "operation": "fetch"
    },
    {
      "id": "create_prompt",
      "description": "Create a new prompt template with variables.",
      "auth_required": true,
      "endpoint": "/v1/prompts",
      "method": "POST",
      "execution_model": "sync"
    },
    {
      "id": "update_prompt",
      "description": "Update a prompt; content, parameter, or variable edits create versions, while metadata-only edits patch in place.",
      "auth_required": true,
      "endpoint": "/v1/prompts/{promptId}",
      "method": "PATCH",
      "execution_model": "sync"
    },
    {
      "id": "create_document",
      "description": "Create a document; embeddings are generated automatically.",
      "auth_required": true,
      "endpoint": "/v1/documents",
      "method": "POST",
      "execution_model": "sync"
    },
    {
      "id": "update_document",
      "description": "MCP update_document requires expectedRevision and makes exactly one REST write with no preflight GET. On REVISION_MISMATCH, read again; if the intended state is already present, stop, otherwise reapply against the latest content. Documents using lease_required managed editing must use the REST coordination workflow.",
      "auth_required": true,
      "endpoint": "/v1/documents/{id}",
      "method": "PATCH",
      "execution_model": "sync"
    },
    {
      "id": "get_document_coordination",
      "description": "Inspect the document's standard or lease_required policy, caller-visible lease state, and current revision.",
      "auth_required": true,
      "endpoint": "/v1/documents/{id}/coordination",
      "method": "GET",
      "execution_model": "sync"
    },
    {
      "id": "enable_document_coordination",
      "description": "Enable lease_required document coordination using the exact current ETag in If-Match.",
      "auth_required": true,
      "endpoint": "/v1/documents/{id}/coordination",
      "method": "PUT",
      "execution_model": "sync"
    },
    {
      "id": "disable_document_coordination",
      "description": "Return a document to standard coordination using If-Match; an active lease blocks the transition.",
      "auth_required": true,
      "endpoint": "/v1/documents/{id}/coordination",
      "method": "DELETE",
      "execution_model": "sync"
    },
    {
      "id": "operate_document_lease",
      "description": "Acquire, renew, or release a fenced document lease. Idempotency-Key is required; renew and release also use X-ContextRepo-Lease-Id and X-ContextRepo-Lease-Fence.",
      "auth_required": true,
      "endpoint": "/v1/documents/{id}/coordination/lease",
      "method": "POST",
      "execution_model": "sync"
    },
    {
      "id": "reason",
      "description": "Ask a question over stored document content and get a best-effort synthesized answer with inline citations and non-exhaustive limitations. Disagreements appear as ordinary cited statements in the answer. Read-only; document content only.",
      "auth_required": true,
      "endpoint": "/v1/reason",
      "method": "POST",
      "execution_model": "sync"
    }
  ],
  "service_desc": [
    {
      "href": "https://contextrepo.com/openapi.json",
      "type": "application/json",
      "title": "OpenAPI 3.1 — 35 REST operations under /v1"
    },
    {
      "href": "https://contextrepo.com/.well-known/agent-card.json",
      "type": "application/json",
      "title": "A2A v0.2 Agent Card"
    },
    {
      "href": "https://contextrepo.com/.well-known/mcp/server-card.json",
      "type": "application/json",
      "title": "MCP server-card.json — 29 tools"
    },
    {
      "href": "https://contextrepo.com/llms-full.txt",
      "type": "text/plain",
      "title": "Full agent context pack"
    }
  ],
  "packages": {
    "npm": {
      "name": "context-repo-mcp",
      "url": "https://www.npmjs.com/package/context-repo-mcp",
      "install": "npx context-repo-mcp"
    },
    "github": "https://github.com/Gitmaxd/context-repo-mcp",
    "chrome_extension": "https://chromewebstore.google.com/detail/context-repo/hlmpbcbphnhecbcakbnlobgighfnlafi"
  },
  "agent_status": {
    "operational": true
  },
  "contact_email": "support@contextrepo.com",
  "legal_info_url": "https://contextrepo.com/policies"
}