{
  "openapi": "3.1.0",
  "info": {
    "title": "Systemores Ecosystem & Venture Studio API",
    "version": "1.0.0",
    "summary": "Public ecosystem discovery, platform routing, and operational health API for Systemores LLC, linking REST v1 endpoints and stateless Streamable HTTP MCP 2026 servers.",
    "description": "Programmatic REST API v1 for discovering Systemores behavioral platforms, venture co-design systems, and remote Model Context Protocol (MCP 2026) endpoints.\n\n### Versioning & Deprecation Policy\nMajor breaking changes increment the URL version prefix (`/api/v2`) and echo `X-API-Version`. Prior to retiring any versioned endpoint, Systemores provides at least a 180-day notice window using RFC 9745 `Deprecation` and RFC 8594 `Sunset` headers.\n\n### Rate Limits & Typed Problem Errors\nEvery response includes RFC `RateLimit`, `RateLimit-Limit`, `RateLimit-Remaining`, `RateLimit-Reset`, and `RateLimit-Policy` headers. All `4xx` and `5xx` errors return an RFC 9457 `application/problem+json` envelope containing machine-readable `code`, `message`, `detail`, and actionable `resolution` fields.",
    "contact": {
      "name": "Systemores LLC",
      "email": "support@systemores.com",
      "url": "https://systemores.com/support"
    },
    "license": {
      "name": "Proprietary — Public Read-Only Access",
      "url": "https://systemores.com/terms"
    }
  },
  "x-deprecation-policy": {
    "url": "https://systemores.com/developers#deprecation",
    "minimum_sunset_days": 180,
    "deprecation_header": "Deprecation",
    "sunset_header": "Sunset"
  },
  "x-mcp-server": {
    "discovery": "https://systemores.com/.well-known/mcp.json",
    "server_card": "https://systemores.com/.well-known/mcp/server-card.json",
    "remotes": [
      {
        "name": "systemores-profiler",
        "transport": "streamable-http",
        "url": "https://profile.systemores.com/api/mcp"
      },
      {
        "name": "systemores-agent-auditor",
        "transport": "streamable-http",
        "url": "https://audit.systemores.com/api/mcp"
      }
    ]
  },
  "servers": [
    {
      "url": "https://systemores.com",
      "description": "Production Root & REST API v1"
    }
  ],
  "tags": [
    {
      "name": "Discovery",
      "description": "API root index and operational service health checks."
    },
    {
      "name": "Platforms",
      "description": "Query and inspect Systemores behavioral platforms, ventures, and MCP endpoints."
    }
  ],
  "paths": {
    "/api/v1": {
      "get": {
        "tags": ["Discovery"],
        "operationId": "getSystemoresApiIndex",
        "summary": "Get Systemores REST API v1 discovery index",
        "description": "Retrieve the Systemores Ecosystem & Venture Studio REST API v1 discovery index, canonical documentation links, and remote Streamable HTTP MCP server endpoints.",
        "responses": {
          "200": {
            "description": "API v1 service discovery document.",
            "headers": {
              "X-API-Version": { "$ref": "#/components/headers/X-API-Version" },
              "RateLimit-Limit": { "$ref": "#/components/headers/RateLimit-Limit" },
              "RateLimit-Remaining": { "$ref": "#/components/headers/RateLimit-Remaining" },
              "RateLimit-Reset": { "$ref": "#/components/headers/RateLimit-Reset" },
              "RateLimit-Policy": { "$ref": "#/components/headers/RateLimit-Policy" }
            },
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/ApiDiscoveryIndex" }
              }
            }
          },
          "400": { "$ref": "#/components/responses/BadRequest" },
          "404": { "$ref": "#/components/responses/NotFound" },
          "429": { "$ref": "#/components/responses/RateLimited" },
          "500": { "$ref": "#/components/responses/InternalError" }
        }
      }
    },
    "/api/health": {
      "get": {
        "tags": ["Discovery"],
        "operationId": "getSystemoresApiHealth",
        "summary": "Check Systemores API operational health",
        "description": "Verify real-time operational availability, service version, and UTC server timestamp for the Systemores Ecosystem & Venture Studio API.",
        "responses": {
          "200": {
            "description": "API operational health status.",
            "headers": {
              "X-API-Version": { "$ref": "#/components/headers/X-API-Version" },
              "RateLimit-Limit": { "$ref": "#/components/headers/RateLimit-Limit" },
              "RateLimit-Remaining": { "$ref": "#/components/headers/RateLimit-Remaining" },
              "RateLimit-Reset": { "$ref": "#/components/headers/RateLimit-Reset" },
              "RateLimit-Policy": { "$ref": "#/components/headers/RateLimit-Policy" }
            },
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/HealthStatus" }
              }
            }
          },
          "400": { "$ref": "#/components/responses/BadRequest" },
          "404": { "$ref": "#/components/responses/NotFound" },
          "429": { "$ref": "#/components/responses/RateLimited" },
          "500": { "$ref": "#/components/responses/InternalError" }
        }
      }
    },
    "/api/v1/platforms": {
      "get": {
        "tags": ["Platforms"],
        "operationId": "listSystemoresPlatforms",
        "summary": "List Systemores platforms and MCP capabilities",
        "description": "Return the structured directory of Systemores behavioral platforms and co-designed ventures, optionally filtered by operating pillar, MCP support, and result limit.",
        "parameters": [
          {
            "name": "pillar",
            "in": "query",
            "required": false,
            "description": "Filter platforms by strategic operating pillar.",
            "schema": {
              "type": "string",
              "enum": ["enterprise", "operational", "consumer"]
            }
          },
          {
            "name": "mcp_only",
            "in": "query",
            "required": false,
            "description": "When true, return only platforms that expose a live Streamable HTTP MCP server endpoint.",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of platform records to return (between 1 and 50).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 50
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Filtered list of Systemores platforms.",
            "headers": {
              "X-API-Version": { "$ref": "#/components/headers/X-API-Version" },
              "RateLimit-Limit": { "$ref": "#/components/headers/RateLimit-Limit" },
              "RateLimit-Remaining": { "$ref": "#/components/headers/RateLimit-Remaining" },
              "RateLimit-Reset": { "$ref": "#/components/headers/RateLimit-Reset" },
              "RateLimit-Policy": { "$ref": "#/components/headers/RateLimit-Policy" }
            },
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/PlatformListResponse" }
              }
            }
          },
          "400": { "$ref": "#/components/responses/BadRequest" },
          "404": { "$ref": "#/components/responses/NotFound" },
          "429": { "$ref": "#/components/responses/RateLimited" },
          "500": { "$ref": "#/components/responses/InternalError" }
        }
      }
    },
    "/api/v1/platforms/{slug}": {
      "get": {
        "tags": ["Platforms"],
        "operationId": "getSystemoresPlatformBySlug",
        "summary": "Get a single Systemores platform by slug",
        "description": "Retrieve full metadata, canonical URL, MCP endpoint, documentation link, and agent routing guidance for a single Systemores platform identified by slug.",
        "parameters": [
          {
            "name": "slug",
            "in": "path",
            "required": true,
            "description": "Canonical platform slug (for example: behavior-profiler, agent-auditor, scan-signals, ethos-suite).",
            "schema": {
              "type": "string",
              "pattern": "^[a-zA-Z0-9_-]+$"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Platform metadata record.",
            "headers": {
              "X-API-Version": { "$ref": "#/components/headers/X-API-Version" },
              "RateLimit-Limit": { "$ref": "#/components/headers/RateLimit-Limit" },
              "RateLimit-Remaining": { "$ref": "#/components/headers/RateLimit-Remaining" },
              "RateLimit-Reset": { "$ref": "#/components/headers/RateLimit-Reset" },
              "RateLimit-Policy": { "$ref": "#/components/headers/RateLimit-Policy" }
            },
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/PlatformDetailResponse" }
              }
            }
          },
          "400": { "$ref": "#/components/responses/BadRequest" },
          "404": { "$ref": "#/components/responses/NotFound" },
          "429": { "$ref": "#/components/responses/RateLimited" },
          "500": { "$ref": "#/components/responses/InternalError" }
        }
      }
    }
  },
  "components": {
    "headers": {
      "X-API-Version": {
        "description": "Semantic API version.",
        "schema": { "type": "string" }
      },
      "RateLimit-Limit": {
        "description": "Maximum requests permitted per rate-limit window.",
        "schema": { "type": "integer" }
      },
      "RateLimit-Remaining": {
        "description": "Remaining requests available in the current window.",
        "schema": { "type": "integer" }
      },
      "RateLimit-Reset": {
        "description": "Seconds until the current rate-limit window resets.",
        "schema": { "type": "integer" }
      },
      "RateLimit-Policy": {
        "description": "Structured RFC RateLimit policy descriptor.",
        "schema": { "type": "string" }
      }
    },
    "responses": {
      "BadRequest": {
        "description": "Invalid query parameter or malformed request.",
        "content": {
          "application/problem+json": {
            "schema": { "$ref": "#/components/schemas/ProblemDetails" }
          }
        }
      },
      "NotFound": {
        "description": "Requested API endpoint or platform slug was not found.",
        "content": {
          "application/problem+json": {
            "schema": { "$ref": "#/components/schemas/ProblemDetails" }
          }
        }
      },
      "RateLimited": {
        "description": "Rate limit exceeded; honor Retry-After before retrying.",
        "content": {
          "application/problem+json": {
            "schema": { "$ref": "#/components/schemas/ProblemDetails" }
          }
        }
      },
      "InternalError": {
        "description": "Unexpected server error.",
        "content": {
          "application/problem+json": {
            "schema": { "$ref": "#/components/schemas/ProblemDetails" }
          }
        }
      }
    },
    "schemas": {
      "ApiDiscoveryIndex": {
        "type": "object",
        "required": ["service", "version", "status", "openapi_url", "docs_url", "endpoints", "remote_mcp_servers"],
        "properties": {
          "service": { "type": "string" },
          "version": { "type": "string" },
          "status": { "type": "string" },
          "openapi_url": { "type": "string", "format": "uri" },
          "api_catalog_url": { "type": "string", "format": "uri" },
          "mcp_manifest_url": { "type": "string", "format": "uri" },
          "docs_url": { "type": "string", "format": "uri" },
          "deprecation_policy_url": { "type": "string", "format": "uri" },
          "endpoints": {
            "type": "object",
            "additionalProperties": { "type": "string", "format": "uri" }
          },
          "remote_mcp_servers": {
            "type": "array",
            "items": {
              "type": "object",
              "required": ["name", "url", "docs_url"],
              "properties": {
                "name": { "type": "string" },
                "url": { "type": "string", "format": "uri" },
                "docs_url": { "type": "string", "format": "uri" }
              }
            }
          }
        }
      },
      "HealthStatus": {
        "type": "object",
        "required": ["status", "service", "version", "timestamp"],
        "properties": {
          "status": { "type": "string", "enum": ["ok"] },
          "service": { "type": "string" },
          "version": { "type": "string" },
          "timestamp": { "type": "string", "format": "date-time" }
        }
      },
      "Platform": {
        "type": "object",
        "required": ["slug", "name", "pillar", "status", "url", "mcp_endpoint", "docs_url", "when_to_use"],
        "properties": {
          "slug": { "type": "string" },
          "name": { "type": "string" },
          "pillar": { "type": "string", "enum": ["enterprise", "operational", "consumer"] },
          "status": { "type": "string", "enum": ["active", "beta", "in_development"] },
          "url": { "type": "string", "format": "uri" },
          "mcp_endpoint": { "type": ["string", "null"], "format": "uri" },
          "docs_url": { "type": "string", "format": "uri" },
          "when_to_use": { "type": "string" }
        }
      },
      "PlatformListResponse": {
        "type": "object",
        "required": ["version", "total", "count", "platforms"],
        "properties": {
          "version": { "type": "string" },
          "total": { "type": "integer" },
          "count": { "type": "integer" },
          "platforms": {
            "type": "array",
            "items": { "$ref": "#/components/schemas/Platform" }
          }
        }
      },
      "PlatformDetailResponse": {
        "type": "object",
        "required": ["version", "platform"],
        "properties": {
          "version": { "type": "string" },
          "platform": { "$ref": "#/components/schemas/Platform" }
        }
      },
      "ProblemDetails": {
        "type": "object",
        "required": ["type", "title", "status", "detail", "code", "message", "resolution", "docs_url", "openapi_url", "error"],
        "properties": {
          "type": { "type": "string", "format": "uri" },
          "title": { "type": "string" },
          "status": { "type": "integer" },
          "detail": { "type": "string" },
          "code": { "type": "string" },
          "message": { "type": "string" },
          "resolution": { "type": "string" },
          "docs_url": { "type": "string", "format": "uri" },
          "openapi_url": { "type": "string", "format": "uri" },
          "error": {
            "type": "object",
            "required": ["code", "message", "status", "resolution"],
            "properties": {
              "code": { "type": "string" },
              "message": { "type": "string" },
              "status": { "type": "integer" },
              "resolution": { "type": "string" }
            }
          }
        }
      }
    }
  }
}
