Jawz API

openapi: 3.1.0
info:
  title: Jawz API
  version: '2026-11-12'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-11-12: 6 operation(s) read from 3 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; Jawz has published no machine-readable contract that the pipeline
    could find. Engine: local.'
  x-evidence-tiers:
    code-example: 2
    documentation: 4
    pages-with-code: 3
    pages-read: 3
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-11-12'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://jawz.ai/whitepaper
  - https://jawz.ai/docs/mcp
  - https://jawz.ai/docs/from-code
paths:
  /api/mcp:
    get:
      operationId: get_api_mcp
      tags:
      - Api
      summary: GET /api/mcp
      x-source: https://jawz.ai/whitepaper
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl , a headless agent, or a connected AI can call the market and macro reads, run any Loop chapter, and fetch the World Brief\
          \ with no API key, no account, no token, and no browser — anonymously. Anonymous readers are counted through daily-rotating hashes (never\
          \ identified, never stored as users) and rate-limited; the tools that spend third-party data quota carry a tighter ceiling. \n Authorizatio"
    post:
      operationId: post_api_mcp
      tags:
      - Api
      summary: POST /api/mcp
      x-source: https://jawz.ai/docs/from-code
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiMcpRequest'
      responses:
        '201':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiMcpResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl Twelve weeks is the default lookback; this asks for four, weekly: curl -s https://jawz.ai/api/mcp  -H 'Content-Type: application/json'\
          \  -H 'Accept: application/json, text/event-stream'  -d '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/call\",\n \"params\":{\"name\"\
          :\"get_regime_history\",\n \"arguments\":{\"lookback_weeks\":4,\"interval\":\"weekly\"}}}'  | grep '^data: ' | sed 's/^data: //'  |\
          \ jq '.result.structur"
  /api/read:
    get:
      operationId: get_api_read
      tags:
      - Api
      summary: GET /api/read?as_of=YYYY-MM-DD and the get_dashboard tool with as_of return the dashboard as Jawz would have read it on that day.
      description: Returns the dashboard or market read for a given date.
      x-source: https://jawz.ai/docs/mcp
      parameters:
      - name: as_of
        in: query
        required: false
        schema:
          type: string
        description: Date in YYYY‑MM‑DD format to retrieve a dated read (defaults to today).
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /oauth/callback:
    post:
      operationId: post_oauth_callback
      tags:
      - Oauth
      summary: Authorize.
      description: Completes the authorization step and returns a redirect URL with an authorization code.
      x-source: https://jawz.ai/docs/mcp
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostOauthCallbackRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostOauthCallbackResponse'
      x-evidence:
        kind: documentation
  /oauth/register:
    post:
      operationId: post_oauth_register
      tags:
      - Oauth
      summary: Register a client.
      description: Registers a new OAuth client; returns client_id.
      x-source: https://jawz.ai/docs/mcp
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostOauthRegisterRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostOauthRegisterResponse'
      x-evidence:
        kind: documentation
  /oauth/token:
    post:
      operationId: post_oauth_token
      tags:
      - Oauth
      summary: Exchange.
      description: Exchanges an authorization code for an access token and refresh token.
      x-source: https://jawz.ai/docs/mcp
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostOauthTokenRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostOauthTokenResponse'
      x-evidence:
        kind: documentation
components:
  schemas:
    PostApiMcpRequest:
      type: object
      properties:
        jsonrpc:
          type: string
        id:
          type: integer
        method:
          type: string
        params:
          type: object
          properties:
            name:
              type: string
            arguments:
              type: object
              properties:
                lookback_weeks:
                  type: integer
                interval:
                  type: string
    PostApiMcpResponse:
      type: object
      properties:
        as_of:
          type: string
          format: date
        regime:
          type: string
        cycle:
          type: string
        provenance:
          type: string
    PostOauthCallbackRequest:
      type: object
      properties:
        email:
          type: string
          description: User email used as identity.
        client_id:
          type: string
          description: Client identifier obtained from registration.
        redirect_uri:
          type: string
          description: Redirect URI matching one registered.
        state:
          type: string
          description: Opaque value to maintain state between request and callback.
        code_challenge:
          type: string
          description: PKCE code challenge (S256).
        code_challenge_method:
          type: string
          description: Method used for PKCE challenge, must be "S256".
        response_type:
          type: string
          description: Response type, typically "code".
      required:
      - email
      - client_id
      - redirect_uri
      - code_challenge
      - code_challenge_method
      - response_type
    PostOauthCallbackResponse:
      type: object
      properties:
        redirect:
          type: string
          description: URL containing the authorization code as a query parameter.
    PostOauthRegisterRequest:
      type: object
      properties:
        redirect_uris:
          type: array
          description: Array of redirect URIs, e.g. ["http://localhost/cb"].
        client_name:
          type: string
          description: Human‑readable name for the client.
      required:
      - redirect_uris
      - client_name
    PostOauthRegisterResponse:
      type: object
      properties:
        client_id:
          type: string
          description: Identifier for the newly registered client.
    PostOauthTokenRequest:
      type: object
      properties:
        grant_type:
          type: string
          description: Must be "authorization_code".
        code:
          type: string
          description: Authorization code received from the callback.
        redirect_uri:
          type: string
          description: Redirect URI used in the authorization request.
        client_id:
          type: string
          description: Client identifier.
        code_verifier:
          type: string
          description: PKCE code verifier matching the earlier challenge.
      required:
      - grant_type
      - code
      - redirect_uri
      - client_id
      - code_verifier
    PostOauthTokenResponse:
      type: object
      properties:
        access_token:
          type: string
          description: Bearer token for authenticated calls.
        refresh_token:
          type: string
          description: Token to obtain new access tokens.
        expires_in:
          type: integer
          description: Lifetime of the access token in seconds.
tags:
- name: Api
- name: Oauth