Jabbertoon Report Problem API

openapi: 3.2.0
info:
  title: Jabbertoon tools for AI assistants and developers Report…
  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: Report Problem
paths:
  /api/report_problem:
    post:
      operationId: report_problem
      summary: Tell Jabbertoon something is wrong
      description: 'Tells the people who make Jabbertoon something is wrong: a wrong answer, a check that refused a good cartoon or passed a bad one, a move that looks wrong, a link that does not open, wrong docs, something missing, or a step that was hard to get right (kind hard_step, with hard_because: optional, never needed to go on). Unlike the other tools, it keeps what you send: the report (kind, tool, code, where, item, note, hard_because) is saved for a person to read. Never put the cartoon, a name, an address or anything about the person you help in it. Example: {"kind": "validator_wrong", "tool": "validate", "code": "op_unknown", "note": "say was refused in a cartoon"}.'
      security: []
      responses:
        '200':
          description: What report_problem 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 about Jabbertoon's tools for AI assistants.
                  status:
                    type: string
                    description: received
                  report_id:
                    type: string
                  says:
                    type: string
                  removed:
                    type: array
                    items:
                      type: string
                    description: What was taken out of the report before it was saved (an email address, for example).
                  engine:
                    $ref: '#/components/schemas/Engine'
                  notes:
                    type: array
                    items:
                      type: string
                  error:
                    $ref: '#/components/schemas/Problem'
        4XX:
          $ref: '#/components/responses/Problem'
        5XX:
          $ref: '#/components/responses/Problem'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - kind
              properties:
                kind:
                  type: string
                  enum:
                  - wrong_answer
                  - validator_wrong
                  - move_looks_wrong
                  - link_does_not_open
                  - docs_wrong
                  - missing
                  - hard_step
                  - other
                  description: 'What kind of problem it is (hard_step: a step that was hard to get right).'
                tool:
                  type: string
                  maxLength: 64
                  description: The tool whose answer was wrong, e.g. validate.
                code:
                  type: string
                  maxLength: 64
                  description: The error code it gave, e.g. op_unknown.
                where:
                  type: string
                  maxLength: 200
                  description: Where it pointed, e.g. scripts[0].body[2].
                item:
                  type: string
                  maxLength: 200
                  description: 'What it is about: a move, character or look (c4c:beh:bow, dog, crayon), or a page.'
                note:
                  type: string
                  maxLength: 500
                  description: What was wrong, in a sentence or two. No cartoon, names or personal details.
                hard_because:
                  type: string
                  maxLength: 500
                  description: 'For kind hard_step: what made the step hard (an error''s words, a field that was unclear, a size that was hard to guess). Optional. No cartoon, names or personal details.'
                cli_version:
                  type: string
                  maxLength: 40
                  description: Set by the jabbertoon tool.
                os:
                  type: string
                  maxLength: 40
                  description: 'Set by the jabbertoon tool: win32, darwin or linux.'
              additionalProperties: false
            example:
              kind: wrong_answer
              tool: list_moves
              note: The description of a move does not match what it does.
      tags:
      - Report Problem
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.
    Engine:
      type: object
      properties:
        version:
          type: string
          description: The block language's version.
        git:
          type: string
          description: The git tree id of the engine that answered (the same on every door).
  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