{
  "openapi": "3.0.3",
  "info": {
    "title": "Verging Labs Index API",
    "version": "1.1.0",
    "description": "Free memory and search measurements. For hosted MCP tools use /.well-known/mcp.json. To request a memory assessment, visit /memory-check; requests are reviewed by the team. The current index URLs are the stable v1 API contract. The response version identifies the benchmark release, not the API format. New optional fields, providers and metric keys may appear; clients must tolerate them and must not treat unreported or missing measurements as zero. Breaking field removals, type changes or meaning changes require a separately versioned endpoint, published alongside the existing endpoints. Any retirement will be announced in /changelog and on affected responses with Deprecation and Sunset headers before removal. No endpoint is currently deprecated and no retirement date is scheduled."
  },
  "components": {
    "schemas": {
      "MemoryProvider": {
        "type": "object",
        "properties": {
          "rank": {
            "type": "integer",
            "nullable": true
          },
          "rankSpread": {
            "type": "object",
            "properties": {
              "low": {
                "type": "number",
                "nullable": true
              },
              "high": {
                "type": "number",
                "nullable": true
              }
            },
            "required": [
              "low",
              "high"
            ],
            "additionalProperties": true
          },
          "providerId": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "serviceId": {
            "type": "string"
          },
          "indexScore": {
            "type": "number",
            "nullable": true,
            "description": "Published score on a 0–100 scale. Compare only within the documented setup."
          },
          "ci": {
            "type": "object",
            "properties": {
              "low": {
                "type": "number",
                "nullable": true
              },
              "high": {
                "type": "number",
                "nullable": true
              }
            },
            "required": [
              "low",
              "high"
            ],
            "additionalProperties": true
          },
          "perKindPass": {
            "type": "object",
            "additionalProperties": {
              "type": "object",
              "properties": {
                "pass": {
                  "type": "integer",
                  "nullable": true
                },
                "total": {
                  "type": "integer",
                  "nullable": true
                },
                "rate": {
                  "type": "number",
                  "nullable": true
                }
              },
              "required": [
                "pass",
                "total",
                "rate"
              ],
              "additionalProperties": true
            }
          },
          "criteria": {
            "type": "object",
            "additionalProperties": {
              "type": "number",
              "nullable": true
            },
            "nullable": true
          },
          "costPer1kSuccessfulUsd": {
            "type": "number",
            "nullable": true
          },
          "latencyMs": {
            "type": "object",
            "properties": {
              "p50": {
                "type": "number",
                "nullable": true
              },
              "p95": {
                "type": "number",
                "nullable": true
              }
            },
            "required": [
              "p50",
              "p95"
            ],
            "additionalProperties": true
          },
          "searchesPerTask": {
            "type": "number",
            "nullable": true
          },
          "reducedSample": {
            "type": "boolean"
          },
          "page": {
            "type": "string",
            "format": "uri"
          },
          "costComponentsPer1kUsd": {
            "type": "object",
            "properties": {
              "agentTokens": {
                "type": "number",
                "nullable": true
              },
              "subscription": {
                "type": "number",
                "nullable": true
              },
              "embeddings": {
                "type": "number",
                "nullable": true
              }
            },
            "required": [
              "agentTokens",
              "subscription",
              "embeddings"
            ],
            "additionalProperties": true
          },
          "subscriptionBasis": {
            "type": "string"
          },
          "embeddingsBasis": {
            "type": "string"
          },
          "perKindCostPer1kUsd": {
            "type": "object",
            "additionalProperties": {
              "type": "object",
              "properties": {
                "usd": {
                  "type": "number",
                  "nullable": true
                },
                "ciLow": {
                  "type": "number",
                  "nullable": true
                },
                "ciHigh": {
                  "type": "number",
                  "nullable": true
                },
                "nSeq": {
                  "type": "integer",
                  "nullable": true
                }
              },
              "required": [],
              "additionalProperties": true
            }
          },
          "pricing": {
            "type": "object",
            "properties": {
              "freeTier": {
                "type": "string"
              },
              "startingAtUsdMo": {
                "oneOf": [
                  {
                    "type": "number",
                    "nullable": true
                  },
                  {
                    "type": "string"
                  }
                ],
                "description": "Numeric monthly price or published pricing label when no single price applies."
              },
              "openSource": {
                "type": "string"
              }
            },
            "required": [],
            "additionalProperties": true
          },
          "timeToReadyMs": {
            "type": "number",
            "nullable": true
          },
          "speedMs": {
            "type": "object",
            "properties": {
              "ttr": {
                "type": "number",
                "nullable": true
              },
              "storeP50": {
                "type": "number",
                "nullable": true
              },
              "recallP50": {
                "type": "number",
                "nullable": true
              },
              "storeSessionS": {
                "type": "number",
                "nullable": true
              },
              "answerSegments": {
                "type": "object",
                "additionalProperties": {
                  "type": "number",
                  "nullable": true
                }
              },
              "roundTripMs": {
                "type": "number",
                "nullable": true
              },
              "answerLatencyMs": {
                "type": "number",
                "nullable": true
              },
              "onboardMin": {
                "type": "number",
                "nullable": true
              },
              "onboardOutcome": {
                "type": "string"
              }
            },
            "required": [],
            "additionalProperties": true
          },
          "decay": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "cp": {
                  "type": "integer",
                  "nullable": true
                },
                "session": {
                  "type": "integer",
                  "nullable": true
                },
                "pass": {
                  "type": "integer",
                  "nullable": true
                },
                "n": {
                  "type": "integer",
                  "nullable": true
                },
                "rate": {
                  "type": "number",
                  "nullable": true
                }
              },
              "required": [],
              "additionalProperties": true
            }
          },
          "lookupsPerSession": {
            "type": "number",
            "nullable": true
          }
        },
        "required": [
          "rank",
          "rankSpread",
          "providerId",
          "name",
          "serviceId",
          "indexScore",
          "ci",
          "perKindPass",
          "criteria",
          "costPer1kSuccessfulUsd",
          "latencyMs",
          "searchesPerTask",
          "reducedSample",
          "page",
          "costComponentsPer1kUsd",
          "timeToReadyMs"
        ],
        "additionalProperties": true
      },
      "SearchProvider": {
        "type": "object",
        "properties": {
          "rank": {
            "type": "integer",
            "nullable": true
          },
          "rankSpread": {
            "type": "object",
            "properties": {
              "low": {
                "type": "number",
                "nullable": true
              },
              "high": {
                "type": "number",
                "nullable": true
              }
            },
            "required": [
              "low",
              "high"
            ],
            "additionalProperties": true
          },
          "providerId": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "serviceId": {
            "type": "string"
          },
          "indexScore": {
            "type": "number",
            "nullable": true,
            "description": "Published score on a 0–100 scale. Compare only within the documented setup."
          },
          "ci": {
            "type": "object",
            "properties": {
              "low": {
                "type": "number",
                "nullable": true
              },
              "high": {
                "type": "number",
                "nullable": true
              }
            },
            "required": [
              "low",
              "high"
            ],
            "additionalProperties": true
          },
          "perKindPass": {
            "type": "object",
            "additionalProperties": {
              "type": "object",
              "properties": {
                "pass": {
                  "type": "integer",
                  "nullable": true
                },
                "total": {
                  "type": "integer",
                  "nullable": true
                },
                "rate": {
                  "type": "number",
                  "nullable": true
                }
              },
              "required": [
                "pass",
                "total",
                "rate"
              ],
              "additionalProperties": true
            }
          },
          "criteria": {
            "type": "object",
            "additionalProperties": {
              "type": "number",
              "nullable": true
            },
            "nullable": true
          },
          "costPer1kSuccessfulUsd": {
            "type": "number",
            "nullable": true
          },
          "latencyMs": {
            "type": "object",
            "properties": {
              "p50": {
                "type": "number",
                "nullable": true
              },
              "p95": {
                "type": "number",
                "nullable": true
              }
            },
            "required": [
              "p50",
              "p95"
            ],
            "additionalProperties": true
          },
          "searchesPerTask": {
            "type": "number",
            "nullable": true
          },
          "reducedSample": {
            "type": "boolean"
          },
          "page": {
            "type": "string",
            "format": "uri"
          }
        },
        "required": [
          "rank",
          "rankSpread",
          "providerId",
          "name",
          "serviceId",
          "indexScore",
          "ci",
          "perKindPass",
          "criteria",
          "costPer1kSuccessfulUsd",
          "latencyMs",
          "searchesPerTask",
          "reducedSample",
          "page"
        ],
        "additionalProperties": true
      },
      "MemoryIndex": {
        "type": "object",
        "properties": {
          "index": {
            "type": "string"
          },
          "publisher": {
            "type": "string"
          },
          "version": {
            "type": "string",
            "description": "Benchmark release identifier, not the API schema version."
          },
          "released": {
            "type": "string",
            "format": "date"
          },
          "sample": {
            "type": "boolean"
          },
          "note": {
            "type": "string"
          },
          "basis": {
            "type": "string"
          },
          "methodology": {
            "type": "string",
            "format": "uri"
          },
          "changelog": {
            "type": "string",
            "format": "uri"
          },
          "agentAccess": {
            "type": "string",
            "format": "uri"
          },
          "baselines": {
            "type": "object",
            "additionalProperties": {
              "type": "object",
              "properties": {
                "label": {
                  "type": "string"
                },
                "short_label": {
                  "type": "string"
                },
                "index_score": {
                  "type": "number",
                  "nullable": true
                },
                "note": {
                  "type": "string"
                },
                "cost_per_1k_successful_usd_total": {
                  "type": "number",
                  "nullable": true
                },
                "cost_note": {
                  "type": "string"
                },
                "latency_ms": {
                  "type": "number",
                  "nullable": true
                },
                "answer_latency_ms": {
                  "type": "number",
                  "nullable": true
                },
                "store_session_s": {
                  "type": "number",
                  "nullable": true
                },
                "answer_segments": {
                  "type": "object",
                  "additionalProperties": {
                    "type": "number",
                    "nullable": true
                  }
                },
                "per_kind_pass": {
                  "type": "object",
                  "additionalProperties": {
                    "type": "string"
                  }
                },
                "failure_attribution": {
                  "type": "object",
                  "additionalProperties": {
                    "type": "integer",
                    "nullable": true
                  }
                },
                "decay": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "cp": {
                        "type": "integer",
                        "nullable": true
                      },
                      "session": {
                        "type": "integer",
                        "nullable": true
                      },
                      "pass": {
                        "type": "integer",
                        "nullable": true
                      },
                      "n": {
                        "type": "integer",
                        "nullable": true
                      }
                    },
                    "required": [],
                    "additionalProperties": true
                  }
                },
                "pricing": {
                  "type": "object",
                  "properties": {
                    "free_tier": {
                      "type": "string"
                    },
                    "starting_at_usd_mo": {
                      "type": "number",
                      "nullable": true
                    },
                    "open_source": {
                      "type": "string"
                    }
                  },
                  "required": [],
                  "additionalProperties": true
                }
              },
              "required": [],
              "additionalProperties": true
            }
          },
          "providers": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/MemoryProvider"
            }
          }
        },
        "required": [
          "index",
          "publisher",
          "version",
          "released",
          "sample",
          "methodology",
          "changelog",
          "agentAccess",
          "baselines",
          "providers"
        ],
        "additionalProperties": true
      },
      "SearchIndex": {
        "type": "object",
        "properties": {
          "index": {
            "type": "string"
          },
          "publisher": {
            "type": "string"
          },
          "version": {
            "type": "string",
            "description": "Benchmark release identifier, not the API schema version."
          },
          "released": {
            "type": "string",
            "format": "date"
          },
          "sample": {
            "type": "boolean"
          },
          "note": {
            "type": "string"
          },
          "basis": {
            "type": "string"
          },
          "methodology": {
            "type": "string",
            "format": "uri"
          },
          "changelog": {
            "type": "string",
            "format": "uri"
          },
          "agentAccess": {
            "type": "string",
            "format": "uri"
          },
          "baselines": {
            "type": "object",
            "additionalProperties": {
              "type": "object",
              "properties": {
                "label": {
                  "type": "string"
                },
                "short_label": {
                  "type": "string"
                },
                "index_score": {
                  "type": "number",
                  "nullable": true
                },
                "note": {
                  "type": "string"
                },
                "cost_per_1k_successful_usd_total": {
                  "type": "number",
                  "nullable": true
                },
                "cost_note": {
                  "type": "string"
                },
                "latency_ms": {
                  "type": "number",
                  "nullable": true
                },
                "answer_latency_ms": {
                  "type": "number",
                  "nullable": true
                },
                "store_session_s": {
                  "type": "number",
                  "nullable": true
                },
                "answer_segments": {
                  "type": "object",
                  "additionalProperties": {
                    "type": "number",
                    "nullable": true
                  }
                },
                "per_kind_pass": {
                  "type": "object",
                  "additionalProperties": {
                    "type": "string"
                  }
                },
                "failure_attribution": {
                  "type": "object",
                  "additionalProperties": {
                    "type": "integer",
                    "nullable": true
                  }
                },
                "decay": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "cp": {
                        "type": "integer",
                        "nullable": true
                      },
                      "session": {
                        "type": "integer",
                        "nullable": true
                      },
                      "pass": {
                        "type": "integer",
                        "nullable": true
                      },
                      "n": {
                        "type": "integer",
                        "nullable": true
                      }
                    },
                    "required": [],
                    "additionalProperties": true
                  }
                },
                "pricing": {
                  "type": "object",
                  "properties": {
                    "free_tier": {
                      "type": "string"
                    },
                    "starting_at_usd_mo": {
                      "type": "number",
                      "nullable": true
                    },
                    "open_source": {
                      "type": "string"
                    }
                  },
                  "required": [],
                  "additionalProperties": true
                }
              },
              "required": [],
              "additionalProperties": true
            }
          },
          "providers": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/SearchProvider"
            }
          }
        },
        "required": [
          "index",
          "publisher",
          "version",
          "released",
          "sample",
          "methodology",
          "changelog",
          "agentAccess",
          "baselines",
          "providers"
        ],
        "additionalProperties": true
      },
      "IndexUnavailable": {
        "type": "object",
        "properties": {
          "error": {
            "type": "string",
            "enum": [
              "NOT_YET_LIVE"
            ]
          },
          "index": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "methodology": {
            "type": "string",
            "format": "uri"
          },
          "docs": {
            "type": "string",
            "format": "uri"
          }
        },
        "required": [
          "error",
          "index",
          "message",
          "methodology",
          "docs"
        ],
        "additionalProperties": true
      }
    }
  },
  "x-api-version": "v1",
  "servers": [
    {
      "url": "https://web-dev-production-5dfd.up.railway.app"
    }
  ],
  "security": [],
  "paths": {
    "/index/memory.json": {
      "get": {
        "operationId": "fetchMemoryIndex",
        "summary": "Read the published Agentic Memory Index",
        "description": "Free published measurements. Cite the release and methodology; compare only within the tested setup. Missing data is not a score of zero.",
        "security": [],
        "responses": {
          "200": {
            "description": "Published index release",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MemoryIndex"
                }
              }
            }
          },
          "503": {
            "description": "No published release is available. Do not invent a score or retry in a tight loop.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/IndexUnavailable"
                }
              }
            }
          }
        }
      }
    },
    "/index/search.json": {
      "get": {
        "operationId": "fetchSearchIndex",
        "summary": "Read the published Agentic Search Index",
        "description": "Free published measurements. Cite the release and methodology; compare only within the tested setup. Missing data is not a score of zero.",
        "security": [],
        "responses": {
          "200": {
            "description": "Published index release",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SearchIndex"
                }
              }
            }
          },
          "503": {
            "description": "No published release is available. Do not invent a score or retry in a tight loop.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/IndexUnavailable"
                }
              }
            }
          }
        }
      }
    }
  },
  "externalDocs": {
    "description": "Using the measurements",
    "url": "https://web-dev-production-5dfd.up.railway.app/agent-access"
  }
}