{
  "name": "Git.Top Client Compatibility",
  "schema_version": "git-top.client-compatibility.v1",
  "last_reviewed_at": "2026-07-31",
  "core_endpoint": "https://git.top/mcp/core",
  "full_endpoint": "https://git.top/mcp",
  "support_policy": "A client is supported only after initialize, tool discovery, first call, multi-tool workflow, and error behavior all pass against production.",
  "server_contract": {
    "scope": "Generic MCP protocol contract validated locally and by production smoke; this is not a substitute for a real-client end-to-end run.",
    "initialize": "passed",
    "core_tool_discovery": "passed",
    "first_core_call": "passed",
    "invalid_input": "passed",
    "strict_source_rejection": "passed",
    "production_smoke": "passed",
    "validation_commands": [
      "pnpm mcp:validate",
      "pnpm test:focused",
      "pnpm eval:agent-tasks"
    ]
  },
  "full_profile_evidence": {
    "client": "Claude Code",
    "version": "2.1.220",
    "endpoint": "https://git.top/mcp",
    "verified_at": "2026-07-31",
    "discovered_tool_count": 21,
    "initialize": "passed",
    "trust_gate": "passed",
    "grp_query": "passed",
    "project_lookup": "passed",
    "not_found_recovery": "passed",
    "invalid_input_recovery": "passed",
    "turns": 6,
    "elapsed_seconds": 100.7,
    "cost_usd": 0.138,
    "cache_creation_tokens": 27165,
    "cache_read_tokens": 34572,
    "baseline_json_rpc_bytes": 101284,
    "baseline_embedded_json_characters": 90057,
    "limitation": "The compact rerun removed GRP result externalization and reduced tool latency, but its extra invalid-profile probe and independent model cache state make cross-run cost and cache-token comparisons non-causal.",
    "compact_profile_verification": "passed",
    "compact_profile_evidence": {
      "worker_version": "78773e20-b9f5-4e76-ad07-406264ee0f0b",
      "profile": "compact",
      "json_rpc_bytes": 31673,
      "embedded_json_characters": 28077,
      "nodes": 24,
      "edges": 40,
      "solution_paths": 3,
      "truncated": true,
      "source": "d1",
      "trust_decision": "allow",
      "result_externalized": false,
      "grp_tool_duration_ms": 854,
      "turns": 6,
      "elapsed_seconds": 53.615,
      "cost_usd": 0.29442495,
      "cache_creation_tokens": 60957,
      "cache_read_tokens": 99059,
      "not_found_error_code": -32005,
      "invalid_profile_error_code": -32602
    }
  },
  "clients": [
    {
      "client": "Codex CLI, app, and IDE",
      "version": "0.145.0",
      "transport": "Streamable HTTP",
      "endpoint_profile": "core",
      "configuration_command": "codex mcp add git-top --url https://git.top/mcp/core",
      "configuration_verified": "passed",
      "initialize": "passed",
      "tool_discovery": "passed",
      "first_call": "passed",
      "multi_tool_workflow": "passed",
      "error_behavior": "passed",
      "support_level": "supported",
      "last_verified": "2026-07-31",
      "known_limitation": "Codex CLI JSONL does not expose the initialize handshake as a separate item; successful MCP startup and five-tool discovery were observed. Non-interactive codex exec requires the per-server default_tools_approval_mode=approve setting for these allow-listed read-only core tools."
    },
    {
      "client": "Claude Code",
      "version": "2.1.220",
      "transport": "Streamable HTTP",
      "endpoint_profile": "core",
      "configuration_command": "claude mcp add --transport http --scope user git-top https://git.top/mcp/core",
      "configuration_verified": "passed",
      "initialize": "passed",
      "tool_discovery": "passed",
      "first_call": "passed",
      "multi_tool_workflow": "passed",
      "error_behavior": "passed",
      "support_level": "supported",
      "last_verified": "2026-07-31",
      "known_limitation": "Production D1 was healthy, so the exact -32003 outage path remains server-contract evidence; the real client handled -32005 not found and -32602 invalid input errors."
    }
  ],
  "verification_prompt": "Use Git.Top to recommend three open-source browser-agent projects for Docker, then cite the data source and one caveat for each.",
  "next_required_evidence": [
    "Run the verification prompt from the real client against the production core endpoint.",
    "Record initialize, tools/list, first useful call, a multi-tool decision, and invalid-input recovery.",
    "Promote support_level to supported only when every required client check passes."
  ]
}