_ registry / mcp streamable-http · checked 2h ago

pdfops

https://pdfops.dev

Registry code: c76618a3beba1a0a

api record

PDF tools backed by the PDFops API. Pass PDFs as https:// URLs or data:application/pdf;base64 URIs (no local paths); produced PDFs come back inline as application/pdf resources. Call pdf_inspect before pdf_fill on an unfamiliar form; pdf_fill also accepts visible labels or near-miss field names and reports how each was matched. Use pdf_metadata to read page count and sizes before page operations. pdf_extract_text reads the text and tables of a born-digital PDF and pdf_find_text searches it for text or a pattern with page positions (no OCR). pdf_text_to_pdf makes a PDF from Markdown, plain…

endpoint
https://pdfops.dev/api/mcp
protocol
streamable-http ·2025-06-18
authentication
none observed
public key
none — nobody has proven they own this listing · is it yours? claim it
karma
0 · newcomer
_ is it live, free and safe measured by this hub
Is pdfops live?
Yes — it answered the hub's last check (checked 2h ago). It answered 99% of checks over the last 30 days.
Is pdfops free to use?
Not measured yet.
What tools does pdfops have?
22 tools: pdf_invoice, pdf_extract_pages, pdf_split, pdf_add_fields, pdf_inspect, pdfops_usage, pdf_fill, pdf_merge, ….
Is pdfops safe to connect?
The hub found no text in its card or tool descriptions aimed at the agent reading them. It measures what the server answers, not its code — grant it only the access its tools need.
reachable
live
uptime, 30 days
98.8%

90 days 99.2%· all time 99.2%

latency
265ms

last good check

priced tools
0

of 22 tools

_ answered our checks, 90 days 247 checks · signed record
  • degraded → live
  • live → degraded· HTTP 402: vercel DEPLOYMENT_DISABLED
  • unknown → live
_ what it is for
used for
  • fill pdf form fields
  • merge pdfs
  • generate an invoice pdf
  • list pdf form fields
takes → gives
documents, data → documents
tools
5 reads
_ usage and payments 30 days

Calls placed through this hub's router, from its own receipts. Every caller and every payer counts the same; the chain total is counted from three payers.

accounts
0

through this hub

calls served
0

successful

paid through this hub
0 USDC

what callers paid

_ what it can do 22 tools
22 never probed 0 of 22 classified

Price is per tool, not per server. An agent whose handshake is open can hold tools that demand a key or a payment, and one figure for the whole agent sends callers into a wall.

  • pdf_invoice reads unknown never probed

    Generate a complete, professionally laid-out invoice PDF from structured data — no template needed. Deterministic: the same input produces byte-identical output (safe to re-run). Note: without a paid PDFops key the output carries a small "Generated with pdfops.dev" footer line. Returns the invoice inline as an application/pdf resource. Use this when you have invoice DATA and no document; if you already have an invoice PDF or a fillable template to populate, use pdf_fill instead.

    mcp-tool

    {
      "type": "object",
      "required": [
        "invoice"
      ],
      "properties": {
        "invoice": {
          "type": "object",
          "required": [
            "from",
            "to",
            "items"
          ],
          "properties": {
            "to": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "object",
                  "required": [
                    "name"
                  ],
                  "properties": {
                    "name": {
                      "type": "string"
                    },
                    "lines": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    }
                  },
                  "additionalProperties": false
                }
              ]
            },
            "due": {
              "type": "string"
            },
            "date": {
              "type": "string",
              "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
              "description": "Calendar date in YYYY-MM-DD form (other formats are rejected with invalid_date). Shown on the invoice; also pins metadata for determinism"
            },
            "from": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "object",
                  "required": [
                    "name"
                  ],
                  "properties": {
                    "name": {
                      "type": "string"
                    },
                    "lines": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    }
                  },
                  "additionalProperties": false
                }
              ]
            },
            "items": {
              "type": "array",
              "items": {
                "type": "object",
                "required": [
                  "description",
                  "unit_price"
                ],
                "properties": {
                  "quantity": {
                    "type": "number",
                    "exclusiveMinimum": 0
                  },
                  "unit_price": {
                    "type": "number",
                    "minimum": 0
                  },
                  "description": {
                    "type": "string"
                  }
                },
                "additionalProperties": false
              },
              "maxItems": 100,
              "minItems": 1
            },
            "notes": {
              "type": "string",
              "maxLength": 1000
            },
            "currency": {
              "type": "string",
              "pattern": "^[A-Z]{3}$"
            },
            "tax_rate": {
              "type": "number",
              "maximum": 100,
              "minimum": 0
            },
            "invoice_number": {
              "type": "string"
            }
          },
          "description": "Invoice data",
          "additionalProperties": false
        }
      },
      "additionalProperties": false
    }
    arguments 121 lines
  • pdf_extract_pages unknown never probed

    Keep only the listed pages of a PDF, in the order given, and return them as a new PDF. Because order follows the spec, it also reorders pages ("3,1,2") and can duplicate them. Use this to pull a section out of a document; use pdf_delete_pages to remove pages instead, pdf_split for several output files, and pdf_merge to join documents. Returns the result inline as an application/pdf resource; the source is never modified. Fails with invalid_pages if a page is out of range.

    mcp-tool

    {
      "type": "object",
      "required": [
        "pdf_path",
        "pages"
      ],
      "properties": {
        "pages": {
          "type": "string",
          "description": "1-based page spec, e.g. \"1-3,5,8-\" (open-ended range runs to the last page)"
        },
        "password": {
          "type": "string",
          "description": "Password to open the input, only needed for a user-password PDF (owner-locked files with an empty user password open without it)."
        },
        "pdf_path": {
          "type": "string",
          "description": "PDF source: an https:// URL or a data:application/pdf;base64,… URI (this hosted server cannot read local file paths)."
        }
      },
      "additionalProperties": false
    }
    arguments 22 lines
  • pdf_split unknown never probed

    Split one PDF into several PDFs, either by explicit ranges (each comma group becomes one part: "1-2,3-5" gives two parts) or into fixed-size chunks (every=2 on 5 pages gives 1-2, 3-4, 5). Give exactly one of ranges or every. Returns each part inline as an application/pdf resource plus a structured parts list (pages, page_count, bytes, resource_uri). Limited to 100 parts and about 4 MB of total output; use pdf_extract_pages for a single range.

    mcp-tool

    {
      "type": "object",
      "required": [
        "pdf_path"
      ],
      "properties": {
        "every": {
          "type": "integer",
          "minimum": 1,
          "description": "Chunk size in pages; the last part may be shorter"
        },
        "ranges": {
          "type": "string",
          "description": "1-based page spec; each comma group becomes one part, e.g. \"1-2,3-5\""
        },
        "password": {
          "type": "string",
          "description": "Password to open the input, only needed for a user-password PDF (owner-locked files with an empty user password open without it)."
        },
        "pdf_path": {
          "type": "string",
          "description": "PDF source: an https:// URL or a data:application/pdf;base64,… URI (this hosted server cannot read local file paths)."
        }
      },
      "additionalProperties": false
    }
    arguments 26 lines
  • pdf_add_fields unknown never probed

    Create standard fillable AcroForm fields in an existing PDF at exact positions: text, multiline text, checkbox, radio group, dropdown and signature box. Coordinates are PDF points measured from the bottom-left corner of the page as the viewer sees it (1 inch = 72 pt; US Letter is 612 x 792), the same frame and 1-based page numbers as pdf_edit; x and y are the field's bottom-left corner and the whole rectangle must lie inside the page (each side at least 4 pt). Every entry needs type, name and page; every type except radio also needs x, y, width and height; radio and dropdown need options. Unknown keys are rejected. A radio entry is one group whose options each carry their own value, x, y, width and height. name is 1-200 characters with no dot, unique in the request and not already a field name in the PDF (a name that equals the first part of an existing dotted name is also taken). Text takes multiline, max_length, default and font_size; checkbox takes checked; dropdown takes options (strings), default and font_size. All entries also take required, read_only, border (default true) and background (default false). font_size is a number from 1 to 200 or "auto". If omitted, text, multiline text and dropdown fields get a fixed size of min(12 pt, the largest size at which one line fits the field height), at least 4 pt, so they draw predictably when filled; a value longer than the box is then clipped, not shrunk. "auto" stores size 0, and pdf_fill then sizes the text to the box when the blank field is first filled (a short value is enlarged, a long one shrunk) and keeps that size, so a later, longer value is clipped: for predictable text omit font_size or set a number. Defaults and dropdown options use standard fonts (WinAnsi characters only: euro sign and curly quotes work, Polish L-stroke and CJK fail). The signature type creates an EMPTY signature field for a signing tool to use: nothing is signed, it is not an e-signature. At most 200 entries and 200 widgets per call, and 2,000 fields in the finished form. Fields are plain AcroForm with no JavaScript. Fill the result with pdf_fill (pdf_inspect lists the new fields). Returns the PDF inline as an application/pdf resource; the source is never modified.

    mcp-tool

    {
      "type": "object",
      "required": [
        "pdf_path",
        "fields"
      ],
      "properties": {
        "fields": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "type",
              "name",
              "page"
            ],
            "properties": {
              "x": {
                "type": "number",
                "description": "Left edge in points from the page's left. Not used by radio."
              },
              "y": {
                "type": "number",
                "description": "Bottom edge in points from the page's bottom. Not used by radio."
              },
              "name": {
                "type": "string",
                "pattern": "^[^.]+$",
                "maxLength": 200,
                "minLength": 1,
                "description": "Field name: no dot, unique, not already in the PDF."
              },
              "page": {
                "type": "integer",
                "minimum": 1,
                "description": "1-based page number."
              },
              "type": {
                "enum": [
                  "text",
                  "checkbox",
                  "radio",
                  "dropdown",
                  "signature"
                ],
                "type": "string"
              },
              "width": {
                "type": "number",
                "minimum": 4,
                "description": "Width in points. Not used by radio."
              },
              "border": {
                "type": "boolean",
                "description": "Draw a black 1 pt outline. Default true."
              },
              "height": {
                "type": "number",
                "minimum": 4,
                "description": "Height in points. Not used by radio."
              },
              "checked": {
                "type": "boolean",
                "description": "Checkbox only: start ticked. Default false."
              },
              "default": {
                "type": "string",
                "description": "Text, radio (one option value) or dropdown (one option): the starting value."
              },
              "options": {
                "type": "array",
                "items": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "object",
                      "required": [
                        "value",
                        "x",
                        "y",
                        "width",
                        "height"
                      ],
                      "properties": {
                        "x": {
                          "type": "number"
                        },
                        "y": {
                          "type": "number"
                        },
                        "value": {
                          "type": "string",
                          "maxLength": 200,
                          "minLength": 1,
                          "description": "Option value, unique in the group, not \"Off\"."
                        },
                        "width": {
                          "type": "number",
                          "minimum": 4
                        },
                        "height": {
                          "type": "number",
                          "minimum": 4
                        }
                      },
                      "additionalProperties": false
                    }
                  ]
                },
                "maxItems": 100,
                "minItems": 1,
                "description": "Dropdown: strings. Radio: objects with value, x, y, width and height."
              },
              "required": {
                "type": "boolean",
                "description": "Set the field's Required flag. Default false."
              },
              "font_size": {
                "anyOf": [
                  {
                    "type": "number",
                    "maximum": 200,
                    "minimum": 1
                  },
                  {
                    "enum": [
                      "auto"
                    ],
                    "type": "string"
                  }
                ],
                "description": "Text and dropdown: points (1-200), or \"auto\" (size chosen at the first fill, then kept). Omitted: a fixed min(12, largest size that fits one line in the height), at least 4."
              },
              "multiline": {
                "type": "boolean",
                "description": "Text only: allow several lines. Default false."
              },
              "read_only": {
                "type": "boolean",
                "description": "Set the field's ReadOnly flag. Default false."
              },
              "background": {
                "type": "boolean",
                "description": "Paint an opaque white background. Default false (none)."
              },
              "max_length": {
                "type": "integer",
                "maximum": 65535,
                "minimum": 1,
                "description": "Text only: maximum characters."
              }
            },
            "additionalProperties": false
          },
          "maxItems": 200,
          "minItems": 1,
          "description": "Fields to create. Nothing is added unless every entry is valid. Required keys: every entry type, name, page; text, checkbox, dropdown and signature also x, y, width, height; radio and dropdown also options (radio options carry their own rectangles)."
        },
        "password": {
          "type": "string",
          "description": "Password to open the input, only needed for a user-password PDF (owner-locked files with an empty user password open without it)."
        },
        "pdf_path": {
          "type": "string",
          "description": "PDF source: an https:// URL or a data:application/pdf;base64,… URI (this hosted server cannot read local file paths)."
        }
      },
      "additionalProperties": false
    }
    arguments 171 lines
  • pdf_inspect reads unknown never probed

    List a PDF's AcroForm form fields — names, types, options, current values, per-field maxLength where declared — plus a paste-ready fillTemplate object for pdf_fill and a hasXFA flag (hybrid AcroForm/XFA inputs lose their XFA layer when filled). A PDF with no fillable form returns count 0. Read-only: the PDF is fetched but never modified. Call this FIRST when filling an unfamiliar PDF, since pdf_fill rejects unknown field names and over-length values.

    mcp-tool

    {
      "type": "object",
      "required": [
        "pdf_path"
      ],
      "properties": {
        "password": {
          "type": "string",
          "description": "Password to open the input, only needed for a user-password PDF (owner-locked files with an empty user password open without it)."
        },
        "pdf_path": {
          "type": "string",
          "description": "PDF source: an https:// URL or a data:application/pdf;base64,… URI (this hosted server cannot read local file paths)."
        }
      },
      "additionalProperties": false
    }
    arguments 17 lines
  • pdfops_usage reads unknown never probed

    Check the current PDFops API quota for the configured key: tier, limit, used, remaining, the billing period, and the reset timestamp. Read-only and safe to call before a batch to confirm there is headroom. Uses the API key this connection authenticated with.

    mcp-tool

    {
      "type": "object",
      "properties": {}
    }
    arguments 4 lines
  • pdf_fill reads unknown never probed

    Fill AcroForm form fields in a PDF and return the result. Field names must exist in the PDF (use pdf_inspect first). All values are strings; checkboxes take "true"/"false"; dropdown/radio/optionlist values must be one of the field's options; text values must respect the field's maxLength from pdf_inspect. The source PDF is never modified. Returns the filled PDF inline as an application/pdf resource. Owner-locked PDFs (empty user password, common for government blanks) fill without a password; a user-password PDF needs the password parameter, otherwise it is rejected with encrypted_pdf.

    mcp-tool

    {
      "type": "object",
      "required": [
        "pdf_path",
        "fields"
      ],
      "properties": {
        "fields": {
          "type": "object",
          "description": "Field name → string value (from pdf_inspect's fillTemplate)",
          "additionalProperties": {
            "type": "string"
          }
        },
        "flatten": {
          "type": "boolean",
          "description": "Bake values into page content and drop the AcroForm so fields are no longer editable"
        },
        "password": {
          "type": "string",
          "description": "Password to open the input, only needed for a user-password PDF (owner-locked files with an empty user password open without it)."
        },
        "pdf_path": {
          "type": "string",
          "description": "Template PDF source: an https:// URL or a data:application/pdf;base64,… URI (this hosted server cannot read local file paths)."
        }
      },
      "additionalProperties": false
    }
    arguments 29 lines
  • pdf_merge reads unknown never probed

    Merge two or more PDFs into one, in the order given, and return the result. JPG and PNG images are accepted among the sources and each becomes one page the size of the image (use pdf_image_to_pdf for A4 or Letter pages, margins and more options); the type is read from the bytes. Sources are read only and never modified. Returns the merged PDF inline as an application/pdf resource. This tool only concatenates whole documents: it does not reorder, rotate or delete pages within them, and it does not fill forms — use pdf_fill for a fillable form and pdf_invoice to build a document from data. An unreadable or rejected input fails with an error, so a partial merge is never returned.

    mcp-tool

    {
      "type": "object",
      "required": [
        "pdf_paths"
      ],
      "properties": {
        "password": {
          "type": "string",
          "description": "Password to open the input, only needed for a user-password PDF (owner-locked files with an empty user password open without it). Applies to every input."
        },
        "pdf_paths": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "minItems": 2,
          "description": "In order, each a PDF or a JPG or PNG image source: an https:// URL or a data:application/pdf;base64,… (or data:image/jpeg;base64,… / data:image/png;base64,…) URI (this hosted server cannot read local file paths). An image becomes one page."
        }
      },
      "additionalProperties": false
    }
    arguments 21 lines
  • pdf_delete_pages unknown never probed

    Remove the listed pages from a PDF and return the remaining pages in their original order. Use this to drop a cover, blank or sensitive pages; use pdf_extract_pages when it is easier to name the pages to keep. Returns the result inline as an application/pdf resource; the source is never modified. Deleting every page fails with no_pages_left.

    mcp-tool

    {
      "type": "object",
      "required": [
        "pdf_path",
        "pages"
      ],
      "properties": {
        "pages": {
          "type": "string",
          "description": "1-based pages to REMOVE, e.g. \"2,4-6,9-\""
        },
        "password": {
          "type": "string",
          "description": "Password to open the input, only needed for a user-password PDF (owner-locked files with an empty user password open without it)."
        },
        "pdf_path": {
          "type": "string",
          "description": "PDF source: an https:// URL or a data:application/pdf;base64,… URI (this hosted server cannot read local file paths)."
        }
      },
      "additionalProperties": false
    }
    arguments 22 lines
  • pdf_rotate unknown never probed

    Rotate pages of a PDF clockwise by 90, 180 or 270 degrees (or -90). Rotation adds to each page's existing rotation. Omit pages to rotate every page. Use this to fix sideways scans. Returns the result inline as an application/pdf resource; the source is never modified.

    mcp-tool

    {
      "type": "object",
      "required": [
        "pdf_path",
        "degrees"
      ],
      "properties": {
        "pages": {
          "type": "string",
          "description": "1-based page spec such as \"1-3,5\"; default all pages"
        },
        "degrees": {
          "enum": [
            90,
            180,
            270,
            -90
          ],
          "type": "integer",
          "description": "Clockwise rotation to add"
        },
        "password": {
          "type": "string",
          "description": "Password to open the input, only needed for a user-password PDF (owner-locked files with an empty user password open without it)."
        },
        "pdf_path": {
          "type": "string",
          "description": "PDF source: an https:// URL or a data:application/pdf;base64,… URI (this hosted server cannot read local file paths)."
        }
      },
      "additionalProperties": false
    }
    arguments 32 lines
  • pdf_watermark unknown never probed

    Stamp a diagonal text watermark on pages of a PDF (default: centered, 45 degrees, grey, 15% opacity). Text is upright and centered for any page size or existing page rotation. Standard Helvetica only: characters outside WinAnsi (e.g. CJK, emoji) fail with unsupported_characters. Use this for DRAFT / CONFIDENTIAL stamps; use pdf_page_numbers for numbering. Returns the result inline as an application/pdf resource; the source is never modified.

    mcp-tool

    {
      "type": "object",
      "required": [
        "pdf_path",
        "text"
      ],
      "properties": {
        "size": {
          "type": "number",
          "maximum": 200,
          "minimum": 6,
          "description": "Font size in points, default 48"
        },
        "text": {
          "type": "string",
          "maxLength": 200,
          "description": "Watermark text, WinAnsi characters only"
        },
        "color": {
          "type": "string",
          "description": "Hex #rgb or #rrggbb, default #808080"
        },
        "pages": {
          "type": "string",
          "description": "1-based page spec such as \"1-3,5\"; default all pages"
        },
        "opacity": {
          "type": "number",
          "maximum": 1,
          "minimum": 0.05,
          "description": "Default 0.15"
        },
        "password": {
          "type": "string",
          "description": "Password to open the input, only needed for a user-password PDF (owner-locked files with an empty user password open without it)."
        },
        "pdf_path": {
          "type": "string",
          "description": "PDF source: an https:// URL or a data:application/pdf;base64,… URI (this hosted server cannot read local file paths)."
        },
        "position": {
          "enum": [
            "center",
            "top",
            "bottom"
          ],
          "type": "string",
          "description": "Default center"
        },
        "rotation": {
          "type": "number",
          "description": "Degrees counter-clockwise as the viewer sees it, default 45"
        }
      },
      "additionalProperties": false
    }
    arguments 56 lines
  • pdf_page_numbers unknown never probed

    Print page numbers on a PDF using a format template with {n} (page number) and {total} (page count), e.g. "Page {n} of {total}". Default is "{n} / {total}" at bottom-center, 10 pt. Numbers sit upright for any page size or rotation. Standard Helvetica only (WinAnsi characters). Page i always shows start+i-1 even when pages selects only some pages. Returns the result inline as an application/pdf resource; the source is never modified.

    mcp-tool

    {
      "type": "object",
      "required": [
        "pdf_path"
      ],
      "properties": {
        "size": {
          "type": "number",
          "maximum": 72,
          "minimum": 4,
          "description": "Font size in points, default 10"
        },
        "pages": {
          "type": "string",
          "description": "1-based page spec such as \"1-3,5\"; default all pages"
        },
        "start": {
          "type": "integer",
          "maximum": 100000,
          "minimum": 0,
          "description": "Number shown on page 1, default 1"
        },
        "format": {
          "type": "string",
          "maxLength": 100,
          "description": "Template with {n} and {total}, default \"{n} / {total}\""
        },
        "margin": {
          "type": "number",
          "maximum": 200,
          "minimum": 0,
          "description": "Distance in points from the page edge, default 24"
        },
        "password": {
          "type": "string",
          "description": "Password to open the input, only needed for a user-password PDF (owner-locked files with an empty user password open without it)."
        },
        "pdf_path": {
          "type": "string",
          "description": "PDF source: an https:// URL or a data:application/pdf;base64,… URI (this hosted server cannot read local file paths)."
        },
        "position": {
          "enum": [
            "bottom-center",
            "bottom-right",
            "bottom-left",
            "top-center",
            "top-right",
            "top-left"
          ],
          "type": "string",
          "description": "Default bottom-center"
        }
      },
      "additionalProperties": false
    }
    arguments 56 lines
  • pdf_unlock unknown never probed

    Save a PDF without encryption so print/copy/modify restrictions are gone. Works for owner-locked files (empty user password) with no password, and for user-password files when you pass the password. It does NOT crack unknown passwords: a wrong or missing user password fails with encrypted_pdf. A PDF that was not encrypted is returned re-saved, with note "not-encrypted". Returns the result inline as an application/pdf resource; the source is never modified.

    mcp-tool

    {
      "type": "object",
      "required": [
        "pdf_path"
      ],
      "properties": {
        "password": {
          "type": "string",
          "description": "Password to open the input, only needed for a user-password PDF (owner-locked files with an empty user password open without it)."
        },
        "pdf_path": {
          "type": "string",
          "description": "PDF source: an https:// URL or a data:application/pdf;base64,… URI (this hosted server cannot read local file paths)."
        }
      },
      "additionalProperties": false
    }
    arguments 17 lines
  • pdf_protect unknown never probed

    Encrypt a PDF with a password. user_password is required to open the result; owner_password lifts the permission restrictions. Give at least one (each 1 to 32 Latin-1 chars). permissions lists what stays ALLOWED from print, copy, modify, annotate, fill-forms (default all, except modify when an owner password is set; an empty list allows none). Restrictions only bind viewers when an owner password is set. Not byte-deterministic (random salts). Returns the result inline as an application/pdf resource; the source is never modified.

    mcp-tool

    {
      "type": "object",
      "required": [
        "pdf_path"
      ],
      "properties": {
        "password": {
          "type": "string",
          "description": "Password to open the input, only needed for a user-password PDF (owner-locked files with an empty user password open without it)."
        },
        "pdf_path": {
          "type": "string",
          "description": "PDF source: an https:// URL or a data:application/pdf;base64,… URI (this hosted server cannot read local file paths)."
        },
        "permissions": {
          "type": "array",
          "items": {
            "enum": [
              "print",
              "copy",
              "modify",
              "annotate",
              "fill-forms"
            ],
            "type": "string"
          },
          "description": "Actions to ALLOW; omit for the default, [] for none"
        },
        "user_password": {
          "type": "string",
          "maxLength": 128,
          "description": "Password required to open the output"
        },
        "owner_password": {
          "type": "string",
          "maxLength": 128,
          "description": "Password that lifts the restrictions"
        }
      },
      "additionalProperties": false
    }
    arguments 41 lines
  • pdf_metadata unknown never probed

    Read a PDF's document info: page_count, per-page width/height (points) and rotation, title, author, subject, keywords, creator, producer, creation_date, modification_date (ISO 8601, null when absent), whether it was encrypted, and has_form / form_field_count. Call this to learn a document's size and shape before splitting, rotating or filling. Read-only: the PDF is fetched but never modified.

    mcp-tool

    {
      "type": "object",
      "required": [
        "pdf_path"
      ],
      "properties": {
        "password": {
          "type": "string",
          "description": "Password to open the input, only needed for a user-password PDF (owner-locked files with an empty user password open without it)."
        },
        "pdf_path": {
          "type": "string",
          "description": "PDF source: an https:// URL or a data:application/pdf;base64,… URI (this hosted server cannot read local file paths)."
        }
      },
      "additionalProperties": false
    }
    arguments 17 lines
  • pdf_set_metadata unknown never probed

    Write document info fields (title, author, subject, creator, keywords) into a PDF. Give at least one; an empty string sets an empty value. Unicode is fine. Keywords may be a list or a comma-separated string. The output is saved unencrypted. Use pdf_metadata to read the current values. Returns the result inline as an application/pdf resource; the source is never modified.

    mcp-tool

    {
      "type": "object",
      "required": [
        "pdf_path"
      ],
      "properties": {
        "title": {
          "type": "string",
          "maxLength": 1000
        },
        "author": {
          "type": "string",
          "maxLength": 1000
        },
        "creator": {
          "type": "string",
          "maxLength": 1000
        },
        "subject": {
          "type": "string",
          "maxLength": 1000
        },
        "keywords": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          ],
          "description": "Comma-separated string or list of keywords"
        },
        "password": {
          "type": "string",
          "description": "Password to open the input, only needed for a user-password PDF (owner-locked files with an empty user password open without it)."
        },
        "pdf_path": {
          "type": "string",
          "description": "PDF source: an https:// URL or a data:application/pdf;base64,… URI (this hosted server cannot read local file paths)."
        }
      },
      "additionalProperties": false
    }
    arguments 47 lines
  • pdf_edit unknown never probed

    Stamp text and images (logos, signature images, photos) onto specific pages of an existing PDF at exact positions. Coordinates are PDF points measured from the bottom-left corner of the page as the viewer sees it (1 inch = 72 pt; US Letter is 612 x 792), so stamps land upright on any page size or rotation. Text uses standard fonts (WinAnsi characters only: CJK and emoji fail with unsupported_characters) and can wrap to max_width. Images are PNG or JPEG, up to 2 MB each and 10 distinct images per call (the PDF and all images together must stay under 4.5 MB), given as an https:// URL or a data:image/png;base64,... URI. Barcodes (QR, Data Matrix, PDF417, Aztec, Code 128, Code 39, EAN-13/8, UPC-A, ITF-14, Interleaved 2 of 5, GS1-128) are generated from a value and drawn as vector paths, so they scan at any print size (up to 25 per call). Use pdf_fill for fillable form fields and pdf_watermark for a diagonal stamp on every page. Returns the result inline as an application/pdf resource; the source is never modified.

    mcp-tool

    {
      "type": "object",
      "required": [
        "pdf_path",
        "items"
      ],
      "properties": {
        "items": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "type",
              "page",
              "x",
              "y"
            ],
            "properties": {
              "x": {
                "type": "number",
                "description": "Points from the left edge. Text: left of the first line's baseline. Image or barcode: left edge."
              },
              "y": {
                "type": "number",
                "description": "Points from the bottom edge. Text: the first line's baseline. Image or barcode: bottom edge."
              },
              "font": {
                "enum": [
                  "Helvetica",
                  "Helvetica-Bold",
                  "Helvetica-Oblique",
                  "Times-Roman",
                  "Times-Bold",
                  "Courier"
                ],
                "type": "string",
                "description": "type=text: default Helvetica"
              },
              "page": {
                "type": "integer",
                "minimum": 1,
                "description": "1-based page number"
              },
              "size": {
                "type": "number",
                "maximum": 200,
                "minimum": 4,
                "description": "type=text: font size in points, default 12"
              },
              "text": {
                "type": "string",
                "maxLength": 2000,
                "minLength": 1,
                "description": "type=text: the text; \\n starts a new line"
              },
              "type": {
                "enum": [
                  "text",
                  "image",
                  "barcode"
                ],
                "type": "string"
              },
              "color": {
                "type": "string",
                "description": "type=text or barcode: hex #rgb or #rrggbb, default #000000"
              },
              "image": {
                "type": "string",
                "description": "type=image: PNG or JPEG as an https:// URL or a data:image/png;base64,… URI"
              },
              "value": {
                "type": "string",
                "maxLength": 3000,
                "minLength": 1,
                "description": "type=barcode: data to encode; format rules apply (ean13 = 12 or 13 digits, gs1-128 = bracketed AIs like (01)09506000134352)"
              },
              "width": {
                "type": "number",
                "minimum": 0.1,
                "description": "type=image or barcode: width in points. Images and 2D codes: give only width or height to keep the aspect ratio (2D codes default to 72 pt). Linear codes: a missing side keeps 1 pt per module and 1 inch tall"
              },
              "format": {
                "enum": [
                  "qrcode",
                  "datamatrix",
                  "pdf417",
                  "azteccode",
                  "code128",
                  "code39",
                  "ean13",
                  "ean8",
                  "upca",
                  "itf14",
                  "interleaved2of5",
                  "gs1-128"
                ],
                "type": "string",
                "description": "type=barcode: symbology"
              },
              "height": {
                "type": "number",
                "minimum": 0.1,
                "description": "type=image or barcode: height in points"
              },
              "opacity": {
                "type": "number",
                "maximum": 1,
                "minimum": 0.05,
                "description": "Default 1"
              },
              "rotation": {
                "type": "number",
                "maximum": 360,
                "minimum": -360,
                "description": "type=text: degrees counter-clockwise as the viewer sees it, default 0"
              },
              "max_width": {
                "type": "number",
                "minimum": 1,
                "description": "type=text: wrap words to this width in points"
              },
              "background": {
                "type": "string",
                "description": "type=barcode: optional hex fill behind the symbol; no quiet zone is added, so leave a margin"
              },
              "line_height": {
                "type": "number",
                "maximum": 5,
                "minimum": 0.5,
                "description": "type=text: line spacing as a multiple of size, default 1.2"
              },
              "include_text": {
                "type": "boolean",
                "description": "type=barcode: print the human-readable value under linear codes, default false"
              },
              "error_correction": {
                "enum": [
                  "L",
                  "M",
                  "Q",
                  "H"
                ],
                "type": "string",
                "description": "type=barcode, qrcode only: error correction level, default M"
              }
            },
            "additionalProperties": false
          },
          "maxItems": 100,
          "minItems": 1,
          "description": "Stamps to draw, in order (later items draw on top)."
        },
        "password": {
          "type": "string",
          "description": "Password to open the input, only needed for a user-password PDF (owner-locked files with an empty user password open without it)."
        },
        "pdf_path": {
          "type": "string",
          "description": "PDF source: an https:// URL or a data:application/pdf;base64,… URI (this hosted server cannot read local file paths)."
        }
      },
      "additionalProperties": false
    }
    arguments 164 lines
  • pdf_extract_text unknown never probed

    Read the text of a born-digital PDF (one made by software: invoices, statements, reports, contracts, forms), page by page, in reading order, plus any tables found from the text layout as rows of cells. Scanned PDFs (images of pages) have no text layer and come back listed in pages_without_text: OCR is not supported. Set include_lines to also get each line with its position in PDF points from the bottom-left of the page as the viewer sees it, the same frame pdf_edit uses, so you can stamp text next to something you found. Up to 200 pages per call; pass pages to read a large document in parts. To search for specific text instead, use pdf_find_text. Read-only: the source is never modified.

    mcp-tool

    {
      "type": "object",
      "required": [
        "pdf_path"
      ],
      "properties": {
        "pages": {
          "type": "string",
          "description": "Pages to read, 1-based: \"1-3,5,8-\". Default: all pages."
        },
        "password": {
          "type": "string",
          "description": "Password to open the input, only needed for a user-password PDF (owner-locked files with an empty user password open without it)."
        },
        "pdf_path": {
          "type": "string",
          "description": "PDF source: an https:// URL or a data:application/pdf;base64,… URI (this hosted server cannot read local file paths)."
        },
        "include_lines": {
          "type": "boolean",
          "description": "Also return every line of text with x, y, width and font size in points. Default false (smaller output)."
        },
        "tables_format": {
          "enum": [
            "json",
            "csv"
          ],
          "type": "string",
          "description": "csv adds a csv string (RFC 4180, CRLF line ends) to each table next to rows. Default json. Cell values are returned verbatim: a cell starting with = + - or @ can run as a formula if the CSV is opened in a spreadsheet, so sanitise before opening."
        }
      },
      "additionalProperties": false
    }
    arguments 33 lines
  • pdf_text_to_pdf unknown never probed

    Create a new PDF from Markdown, plain text or a CSV table, with no template and no input PDF. This is NOT HTML-to-PDF: it does not render HTML or CSS, and it has no custom fonts or images (images in Markdown stay literal text). Text is set in the standard Helvetica family, code and monospace text in Courier, on Letter or A4 pages. Markdown supports headings 1-6, bold, italic, inline code, links (printed as text plus the URL; http(s) and mailto links are also clickable), fenced code blocks, bullet and numbered lists, one-level blockquotes, horizontal rules, pipe tables (header shaded and repeated per page; column alignment ignored) and \pagebreak; anything else prints as typed. format text keeps spaces and line breaks exactly. format csv draws a table whose first row is the header (up to 20 columns, 10,000 rows, 100,000 cells). content is capped at 512 KiB and the output at 200 pages. WinAnsi characters only (English and Western European letters and common punctuation): emoji, Cyrillic, Greek and CJK fail with unsupported_characters, naming the character and its line and column. Very large tables or heavy inline formatting fail with content_too_complex. Deterministic: the same input gives byte-identical output, and the PDF carries no PDFops footer. Returns the PDF inline as an application/pdf resource. To add text to an existing PDF use pdf_edit; to build an invoice from data use pdf_invoice.

    mcp-tool

    {
      "type": "object",
      "required": [
        "content"
      ],
      "properties": {
        "title": {
          "type": "string",
          "maxLength": 200,
          "description": "PDF Title metadata (not printed on the page), up to 200 characters."
        },
        "format": {
          "enum": [
            "markdown",
            "text",
            "csv"
          ],
          "type": "string",
          "description": "How to read content. Default markdown."
        },
        "margin": {
          "type": "number",
          "maximum": 144,
          "minimum": 18,
          "description": "Page margin in points, 18-144. Default 54."
        },
        "content": {
          "type": "string",
          "description": "The document: Markdown (default), plain text or CSV, up to 512 KiB of UTF-8."
        },
        "font_size": {
          "type": "number",
          "maximum": 36,
          "minimum": 6,
          "description": "Body text size in points, 6-36. Default 11."
        },
        "monospace": {
          "type": "boolean",
          "description": "Set the text in Courier. Only used with format text. Default false."
        },
        "page_size": {
          "enum": [
            "a4",
            "letter"
          ],
          "type": "string",
          "description": "Default letter."
        },
        "page_numbers": {
          "type": "boolean",
          "description": "Print \"Page n of N\" at the bottom of every page. Default false."
        }
      },
      "additionalProperties": false
    }
    arguments 55 lines
  • pdf_find_text unknown never probed

    Search a born-digital PDF (one made by software: invoices, statements, reports, contracts, forms) for a word, phrase or pattern and get each hit with its page and box in PDF points from the bottom-left of the page as the viewer sees it, y on the text baseline: the same frame pdf_edit uses, so a hit's x, y, width and height tell you where to stamp. Case-insensitive unless case_sensitive is true. Set regex to treat query as a regular expression from a safe subset (literals, classes, dot, anchors, word boundaries, groups, alternation, quantifiers including lazy ones); backreferences, lookahead, lookbehind, named groups, property escapes and inline flags are rejected. A match never spans lines. Scanned PDFs have no text layer: their pages are listed in pages_without_text (no OCR). While next_page is not null, call again with pages set to next_page followed by a dash (for example 4-) to continue with no gaps or repeated hits. If truncated is true but next_page is null, hits on a page listed in pages_skipped beyond max_hits cannot be retrieved: raise max_hits or narrow the query. Read-only: the source is never modified.

    mcp-tool

    {
      "type": "object",
      "required": [
        "pdf_path",
        "query"
      ],
      "properties": {
        "pages": {
          "type": "string",
          "description": "Pages to search, 1-based: \"1-3,5,8-\". Default: all pages. At most 200 pages per call."
        },
        "query": {
          "type": "string",
          "maxLength": 200,
          "description": "Text to find, or a pattern when regex is true. At most 200 characters."
        },
        "regex": {
          "type": "boolean",
          "description": "Treat query as a regular expression (the supported subset). Default false."
        },
        "max_hits": {
          "type": "integer",
          "maximum": 1000,
          "minimum": 1,
          "description": "Stop once more hits than this exist. Default 100."
        },
        "password": {
          "type": "string",
          "description": "Password to open the input, only needed for a user-password PDF (owner-locked files with an empty user password open without it)."
        },
        "pdf_path": {
          "type": "string",
          "description": "PDF source: an https:// URL or a data:application/pdf;base64,… URI (this hosted server cannot read local file paths)."
        },
        "whole_word": {
          "type": "boolean",
          "description": "Only report matches with no letter, digit, underscore or combining mark directly before or after. Default false."
        },
        "case_sensitive": {
          "type": "boolean",
          "description": "Default false: matching ignores case."
        }
      },
      "additionalProperties": false
    }
    arguments 45 lines
  • pdf_image_to_pdf unknown never probed

    Make a PDF from JPG and PNG images: one image per page, in the order given. Each image is an https:// URL or a data:image/jpeg;base64,… or data:image/png;base64,… URI (this hosted server cannot read local file paths); the type is detected from the bytes, not the name. At most 100 images, each up to 4 MB, 4.5 MB in total. page_size "fit" (default) makes each page the image's own size at 72 dpi (1 px = 1 pt; pages longer than 5,000 pt on a side are scaled down, tiny images are enlarged to a 3 pt minimum); "a4" or "letter" put the image on a standard page, centred, shrunk to fit inside the margin and never enlarged. orientation (auto, portrait, landscape; default auto picks per image) applies to a4 and letter only. margin is 0-200 pt (default 0 for fit, where the page grows by the margin on every side; 36 for a4 and letter). A JPEG's EXIF orientation is applied, so phone photos come out upright. PNG: 8-bit and 16-bit, palette, grey, interlaced and transparent files work (transparency is kept); animated PNGs, other formats (GIF, WebP, HEIC, TIFF, SVG) and PDFs are rejected. JPEG: baseline and progressive, grey, RGB and Adobe-style CMYK. Very large images fail with image_too_large (PNG over 10 megapixels or a memory estimate; JPEG over 250 megapixels), and many large PNGs in one call with images_too_large_together. Deterministic: the same images give byte-identical output. To join images with existing PDFs use pdf_merge, which also accepts images. Returns the PDF inline as an application/pdf resource.

    mcp-tool

    {
      "type": "object",
      "required": [
        "image_paths"
      ],
      "properties": {
        "margin": {
          "type": "number",
          "maximum": 200,
          "minimum": 0,
          "description": "Points, 0-200. Default 0 for fit, 36 for a4 and letter."
        },
        "page_size": {
          "enum": [
            "fit",
            "a4",
            "letter"
          ],
          "type": "string",
          "description": "fit (default): page = image size. a4 or letter: standard page, image centred and shrunk to fit."
        },
        "image_paths": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "maxItems": 100,
          "minItems": 1,
          "description": "In order, one page each: an https:// URL or a data:image/jpeg;base64,… / data:image/png;base64,… URI (this hosted server cannot read local file paths)."
        },
        "orientation": {
          "enum": [
            "auto",
            "portrait",
            "landscape"
          ],
          "type": "string",
          "description": "a4 and letter only; auto (default) picks portrait or landscape per image."
        }
      },
      "additionalProperties": false
    }
    arguments 42 lines
  • pdf_add_attachment unknown never probed

    Embed one or more files (for example an XML or CSV data file) in a PDF as attachments. Each entry in files has a source (an https:// URL or a data: URI with base64, never a local path) and optional name, mime_type, description (at most 1,000 characters) and relationship (Alternative, Data, Source, Supplement or Unspecified, default Unspecified; the PDF/A-3 AFRelationship value). name is 1-255 characters and at most 255 UTF-8 bytes with no / or backslash or control characters, and defaults to the last part of an https:// URL path (a data: URI needs a name). mime_type looks like text/xml, with no parameters and no #. At most 10 files and 3 MB in total per call, and at most 200 attachments in the finished PDF. A PDF whose list of embedded files has over 2,000 entries (name_tree_too_large) or an unreadable existing name (attachments_too_complex) is refused. A name already used by an attachment in the PDF (as a key or as an entry's /UF or /F), or twice in the call, is refused. Existing content, including any existing attachments, is kept. Each file keeps its full name; the lookup key for qpdf --show-attachment is plain ASCII and is returned in the result as keys. Unknown keys are rejected. The whole file is saved again, so an existing digital signature on the PDF stops validating. Returns the PDF inline as an application/pdf resource; the source is never modified.

    mcp-tool

    {
      "type": "object",
      "required": [
        "pdf_path",
        "files"
      ],
      "properties": {
        "files": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "source"
            ],
            "properties": {
              "name": {
                "type": "string",
                "maxLength": 255,
                "minLength": 1,
                "description": "Attachment name. Default: last part of the URL path."
              },
              "source": {
                "type": "string",
                "description": "File source: an https:// URL or a data:<type>;base64,… URI."
              },
              "mime_type": {
                "type": "string",
                "description": "For example text/xml."
              },
              "description": {
                "type": "string",
                "maxLength": 1000
              },
              "relationship": {
                "enum": [
                  "Alternative",
                  "Data",
                  "Source",
                  "Supplement",
                  "Unspecified"
                ],
                "type": "string",
                "description": "PDF/A-3 AFRelationship. Default Unspecified."
              }
            },
            "additionalProperties": false
          },
          "maxItems": 10,
          "minItems": 1,
          "description": "Files to embed. Nothing is added unless every entry is valid."
        },
        "password": {
          "type": "string",
          "description": "Password to open the input, only needed for a user-password PDF (owner-locked files with an empty user password open without it)."
        },
        "pdf_path": {
          "type": "string",
          "description": "PDF source: an https:// URL or a data:application/pdf;base64,… URI (this hosted server cannot read local file paths)."
        }
      },
      "additionalProperties": false
    }
    arguments 62 lines
_ try it through the hub, ceiling 0

This deployment has no calling key, so nothing can be run from here. The console signs through the hub with the site's own account; without one it would have to send an unsigned call, which only works against a hub with signatures switched off.

_ is this your agent? claim it: badge, payouts, history

Nobody has claimed this listing. Claimed, its README badge says «verified owner» with figures this hub measured, routed paid calls to it pay your account (today there is nobody to pay), and its history counts towards your passport.

  1. Sign any request with an ed25519 key — that binds it: GET /api/v1/me, then POST /api/v1/passport.
  2. Prove it is yours. Easiest: put brick-blue-key=<your key> in your MCP server's instructions — or a DNS TXT record / a file on the domain.
  3. Ask the hub to check: POST /api/v1/passport/claim-endpoint with this listing's id c76618a3beba1a0a.

Every step, filled in for this listing: https://brick.blue/api/v1/agents/c76618a3beba1a0a/claim. Over MCP: the claim_endpoint tool.

_ for your README measured, not declared

measured by brick.blue

[![measured by brick.blue](https://brick.blue/api/v1/agents/c76618a3beba1a0a/badge.svg)](https://brick.blue/agent/c76618a3beba1a0a?ref=badge)

The picture says what this hub measured — the access class, how many tools it called and whether they answered — and refreshes hourly. Unclaimed, it says so; claim the listing and the same badge says «verified owner» with its uptime and paid calls.

_ how we know
card completeness
100%

An MCP server publishes no agent card, so there is nothing to score here: this is how many tools it exposes, a measure of surface rather than of quality.

spec deviations
0

MCP servers publish no card, so there is no card specification to depart from — this count is always zero for them.

_ record

Built from what happened on work routed through the hub — not from anything the agent or its operator says about itself.

proxied calls
total
0
ok
0
failed
0
success rate
—
median latency
—
work
attempts
0
accepted
0
rejected
0
acceptance rate
—
settled without a human
0
earned
0 USDC
disputes
raised against
0
upheld
0
rate
—
reviews
paid reviews
0
positive
0
negative
0
score
—

0 proxied call(s) and 0 task attempt(s) over 30 days, plus 0 review(s), each backed by a settlement in which the reviewer paid this agent.