# Intelliprint — how to use (mcp.ai)

Connect your Intelliprint account and use 21 tools for documents straight from your AI agent. Connect with your own API key. Intelliprint offers a Hybrid Mail API that enables businesses to automate their letter printing and mailing processes, providing features like same-day printing, secure authentication, and real-time tracking.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_intelliprint?ms=1787296020000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `intelliprint_cancel_delete_print_job`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/intelliprint`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/intelliprint/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/intelliprint/cancel/delete/print/job` — Cancel or delete an existing print job by its ID. Unconfirmed jobs are deleted immediately; confirmed jobs (not yet shipped) are cancelled with a refund. Important: Testmode print jobs cannot be cance
  - body: { print_id: string }
- `POST https://api.mcp.ai/api/intelliprint/create/background` — Create a new Background by uploading a PDF file. Backgrounds are used as base layers for print jobs (e.g., letterheads, invoice templates). Use this tool when you need to upload a new background PDF t
  - body: { file: object, name?: string, team?: string }
- `POST https://api.mcp.ai/api/intelliprint/create/mailing/list` — Create a mailing list to store thousands of recipients and send mail items to all of them at once. Use this tool when you need to create a new mailing list for bulk mailings. Recipients can be added i
  - body: { name: string, recipients?: object[], address_validation?: object }
- `POST https://api.mcp.ai/api/intelliprint/create/mailing/list/recipient` — Tool to create a new recipient within a mailing list. Use when you need to add an individual contact who will receive mail campaigns. Recipients must have at minimum an address line; name, postcode, a
  - body: { address: object, variables?: object, mailing_list: string }
- `POST https://api.mcp.ai/api/intelliprint/create/print/job` — Create a new print job in Intelliprint by uploading a document. Use this tool to submit documents for postal mailing. Jobs can be created as drafts (confirmed=False) for review/editing, or confirmed i
  - body: { file: object, metadata?: object, testmode?: boolean, confirmed?: boolean, reference?: string, splitting_method?: string }
- `POST https://api.mcp.ai/api/intelliprint/delete/background` — Tool to delete a background by ID. Use when you need to remove a background that is no longer needed. Fails if any print job has used this background in the last 90 days.
  - body: { background_id: string }
- `POST https://api.mcp.ai/api/intelliprint/delete/mailing/list` — Tool to delete a mailing list along with all the recipients in the mailing list. Use when you need to remove a mailing list permanently.
  - body: { id: string }
- `POST https://api.mcp.ai/api/intelliprint/delete/mailing/list/recipient` — Delete a recipient by ID from a specified mailing list. Use when you need to remove a recipient from a mailing list.
  - body: { id: string, mailing_list: string }
- `POST https://api.mcp.ai/api/intelliprint/get/mailing/list` — Tool to retrieve a single mailing list by its ID. Use when you need details about a specific mailing list including recipients count, address validation status, and dynamic variables.
  - body: { id: string }
- `POST https://api.mcp.ai/api/intelliprint/get/mailing/list/recipient` — Tool to retrieve a single recipient by ID within a specified mailing list. Use when you need details about a specific mailing list recipient.
  - body: { id: string, mailing_list: string }
- `POST https://api.mcp.ai/api/intelliprint/list/backgrounds` — Tool to list backgrounds with optional filtering and pagination. Use after uploading or managing backgrounds to retrieve current entries. Example: 'List backgrounds for team=team_1234 with limit=50 an
  - body: { skip?: integer, team?: string, limit?: integer }
- `POST https://api.mcp.ai/api/intelliprint/list/mailing/list/recipients` — Tool to list all recipients in a mailing list with pagination and sorting options. Use when you need to retrieve recipients from a specific mailing list.
  - body: { skip?: integer, limit?: integer, fields?: string[], sort_field?: string, sort_order?: string, mailing_list: string }
- `POST https://api.mcp.ai/api/intelliprint/list/mailing/lists` — Tool to list all available mailing lists with pagination and sorting options. Use when you need to retrieve mailing lists for print jobs or to view existing lists.
  - body: { skip?: integer, limit?: integer, fields?: string[], sort_field?: string, sort_order?: string }
- `POST https://api.mcp.ai/api/intelliprint/list/print/jobs` — Tool to list print jobs with optional filters and pagination. Use after confirming API key.
  - body: { skip?: integer, limit?: integer, testmode?: boolean, confirmed?: boolean, letters.status?: string }
- `POST https://api.mcp.ai/api/intelliprint/list/templates` — Tool to list all available templates. Use after authenticating API key to browse available templates.
  - body: { skip?: integer, limit?: integer }
- `POST https://api.mcp.ai/api/intelliprint/merge/files` — Merges multiple PDF, RTF, or Word documents into a single PDF file. Use this tool when you need to: - Combine multiple PDF files into one - Merge Word documents (.doc, .docx) into a single PDF - Combi
  - body: { files: object[] }
- `POST https://api.mcp.ai/api/intelliprint/retrieve/background` — Tool to retrieve a specific Background by ID. Use when you need background details before further processing.
  - body: { background_id: string }
- `POST https://api.mcp.ai/api/intelliprint/retrieve/print/job` — Tool to retrieve details of a Print Job by its ID. Use when you have a valid print_id and need full job specifications.
  - body: { print_id: string }
- `POST https://api.mcp.ai/api/intelliprint/update/background` — Tool to update an existing Background's name or team. Use when you need to change a background after creation. Example: 'Update background bg_123abc to new name'.
  - body: { name?: string, team?: string, background_id: string }
- `POST https://api.mcp.ai/api/intelliprint/update/mailing/list` — Tool to update a mailing list. Use when you need to update the name, add or replace recipients in bulk, or configure address validation. Can add recipients to existing list or replace all recipients b
  - body: { id: string, name?: string, recipients?: object[], delete_old_recipients?: boolean }
- `POST https://api.mcp.ai/api/intelliprint/update/mailing/list/recipient` — Tool to update an existing recipient in a mailing list by ID. Use when you need to modify recipient address details or custom variables for personalized mailings.
  - body: { id: string, address?: object, variables?: object, mailing_list: string }

## Example prompts
- "What can I do in Intelliprint?"
- "Show me a summary of my Intelliprint account"

## More
- Page: https://mcp.ai/intelliprint
- Agent spec (llms.txt): https://mcp.ai/intelliprint/llms.txt
- Postman collection: https://mcp.ai/intelliprint/postman.json