Install Jentic One Beta

Connect the Intelliprint API Reference to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Intelliprint API Reference, 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%2Fintelliprint.net%2Fintelliprint" | 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%2Fintelliprint.net%2Fintelliprint" | 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 Intelliprint API Reference API.

Create a letter or postcard print job from content, a template, or an uploaded file, and send it to recipients or a mailing_list

Run a job in testmode to preview it without charge, then set confirmed to submit it for printing

Choose a postage service such as uk_first_class, uk_special_delivery, tracked_24, or international, plus envelope size and mail_date

Split one uploaded file of pre-addressed letters into separate mailings by phrase, by page count, or by mailing list

GET STARTED

Start building with Intelliprint API Reference API

Explore with Jentic One

View OpenAPI Document

Use Cases

Patterns agents use Intelliprint API Reference API for, with concrete tasks.

★ Agent-sent postal letters through Jentic

An AI agent connected through Jentic posts a physical letter when a workflow calls for one, such as a final payment reminder or a contract that must arrive on paper. It creates the print job with HTML content and the recipient's address in testmode, checks the result, then confirms the job for printing. The API key stays in your own Jentic One instance, never in the agent's context.

Call POST /prints with type 'letter', content set to the reminder text for invoice INV-2041, one recipient address, and testmode true, then POST /prints/{id} with confirmed true once the preview is correct

Postcard campaigns to a mailing list

Marketing teams send a postcard to a saved list. Create the mailing list with a name and recipients, each with an address and optional variables for personalisation, then create a print job of type postcard with the mailing_list id. Postcards can be sent with the uk_first_class or uk_second_class postage services, in sizes such as postcard_a6 or postcard_a5.

Call POST /mailing_lists with name 'Black Friday Leads' and the recipients, then POST /prints with type 'postcard', the returned mailing_list id, and postage service 'uk_second_class'

Bulk letters from one pre-addressed file

Billing systems often output one PDF holding many statements, each with its address already printed. Upload it as a single print job and use splitting with the split_on_phrase or split_on_pages method to turn it into separate letters. Intelliprint extracts the addresses from the file, and nudge settings shift the address into the envelope window if needed.

Call POST /prints with type 'letter', the statements file, and splitting method 'split_on_phrase' with the phrase 'Statement date', in testmode true, then review the resulting letters

Key Endpoints

20 endpoints — the intelliprint api prints and posts physical letters and postcards from code.

METHOD

PATH

DESCRIPTION

POST

/prints

Create a print job

GET

/prints

List print jobs

GET

/prints/{id}

Retrieve a print job

POST

/prints/{id}

Update or confirm a print job

DELETE

/prints/{id}

Delete or cancel a print job

POST

/mailing_lists

Create a mailing list

POST

/mailing_lists/{mailing_list}/recipients

Add a recipient to a mailing list

POST

/backgrounds

Upload a background

POST

/prints

Create a print job

GET

/prints

List print jobs

GET

/prints/{id}

Retrieve a print job

POST

/prints/{id}

Update or confirm a print job

DELETE

/prints/{id}

Delete or cancel a print job

POST

/mailing_lists

Create a mailing list

POST

/mailing_lists/{mailing_list}/recipients

Add a recipient to a mailing list

POST

/backgrounds

Upload a background

Why Jentic?

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

Setup

Wiring Intelliprint by hand means sending its bearer key, building multipart print jobs with postage, printing, and splitting objects, and handling the testmode then confirm sequence. Through Jentic you install once, import Intelliprint from the API Directory, store the key once, and your agent calls it.

Permission scoping

Intelliprint puts print job, mailing list, and background ids in the URL path (/mailing_lists/{mailing_list}/recipients), so a rule can pin your agent to one mailing list and the operations you pick. You choose the operations it may call, so ones like cancelling print jobs or deleting mailing lists are not included unless you add them.

Credential isolation

Your Intelliprint API 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 'send a physical letter' or 'mail a postcard to a list', and Jentic returns the matching Intelliprint operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

FAQs

Specific to using Intelliprint API Reference API through Jentic.

Is there an Intelliprint MCP server?

You don't need an MCP server to give your agent Intelliprint. Jentic connects it directly from the API Directory: import it, store your API key once, and your agent calls it. The agent finds the print job or mailing list operation it needs on demand, without a server's tool definitions sitting in its context.

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

Yes. For a tracking agent, write a rule that allows only GET /prints and GET /prints/{id}. The agent can list jobs and check each letter's status, but it cannot create, confirm, or cancel anything, and every call it makes is logged. Keep in mind that testmode and confirmed travel in the request body, so a rule that allows POST /prints allows both test and live jobs. To keep a list-maintenance agent on one list, allow the recipient operations under /mailing_lists/{mailing_list}/recipients for that list's id only.

What authentication does the Intelliprint API use?

Per its OpenAPI spec, the Intelliprint API uses HTTP bearer authentication: send your account's API key in the `Authorization` header as `Bearer <key>`. Keys are created in the Intelliprint account dashboard. Through Jentic, the key is stored encrypted by your own Jentic One instance and injected when each call runs.

Can I test Intelliprint print jobs without paying?

Yes. Set testmode to true when creating a print job: per the spec, test mode jobs are not charged and are not sent. A job is only submitted for printing once confirmed is true, and after that it can no longer be updated.

What are the rate limits for the Intelliprint API?

The OpenAPI spec does not specify rate limits; check https://intelliprint.net or contact hello@intelliprint.net for current limits.

Which postage services does the Intelliprint API support?

The postage service field in the spec lists options including uk_second_class, uk_second_class_signed_for, uk_first_class, uk_first_class_signed_for, uk_special_delivery_9am, uk_special_delivery, tracked_24, tracked_48, and international. Postcards can currently only use uk_second_class or uk_first_class.

How do I send a letter with the Intelliprint API through Jentic?

Install Jentic One with `curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh`, import Intelliprint from the API Directory, and store your API key. Your agent searches for 'send a physical letter', gets POST /prints with its input schema, and calls it with type letter, the content, and the recipients, then confirms the job. To run it on your own infrastructure, install Jentic One from its GitHub repo.

Intelliprint API Reference

AI ReadinessFoundational (C+)59/100

See full scorecard

Official vendor OpenAPI document · agent-readyMarketingMarketing Automationbearer20 EndpointsREST

For Agents

Create, confirm, track, and cancel Intelliprint letter and postcard print jobs, and manage the mailing lists, recipients, and backgrounds they use.

Use for: I need to post a letter to a customer's address, Send a postcard to everyone on my Black Friday mailing list, Preview this letter in test mode before it is charged, Confirm print job prt_123 so it goes to print

Not supported: Does not handle email, SMS, address verification as a standalone service, or parcel shipping. Use for printing and posting letters and postcards and managing their mailing lists only.

The Intelliprint API prints and posts physical letters and postcards from code. A print job can be built from text or HTML content, a template, or an uploaded file, and sent to a list of recipients or to a saved mailing list, with control over printing options, postage service, envelope or postcard size, and the mailing date. It also splits a single file of pre-addressed letters into separate mailings, applies reusable letterhead backgrounds, and runs jobs in testmode so nothing is charged or sent until you confirm.

Jentic One on Github View OpenAPI Document

Show dimension breakdown

Foundational Compliance

Base layer of spec validity and structural soundness.

Grade: ASignals: 4

98%

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).

35%

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: A-Signals: 4

39%

Example Density

How richly the API is illustrated with examples.

100%

Example Validity

Percentage of examples that conform to their schemas.

50%

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

70%

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.

69%

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: B-Signals: 1

60%

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

73%

Descriptive Richness

Clarity and depth of descriptions across API elements.

Connect the Intelliprint API Reference to your agent

Capabilities

Start building with Intelliprint API Reference API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs

Intelliprint API Reference

Jentic AI Readiness Score

Intelliprint API Reference

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