protogrid

Search / dev.pdfops/pdfops-mcp

pdfops-mcp

R1· needs a key

Deterministic PDF tools for AI agents: inspect fields, fill forms, merge PDFs, invoices.

v0.3.6 · active · repository · website · descriptor JSON · versions

An agent can connect on its own if it already holds PDFOPS_MCP_TOKEN.Remote endpoint behind a static API key or header. The registry never sees the value; the agent fills the placeholder.
Quality100strong
Trust100of 100
Uptime, 30 days100%
Latency p50671 ms

Connect

8 clients · secrets stay placeholders
{
  "mcpServers": {
    "pdfops-mcp": {
      "type": "http",
      "url": "https://pdfops.dev/api/mcp",
      "headers": {
        "Authorization": "Bearer ${PDFOPS_MCP_TOKEN}"
      }
    }
  }
}
claude mcp add --transport http pdfops-mcp https://pdfops.dev/api/mcp --header "Authorization: Bearer ${PDFOPS_MCP_TOKEN}"
[mcp_servers.pdfops-mcp]
url = "https://pdfops.dev/api/mcp"
bearer_token_env_var = "PDFOPS_MCP_TOKEN"
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "pdfops-mcp": {
      "type": "remote",
      "url": "https://pdfops.dev/api/mcp",
      "enabled": true,
      "headers": {
        "Authorization": "Bearer {env:PDFOPS_MCP_TOKEN}"
      }
    }
  }
}
{
  "mcpServers": {
    "pdfops-mcp": {
      "type": "http",
      "url": "https://pdfops.dev/api/mcp",
      "headers": {
        "Authorization": "Bearer ${PDFOPS_MCP_TOKEN}"
      }
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=pdfops-mcp&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vcGRmb3BzLmRldi9hcGkvbWNwIiwiaGVhZGVycyI6eyJBdXRob3JpemF0aW9uIjoiQmVhcmVyICR7UERGT1BTX01DUF9UT0tFTn0ifX0%3D"
}
{
  "servers": {
    "pdfops-mcp": {
      "type": "http",
      "url": "https://pdfops.dev/api/mcp",
      "headers": {
        "Authorization": "Bearer ${PDFOPS_MCP_TOKEN}"
      }
    }
  }
}
{
  "mcpServers": {
    "pdfops-mcp": {
      "httpUrl": "https://pdfops.dev/api/mcp",
      "headers": {
        "Authorization": "Bearer ${PDFOPS_MCP_TOKEN}"
      }
    }
  }
}
extensions:
  "pdfops-mcp":
    enabled: true
    name: "pdfops-mcp"
    type: streamable_http
    uri: "https://pdfops.dev/api/mcp"
    headers:
      "Authorization": "Bearer ${PDFOPS_MCP_TOKEN}"
    timeout: 300

Placeholders to fill from your own secret store: ${PDFOPS_MCP_TOKEN}. The registry never accepts secret values.

Quality 100 / 100strong

protocol100 · weight 25
  • pass
    protocol.modernsupports 2026-07-28 (server/discover)
  • pass
    protocol.statelessanswers without a session
  • pass
    protocol.transportstreamable HTTP
  • pass
    protocol.list_ttltool list is cacheable (ttlMs 300000)
authorizationn/a · weight 15
  • n/a
    auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
  • n/a
    auth.secret_in_urlno templated URL
tool hygiene100 · weight 30
  • pass
    tools.descriptionsevery tool has a description
  • pass
    tools.description_lengthdescriptions are concise
  • pass
    tools.schemasevery tool has an object input schema
  • pass
    tools.annotations5 of 5 tools declare readOnlyHint or destructiveHint
  • pass
    tools.directory_hintsevery tool declares readOnlyHint, destructiveHint, idempotentHint and openWorldHint
  • pass
    tools.token_costabout 1,281 tokens to load every tool
  • pass
    tools.api_dumptools are not a one-to-one API dump
stability100 · weight 15
  • pass
    stability.changesno tool changes in 30 days
  • pass
    stability.rug_pullno tool changed its meaning under the same name
dependenciesn/a · weight 15
  • n/a
    deps.known_vulns, deps.mcp_sdk_version, deps.resolvabledeps.dev does not know [email protected]

5 tools, about 1,281 tokens to load them all · tool set addc135e36de · checked 2026-10-19 10:20 UTC

Tool changes

No tool definition changes recorded. A server's first observation is its baseline; later probes record what changes.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 100 / 100

provenance100
liveness100
freshness100
hygiene100

+repository +namespace-matches-repo +dns-namespace +website +reachable +uptime-100% +updated-19d-ago

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Dependencies

[email protected] npmthis version is not known to the dependency resolver

Dependency graphs from deps.dev; advisories from OSV.dev, including the GitHub Advisory Database and the PyPI Advisory Database; all CC BY 4.0. The graph is what a clean install of this version resolves today; nothing was installed or run. How it is checked.

Endpoints

remoteauthreachableuptime 30dp50protocollast ok
https://pdfops.dev/api/mcp streamable-httpapi_key ${PDFOPS_MCP_TOKEN}yes100%671 ms2026-07-28, 2025-11-25, 2025-06-18, 2025-03-262026-10-19
packageregistryversionruntimesecrets
pdfops-mcpnpm0.3.6–

Tools (5)

pdf_fillFill 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. Encrypted PDFs are rejected with decrypt advice (common for government blanks with an empty user password).
pdf_inspectread-onlyList 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.
pdf_invoiceGenerate 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.
pdf_mergeMerge two or more PDFs into one, in the order given, and return the result. 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.
pdfops_usageread-onlyCheck 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.

Schemas: list_tools.

Similar MCP servers

Official server.json
{
  "name": "dev.pdfops/pdfops-mcp",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "remotes": [
    {
      "url": "https://pdfops.dev/api/mcp",
      "type": "streamable-http",
      "headers": [
        {
          "name": "Authorization",
          "isSecret": true,
          "isRequired": true,
          "description": "Bearer <PDFOPS_API_KEY>. Free key at https://pdfops.dev/pricing#free-key"
        }
      ]
    }
  ],
  "version": "0.3.6",
  "packages": [
    {
      "version": "0.3.6",
      "transport": {
        "type": "stdio"
      },
      "identifier": "pdfops-mcp",
      "registryType": "npm"
    }
  ],
  "repository": {
    "url": "https://github.com/pdfops/pdfops-mcp",
    "source": "github"
  },
  "websiteUrl": "https://pdfops.dev",
  "description": "Deterministic PDF tools for AI agents: inspect fields, fill forms, merge PDFs, invoices."
}