{
  "openapi": "3.1.0",
  "info": {
    "title": "Utah Universal Model, Harness & MCP API",
    "version": "2026.11.12.265",
    "description": "Server-side access across OpenAI Chat & Responses, Anthropic Claude Messages, Google Gemini v1beta, and 15-tool Streamable HTTP MCP. Named keys are scoped to model and workspace tools; never automatically retry an uncertain billable request."
  },
  "servers": [
    {
      "url": "https://aithatsee.com/utah/v1",
      "description": "OpenAI Chat, OpenAI/Codex Responses & Anthropic Claude Messages"
    },
    {
      "url": "https://aithatsee.com/utah/v1beta",
      "description": "Google Gemini v1beta generateContent & streamGenerateContent"
    },
    {
      "url": "https://aithatsee.com/utah",
      "description": "Streamable HTTP MCP (/mcp) & SDK downloads"
    }
  ],
  "security": [
    {
      "utahBearer": []
    },
    {
      "anthropicApiKey": []
    },
    {
      "geminiApiKey": []
    }
  ],
  "components": {
    "securitySchemes": {
      "utahBearer": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "Utah API key"
      },
      "anthropicApiKey": {
        "type": "apiKey",
        "in": "header",
        "name": "x-api-key"
      },
      "geminiApiKey": {
        "type": "apiKey",
        "in": "header",
        "name": "x-goog-api-key"
      }
    }
  },
  "paths": {
    "/models": {
      "get": {
        "operationId": "listUtahModels",
        "summary": "List available Utah models without starting inference",
        "responses": {
          "200": {
            "description": "OpenAI-compatible model list"
          },
          "401": {
            "description": "Invalid or revoked key"
          }
        }
      }
    },
    "/harnesses": {
      "get": {
        "operationId": "getUtahHarnessManifest",
        "summary": "Public discovery manifest for Claude, GPT/Codex, Gemini, IDEs, SDKs and MCP",
        "security": [],
        "responses": {
          "200": {
            "description": "Harness, IDE and SDK capability manifest"
          }
        }
      }
    },
    "/chat/completions": {
      "post": {
        "operationId": "createUtahChatCompletion",
        "summary": "Create an OpenAI-compatible chat completion (JSON or SSE)",
        "responses": {
          "200": {
            "description": "Chat completion JSON or SSE stream"
          },
          "401": {
            "description": "Invalid key"
          },
          "402": {
            "description": "Insufficient usage"
          },
          "429": {
            "description": "Rate limited"
          }
        }
      }
    },
    "/responses": {
      "post": {
        "operationId": "createUtahResponse",
        "summary": "Create an OpenAI / Codex Responses API completion with Online Thinking reasoning summary items (JSON or SSE)",
        "responses": {
          "200": {
            "description": "Responses API object or SSE events"
          },
          "401": {
            "description": "Invalid key"
          },
          "402": {
            "description": "Insufficient usage"
          },
          "429": {
            "description": "Rate limited"
          }
        }
      }
    },
    "/messages": {
      "post": {
        "operationId": "createUtahClaudeMessage",
        "summary": "Create an Anthropic / Claude Messages API completion with Online Thinking blocks (JSON or SSE)",
        "responses": {
          "200": {
            "description": "Claude message JSON or SSE events"
          },
          "401": {
            "description": "Invalid key"
          },
          "402": {
            "description": "Insufficient usage"
          },
          "429": {
            "description": "Rate limited"
          }
        }
      }
    },
    "/messages/count_tokens": {
      "post": {
        "operationId": "countUtahClaudeTokens",
        "summary": "Verify API key and estimate input token count without starting inference",
        "responses": {
          "200": {
            "description": "Estimated input_tokens"
          },
          "401": {
            "description": "Invalid key"
          }
        }
      }
    },
    "/models/{model}:generateContent": {
      "post": {
        "operationId": "createUtahGeminiContent",
        "summary": "Create a Google Gemini v1beta generateContent response with optional thought parts",
        "parameters": [
          {
            "name": "model",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "default": "utah"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Gemini GenerateContentResponse JSON"
          },
          "400": {
            "description": "Malformed request or forbidden query-string API key"
          },
          "401": {
            "description": "Invalid key"
          }
        }
      }
    },
    "/models/{model}:streamGenerateContent": {
      "post": {
        "operationId": "streamUtahGeminiContent",
        "summary": "Stream a Google Gemini v1beta response (?alt=sse or JSON array)",
        "parameters": [
          {
            "name": "model",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "default": "utah"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Gemini SSE stream or JSON chunk array"
          }
        }
      }
    },
    "/mcp": {
      "post": {
        "operationId": "invokeUtahMcp",
        "summary": "Streamable HTTP JSON-RPC 2.0 MCP endpoint exposing 15 model, browser, workspace, REA, skills, templates and security tools",
        "responses": {
          "200": {
            "description": "JSON-RPC 2.0 response"
          }
        }
      }
    }
  }
}
