Install Jentic One Beta

Connect the PDFMint API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the PDFMint API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fmintapis.com%2Fmintapis" | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fmintapis.com%2Fmintapis" | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with PDFMint API.

Render HTML, Markdown, or a public URL to a PDF with page format, margin, and landscape options

Fill a stored template's {{placeholders}} from a data object and render it to PDF

Screenshot HTML, Markdown, or a URL to PNG or JPEG, including full-page captures

Merge up to 50 PDFs from URLs or base64 into a single document

Queue a render asynchronously with a webhookUrl and poll the job until it finishes

GET STARTED

Start building with PDFMint API

Explore with Jentic One

View OpenAPI Document

Use Cases

Patterns agents use PDFMint API for, with concrete tasks.

★ Agent-Generated Documents Through Jentic

An AI agent that drafts a report or invoice in HTML or Markdown calls PDFMint to turn it into a downloadable PDF and returns a hosted link to the user. Through Jentic the agent finds the PDF render operation by intent, sends the markdown or html field with output set to url, and receives a temporary file link without handling the key itself.

Render a Markdown weekly report headed '# Weekly Report' to an A4 PDF with pageNumbers true and output 'url', then return the hosted link

Templated Invoices and Certificates

Billing and training systems store an HTML template once under a name, then render it per customer by passing values for its {{placeholders}} in data. Strict mode refuses to return a document with unfilled placeholders, so a missing field fails loudly instead of producing a blank invoice.

Store a template named 'invoice' with HTML containing {{customer}} and {{total}}, then render it to PDF with data {"customer": "Acme Ltd", "total": "$420.00"} and strict true

Web Page Archiving and Screenshots

Teams capture a public page as a PDF for records, or as a PNG or JPEG for previews and social cards, with control over viewport width, device scale factor, and full-page capture. A waitFor option holds the render until a selector appears or the network is idle so dynamic content is included.

Screenshot 'https://example.com' as a full-page PNG at width 1280 and return it as base64

Combining Documents into One PDF

Document workflows that produce separate files, such as a cover letter, a contract, and an appendix, merge them into one PDF from public URLs or base64 inputs, up to 50 per request, and set metadata such as title and author on the result.

Merge three PDFs from their public URLs into one file named 'contract-pack.pdf' and return a hosted link

Key Endpoints

16 endpoints — the pdfmint api renders html, markdown, a public url, or a stored template into a pdf, and screenshots the same sources to png or jpeg.

METHOD

PATH

DESCRIPTION

POST

/v1/pdf

Render HTML, Markdown, a URL, or a template to PDF

POST

/v1/image

Render HTML, Markdown, or a URL to PNG or JPEG

POST

/v1/merge

Merge 2-50 PDFs into one

GET

/v1/jobs/{id}

Poll an asynchronous render job

PUT

/v1/templates/{name}

Create or replace a stored template

GET

/v1/templates

List stored templates

GET

/v1/me

Account balance and plan

POST

/v1/pdf

Render HTML, Markdown, a URL, or a template to PDF

POST

/v1/image

Render HTML, Markdown, or a URL to PNG or JPEG

POST

/v1/merge

Merge 2-50 PDFs into one

GET

/v1/jobs/{id}

Poll an asynchronous render job

PUT

/v1/templates/{name}

Create or replace a stored template

GET

/v1/templates

List stored templates

GET

/v1/me

Account balance and plan

Why Jentic?

What agents get from Jentic-routed access to this vendor.

Setup

Wiring PDFMint by hand means choosing between its Bearer and x-api-key header styles, handling binary, url, or base64 responses, and polling async jobs or wiring a webhook. Through Jentic you install once, import PDFMint from the API Directory, store the key once, and your agent calls it.

Permission scoping

PDFMint puts the template name in the URL path (/v1/templates/{name}), so a rule can pin template reads and writes to one named template. Render content travels in the request body, so for renders rules bound which operations your agent may call, not what it renders, and sensitive ones like issuing or revoking API keys are not included unless you add them.

Credential isolation

Your PDFMint key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.

Intent-based discovery

Agents search Jentic by intent such as 'convert HTML to PDF' or 'merge PDF files', and Jentic returns the matching PDFMint operation with its input schema so the agent calls the right endpoint without reading the reference docs.

FAQs

Specific to using PDFMint API through Jentic.

What authentication does the PDFMint API use?

Per its OpenAPI spec, the PDFMint API accepts a key either as `Authorization: Bearer <key>` or in the `x-api-key` header, with keys starting `pm_live_`. A few operations are public and need no credential: the keyless HTML demo render and the forgot-password and reset-password flows. Through Jentic the key is stored once, encrypted, by your own Jentic One instance and injected at call time.

Can I fill a template with data and render it to PDF with the PDFMint API?

Yes. Store HTML containing {{placeholders}} with the create-or-replace template operation, then call the PDF render with template set to the stored name and data holding the values. The template response lists the placeholders it uses, and strict mode returns a 400 instead of a document with unfilled fields.

Can I limit what my agent is allowed to do with the PDFMint API?

Yes. For example, write a rule that allows only the PDF render, image render, and job-poll operations, so the agent can produce documents and check async jobs while key issuance, key revocation, and template deletion stay out of reach, and every call it makes is logged.

What are the rate limits for the PDFMint API?

The PDFMint OpenAPI spec states that every authenticated endpoint is limited to 120 requests per minute per account with a burst of 30, reported in the X-RateLimit-Limit, X-RateLimit-Burst, and X-RateLimit-Remaining headers. A 429 response carries Retry-After. Each render or merge costs 1 credit.

How do I render a PDF with PDFMint through Jentic?

Search Jentic for the intent 'convert HTML to PDF', which returns the PDFMint render operation on /v1/pdf with its input schema; the agent sends html, markdown, url, or template plus any page options, and gets the PDF back as binary, a hosted url, or base64. To run it on your own infrastructure, install Jentic One from its GitHub repo.

Is there a PDFMint MCP server?

You don't need an MCP server to give your agent the PDFMint API. Jentic connects it directly from the API Directory: import it, store your key once, and your agent calls the render, merge, and template operations. Operations are discovered on demand, so no extra tool definitions are loaded into the agent's context.

Mint PDFMint API

AI ReadinessFoundational (C-)51/100

See full scorecard

Official vendor OpenAPI document · agent-readyData EnrichmentData Transformationbearer, apiKey16 EndpointsREST

For Agents

Render HTML, Markdown, URLs, or stored templates to PDF or PNG/JPEG, merge PDFs, and poll async render jobs with PDFMint. Authenticated with a Bearer key or an x-api-key header.

Use for: I need to turn this HTML invoice into a PDF, Render a Markdown report to an A4 PDF with page numbers, Take a full-page PNG screenshot of a web page, Merge these five PDF URLs into one file

Not supported: Does not handle PDF text extraction, OCR, form filling of existing PDFs, or e-signatures. Use for rendering HTML, Markdown, URLs, and templates to PDF or images, and merging PDFs only.

The PDFMint API renders HTML, Markdown, a public URL, or a stored template into a PDF, and screenshots the same sources to PNG or JPEG. Renders return binary bytes, a temporary hosted link, or base64, and can run asynchronously with a job you poll or a webhook notified on completion. Page options cover formats from A0 to Ledger, margins, headers and footers, page numbers, cover pages, watermarks, and password encryption, and a merge operation combines up to 50 PDFs into one. Stored templates with {{placeholders}} are filled from a data object at render time.

Jentic One on Github View OpenAPI Document

Show dimension breakdown

Foundational Compliance

Base layer of spec validity and structural soundness.

Grade: A-Signals: 4

97%

Lint Results

Aggregated quality score from linter diagnostics, weighted by severity.

100%

Resolution Completeness

Percentage of `$ref` references that resolve successfully.

100%

Specification Validity

Checks whether the API description parses successfully and conforms to its declared specification (e.g., OpenAPI).

Structural Integrity

Structural correctness score based on schema issues using logarithmic dampening.

Developer Experience & Jentic Compatibility

Clarity, completeness, and ingestion readiness for developers and tooling.

Grade: BSignals: 4

Example Density

How richly the API is illustrated with examples.

100%

Example Validity

Percentage of examples that conform to their schemas.

55%

Response Coverage

Percentage of operations with complete response definitions (success, client error, server error).

100%

Tooling Readiness

Health of API ingestion, bundling, and resolution within Jentic pipelines.

AI-Readiness & Agent Experience

Semantic breadth, depth, and agent comprehension for AI systems.

Grade: FSignals: 4

50%

Description Coverage

Coverage of descriptions across API elements.

Error Standardization

Coverage of RFC 9457 Problem Details for error responses.

OperationId Quality

Coverage, uniqueness, and casing consistency of operationIds for AI inference.

55%

Summary Coverage

Coverage of summaries across operations/tags/info.

Agent Usability

Functional utility, complexity comfort, and AI orchestration readiness.

Grade: A+Signals: 1

94%

Complexity Comfort

Agent comfort level based on API operational and structural complexity.

Security

Trust, risk posture, and security compliance.

Grade: CSignals: 1

55%

Authentication Strength

Average quality of security schemes based on authentication method strength (weakest link for OAuth2).

AI Discoverability

Findability, semantic richness, and reasoning readiness.

Grade: A-Signals: 1

80%

Descriptive Richness

Clarity and depth of descriptions across API elements.

Connect the PDFMint API to your agent

Capabilities

Start building with PDFMint API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs

Mint PDFMint API

Jentic AI Readiness Score

PDFMint API

Foundational Compliance

Lint Results

Resolution Completeness

Specification Validity

Structural Integrity

Developer Experience & Jentic Compatibility

Example Density

Example Validity

Response Coverage

Tooling Readiness

AI-Readiness & Agent Experience

Description Coverage

Error Standardization

OperationId Quality

Summary Coverage

Agent Usability

Complexity Comfort

Security

Authentication Strength

AI Discoverability

Descriptive Richness