Annotate PDF | agent view

The same page content and links, with explicit tool capabilities. Tools marked with an API can run directly through HTTP. Other tools require the browser interface or are not connected yet.

Tool capabilities

{
  "id": "annotate-pdf",
  "category": "pdf-tools",
  "built": true,
  "requirements": "Text, drawing, highlights and output persistence; distinguish annotation from editing existing text.",
  "implementation": {
    "fields": [
      {
        "key": "page",
        "label": "Page",
        "value": 1,
        "type": "number"
      },
      {
        "key": "x",
        "label": "X from left (points)",
        "value": 40,
        "type": "number"
      },
      {
        "key": "y",
        "label": "Y from bottom (points)",
        "value": 40,
        "type": "number"
      },
      {
        "key": "size",
        "label": "Text size",
        "value": 12,
        "type": "number"
      }
    ],
    "files": true,
    "accept": ".pdf",
    "note": "Adds visible text to a page. Coordinates are PDF points; this is not secure redaction or a digital signature.",
    "experience": {
      "automatic": false,
      "single": false,
      "label": "Your text",
      "placeholder": "Type or paste your input…",
      "help": "Up to 1,000,000 characters. Review the settings before running.",
      "action": null
    },
    "mode": "explicit",
    "interactive": false
  },
  "execution": "POST /api/v1/tools/annotate-pdf/run",
  "api": {
    "id": "annotate-pdf",
    "name": "Annotate PDF",
    "category": "pdf-tools",
    "description": "Add visible text to a PDF page.",
    "notes": "Adds visible text to a page. Coordinates are PDF points; this is not secure redaction or a digital signature.",
    "human_path": "/en/pdf-tools/annotate-pdf/",
    "method": "POST",
    "endpoint": "/api/v1/tools/annotate-pdf/run",
    "schema_url": "/api/v1/tools/annotate-pdf",
    "input_schema": {
      "type": "object",
      "additionalProperties": false,
      "properties": {
        "input": {
          "type": "string",
          "maxLength": 1000000,
          "default": "",
          "description": "Plain text input. File tools use files instead unless otherwise documented."
        },
        "options": {
          "type": "object",
          "additionalProperties": false,
          "properties": {
            "page": {
              "type": "number",
              "description": "Page",
              "default": 1.0
            },
            "x": {
              "type": "number",
              "description": "X from left (points)",
              "default": 40.0
            },
            "y": {
              "type": "number",
              "description": "Y from bottom (points)",
              "default": 40.0
            },
            "size": {
              "type": "number",
              "description": "Text size",
              "default": 12.0
            }
          }
        },
        "files": {
          "type": "array",
          "maxItems": 1,
          "items": {
            "type": "object",
            "required": [
              "name",
              "base64"
            ],
            "additionalProperties": false,
            "properties": {
              "name": {
                "type": "string",
                "maxLength": 200,
                "description": "Filename only, no path."
              },
              "mime": {
                "type": "string",
                "maxLength": 150
              },
              "bytes": {
                "type": "integer",
                "minimum": 0,
                "description": "Optional decoded byte count; must match content if supplied."
              },
              "base64": {
                "type": "string",
                "contentEncoding": "base64",
                "description": "File bytes as padded base64. Use the tool-specific limits.files_bytes value for the total decoded input size."
              }
            }
          }
        }
      }
    },
    "output_schema": {
      "type": "object",
      "required": [
        "tool",
        "result"
      ],
      "properties": {
        "tool": {
          "type": "string"
        },
        "result": {
          "type": "object",
          "required": [
            "text",
            "files"
          ],
          "properties": {
            "text": {
              "type": [
                "string",
                "null"
              ]
            },
            "data": {
              "description": "Parsed JSON when the textual result is JSON."
            },
            "name": {
              "type": "string"
            },
            "mime": {
              "type": "string"
            },
            "files": {
              "type": "array",
              "items": {
                "type": "object",
                "required": [
                  "name",
                  "mime",
                  "bytes",
                  "base64"
                ],
                "properties": {
                  "name": {
                    "type": "string"
                  },
                  "mime": {
                    "type": "string"
                  },
                  "bytes": {
                    "type": "integer"
                  },
                  "base64": {
                    "type": "string",
                    "contentEncoding": "base64"
                  }
                }
              }
            }
          }
        }
      }
    },
    "processing": "Server; same transformation code as browser tools",
    "limits": {
      "request_bytes": 8388608,
      "input_characters": 1000000,
      "files_bytes": 5242880,
      "max_files": 1,
      "timeout_seconds": 12
    }
  },
  "agent_processing": "Server; same transformation code as browser tools",
  "browser_agent": {
    "supported": true,
    "name": "run_current_tool",
    "discovery": "WebMCP on the human page in a supporting browser",
    "verification": "See audit/API-AUDIT.md; availability is not verification"
  }
}