{
  "openapi": "3.1.0",
  "info": {
    "title": "Scout Mesh public catalog API",
    "version": "1.0.0",
    "summary": "Unauthenticated catalog of the Scout Mesh sourcing MCP gateway.",
    "description": "Scout Mesh connects Claude, ChatGPT, and other MCP clients to people-data sources through one gateway. This public REST API exposes product metadata and the live source catalog without authentication. Candidate search and enrichment run through the MCP server at https://mcp.getscoutmesh.com/mcp (personal URLs carry an API key in the path; clients without a key receive an OAuth challenge).",
    "contact": {
      "name": "Scout Mesh",
      "url": "https://getscoutmesh.com/developers",
      "email": "contact@reppls.com"
    }
  },
  "servers": [{ "url": "https://getscoutmesh.com" }],
  "paths": {
    "/api/v1": {
      "get": {
        "operationId": "getApiIndex",
        "summary": "API index",
        "description": "Entry point listing available resources, documentation, the OpenAPI URL, and the MCP server URL.",
        "responses": {
          "200": {
            "description": "Catalog index",
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/ApiIndex" }
              }
            }
          }
        }
      }
    },
    "/api/v1/sources": {
      "get": {
        "operationId": "listSources",
        "summary": "List live sources",
        "description": "All live people-data sources on the gateway with pricing and documentation URLs.",
        "responses": {
          "200": {
            "description": "Source list",
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/SourceList" }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "ApiIndex": {
        "type": "object",
        "required": ["name", "description", "resources"],
        "properties": {
          "authentication": {
            "type": "object",
            "properties": {
              "mcp": { "type": "string" },
              "rest": { "type": "string" }
            }
          },
          "description": { "type": "string" },
          "documentation_url": { "type": "string", "format": "uri" },
          "mcp_url": { "type": "string", "format": "uri" },
          "name": { "type": "string" },
          "openapi_url": { "type": "string", "format": "uri" },
          "resources": {
            "type": "object",
            "properties": {
              "sources": { "type": "string", "format": "uri" }
            }
          }
        }
      },
      "Source": {
        "type": "object",
        "required": ["slug", "label", "status"],
        "properties": {
          "blurb": { "type": "string" },
          "documentation_url": { "type": "string", "format": "uri" },
          "label": { "type": "string" },
          "pricing": { "type": "string" },
          "slug": { "type": "string" },
          "status": { "type": "string", "enum": ["live"] }
        }
      },
      "SourceList": {
        "type": "object",
        "required": ["count", "sources"],
        "properties": {
          "count": { "type": "integer" },
          "sources": {
            "type": "array",
            "items": { "$ref": "#/components/schemas/Source" }
          }
        }
      }
    }
  }
}
