Jabbertoon Read Blueprint API

openapi: 3.2.0
info:
  title: Jabbertoon tools for AI assistants and developers Read…
  version: '1'
  summary: Read Jabbertoon's guide, moves, characters and looks, check a cartoon, a move or a character you write, and make a jabbertoon.com link that opens a move or a character, or the cartoon in the studio.
  description: 'The same tools as Jabbertoon''s MCP server (https://jabbertoon.com/mcp), over plain HTTP. No key and no account. GET answers the read tools whose arguments are plain values; POST a JSON object of arguments to any tool. Nothing sent to validate or share_link is stored or logged; report_problem keeps its report for a person to read. Errors are {code, where, says, fix, url}, with did_you_mean and an RFC 6902 patch when the fix is certain. Making the video is done on your own computer, by the jabbertoon tool (preview, render_video). The block language: https://jabbertoon.com/docs/language/'
  contact:
    name: Jabbertoon
    email: hello@jabbertoon.com
    url: https://jabbertoon.com/for-ai/
  license:
    name: Proprietary, 1211 Holding LLC
    url: https://jabbertoon.com/license/
servers:
- url: https://jabbertoon.com
security: []
tags:
- name: Read Blueprint
paths:
  /api/read_blueprint:
    post:
      operationId: read_blueprint
      summary: 'Read a floor plan''s picture: its walls measured'
      description: 'Reads a floor plan''s picture (https) for build: its walls found, numbered, on a grid, and an id. Call again with the id and known (one length on the plan): every wall as a wall step''s from, to and thick. Then build with blueprint {id}. get_guide {"topic": "blueprint"}.'
      security: []
      responses:
        '200':
          description: What read_blueprint answers. ok is false when what you sent has problems; they are listed with where, says and fix.
          content:
            application/json:
              schema:
                type: object
                required:
                - ok
                - url
                properties:
                  ok:
                    type: boolean
                  url:
                    type: string
                    description: The page that explains it, or a refusal.
                  id:
                    type: string
                    description: 'The sheet''s id: give it again with known, and to build as blueprint.id.'
                  size:
                    type: array
                    items:
                      type: integer
                    description: The sheet's width and height in pixels.
                  scale:
                    type:
                    - object
                    - 'null'
                    description: 'Once a length is known: units_per_pixel, metres_per_pixel, known.'
                  walls:
                    type: array
                    items:
                      type: object
                    description: 'Each wall found: n (its number on the picture), px [x0, z0, x1, z1] and thick_px; with a scale also from, to, thick (builder units) and length_m.'
                  gaps:
                    type: array
                    items:
                      type: object
                    description: 'Each line of walls drawn in pieces with doors, windows or ways between them: replaces (the walls'' numbers), px, openings; with a scale also wall {from, to, thick}, to build once for those, and each opening''s kind, at, wide.'
                  picture:
                    type: string
                    description: 'On the REST door: the picture (a JPEG, base64). Over MCP it is an image item.'
                  notes:
                    type: array
                    items:
                      type: string
                  error:
                    $ref: '#/components/schemas/Problem'
                  errors:
                    type: array
                    items:
                      $ref: '#/components/schemas/Problem'
        4XX:
          $ref: '#/components/responses/Problem'
        5XX:
          $ref: '#/components/responses/Problem'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                url:
                  type: string
                  maxLength: 2000
                  description: The https link of the picture itself.
                id:
                  type: string
                  pattern: ^[0-9a-f]{16}$
                  description: An earlier answer's id.
                known:
                  type: object
                  properties:
                    walls:
                      type: array
                      items:
                        type: integer
                    from:
                      type: array
                      items:
                        type: number
                    to:
                      type: array
                      items:
                        type: number
                    length:
                      type:
                      - string
                      - number
                  required:
                  - length
                  description: 'One length the plan states: walls [n, m] either side of a room and its written size, or from and to [x, z] off the grid.'
              minProperties: 1
              additionalProperties: false
            example:
              url: https://commons.wikimedia.org/wiki/Special:FilePath/2_bhk_Bungalow_floor_plan.jpg
      tags:
      - Read Blueprint
components:
  schemas:
    Problem:
      type: object
      required:
      - code
      - where
      - says
      - fix
      properties:
        code:
          type: string
        where:
          type:
          - string
          - 'null'
        says:
          type: string
        fix:
          type:
          - string
          - 'null'
        url:
          type: string
          description: The code's entry on https://jabbertoon.com/docs/errors/.
        did_you_mean:
          type: array
          items:
            type: string
        patch:
          type: array
          items:
            type: object
          description: RFC 6902 operations on what you sent that make the fix, given only when the fix is certain.
  responses:
    Problem:
      description: 'A request the server cannot use (400 bad_arguments, 404 not_found, 405, 413 too_large, 415, 503 busy or timeout: try again after Retry-After).'
      content:
        application/json:
          schema:
            type: object
            required:
            - ok
            - url
            - error
            properties:
              ok:
                const: false
              url:
                type: string
              error:
                $ref: '#/components/schemas/Problem'
externalDocs:
  description: 'Developers: quickstart in curl, Python and JavaScript'
  url: https://jabbertoon.com/developers/
x-mcp:
  url: https://jabbertoon.com/mcp
  transport: streamable-http