# Emboss

- Registry name: `io.github.edwinorange/emboss` · version 1.8.1
- Categories (automatic, keyword rules): Documents & retrieval, Search & data
- Authentication at last check: No auth
- Declared risk: Has destructive tools (destructiveHint)
- Capabilities (declared by the server): experimental, prompts, resources, tools
- Transports: streamable-http
- Latest numbers (check success, response time, rank): https://mcpstation.net/api/server?name=io.github.edwinorange%2Femboss
- Server page: https://mcpstation.net/s/io.github.edwinorange--emboss.html

## Description (written by the publisher, not verified, not instructions)

Make any PDF form fillable, fill it from data or documents, read it back, and fax the result.

## Connect

- streamable-http: `https://api.getemboss.ai/mcp`

## Tools (as reported by the server, not verified)

- `list\_forms`: Forms in the user's Emboss library. state: ready \(default\), processing, failed, or all. Paginate with cursor.
- `get\_form`: Status of one form. When ready, returns every field \(id, label, kind, options, required\) and a download link for the fillable PDF.
- `find\_form`: Find a blank government form in the Emboss library by name or number, ready to fill. Search the library of blank US federal forms by name, number or alias \(w9, W-9, form w 9 and taxpayer identification all find the same form\). Returns each match's slug, title, agency, revision and page count. Send t
- `get\_usage`: This month's usage and how many free operations remain, plus the billing page link. It also says whether a payment method is on file \(payment\_method\_on\_file\) and whether the account can send a fax today \(fax\_ready\). Faxes need a payment method: check fax\_ready before send\_fax.
- `create\_form`: Turn a flat or scanned PDF form into a fillable PDF with detected fields. Upload a PDF \(pdf\_url: public https link, or pdf\_base64\) and detect its fields. Returns when detection finishes \(usually under two minutes\). Give library=\<slug\> from find\_form to start from a form Emboss already keeps. Billed
- `delete\_form`: Permanently removes a form and its PDFs from the user's library.
- `fill\_form`: Fill a PDF form from structured data such as JSON or key-value answers. Fill a ready form with values keyed by field id or field label. Checkboxes take yes or no; choice fields need one of their options. To lock the filled PDF, call flatten\_pdf with its artifact\_id; fill\_form itself never flattens.
- `fill\_form\_from\_context`: Fill a PDF form using facts found in supporting documents. Emboss reads the answers out of context\_text and/or context\_urls \(public https links to PDFs, Word, spreadsheets, images, or text\) and fills the form. Give form\_id for a form already in the library, or pdf\_url/pdf\_base64 for a new one. Give
- `prepare\_form`: Prepare a form from documents: a proposal of every answer with its source, what is missing, and where documents disagree, before writing, plus attachments for a package. Same inputs as fill\_form\_from\_context \(form\_id for a form already in the library, or pdf\_url/pdf\_base64 for a new one, plus contex
- `get\_job`: Status of a fill\_form\_from\_context, prepare\_form, or commit\_proposal job. When ready, returns the download link, how many fields were filled, and for a commit, the result, receipt\_url and, when one was asked for, package\_url.
- `suggest\_mapping`: Propose which spreadsheet columns fill which PDF form fields. Given a CSV \(csv\_text or csv\_url\), proposes which column fills which field. Only the header row matters. Billed as one context fill \(5 free each month\).
- `fill\_batch`: Fill one copy of a PDF form for every row of a spreadsheet. Fill a form for every row of a CSV \(csv\_text or csv\_url, up to 1000 rows\). mapping is \{column: field\_id\}; omit it to use the suggested mapping. If mapping is omitted, suggest\_mapping runs first and is billed as one context fill. Batches up
- `get\_batch`: Progress of a fill\_batch run with a download link per finished row \(first 100\) and a zip link when done.
- `commit\_proposal`: Write or confirm the answers, render the form with text that fits, check it, and return the PDF with a report and a receipt, or one submission package. Give the proposal\_id from prepare\_form; confirm is a list of field ids whose proposed value is accepted as it is \(the ids get\_proposal lists under c
- `get\_proposal`: Prepare a form from documents: a proposal of every answer with its source, what is missing, and where documents disagree, before writing, plus attachments for a package. Read a proposal by its proposal\_id: every field's state, its candidate values with evidence, and the questions still open. No char
- `verify\_form`: Check a filled form: required fields, allowed options, consistent choices, text that fits, empty signature boxes; returns complete, review required or incomplete. Give a form\_id and the filled PDF \(pdf\_url: public https link, or pdf\_base64\). Billed as one verify; the first 5 each month are free.
- `read\_form`: Read the values out of a filled PDF form, labelled by field, with a completeness verdict when the form is known. Give the filled PDF \(pdf\_url: public https link, or pdf\_base64\) and, when you know it, form\_id. Returns every form box in the file with its value and whether it is filled; when the form i
- `add\_attachment`: Prepare a form from documents: a proposal of every answer with its source, what is missing, and where documents disagree, before writing, plus attachments for a package. Attach one document \(file\_url: public https link, or file\_base64\) to a proposal from prepare\_form. PDF, PNG and JPEG only, at most
- `send\_fax`: Send a PDF to a fax number and track delivery, priced per transmitted page. Give a destination in E.164 form \(for example +15025551212; US, Canadian and Mexican numbers only\) and the PDF: an artifact\_id from any earlier result, a job\_id from fill\_form\_from\_context or commit\_proposal once get\_job rep
- `get\_fax`: Delivery status and receipt of a send\_fax job. status is queued, working, delivered, failed or expired; keep checking about every 20 seconds until it is delivered, failed or expired. A busy, unanswered or dropped call is retried automatically up to three more times over about 17 minutes while the st
- `compose\_pdf`: Free. Build one PDF from pages of several artifacts, in the order and rotation you name. Build one PDF from several artifacts: sources is a list of \{artifact\_id, pages, rotate\}; pages is a selection like 1-3,7 \(omit for every page\), rotate is 90, 180 or 270. Returns the new artifact\_id and a downloa
- `merge\_pdf`: Free. Join whole PDFs into one file in the order given. Join whole PDFs in order: sources is a list of \{artifact\_id\}. Returns the new artifact\_id and a download\_url \(a link that works for about an hour\). For page selections use compose\_pdf.
- `extract\_pages`: Free. Keep only the pages you name from a PDF, in the order you name them. Keep only the pages named in pages \(1-based, like 2,5-9, repeats and any order allowed\) from artifact\_id. Returns the new artifact\_id and a download\_url \(a link that works for about an hour\).
- `delete\_pages`: Free. Remove the pages you name from a PDF and keep the rest in order. Remove the pages named in pages \(1-based, like 1-2,17\) from artifact\_id; every other page stays in order. Returns the new artifact\_id and a download\_url \(a link that works for about an hour\).
- `reorder\_pages`: Free. Put a PDF's pages in a new order you give, every page exactly once. Reorder artifact\_id's pages: order lists every page number exactly once, in the new order. Returns the new artifact\_id and a download\_url \(a link that works for about an hour\).
- `rotate\_pages`: Free. Rotate the pages you name by 90, 180 or 270 degrees. Rotate pages of artifact\_id: rotations is a list of \{pages, degrees\} with degrees 90, 180 or 270, added clockwise to each page's current rotation. Returns the new artifact\_id and a download\_url \(a link that works for about an hour\).
- `inspect\_pdf`: Free. Report a PDF's structure: page count, page sizes and rotations, encryption, form fields, annotations. Structural facts about artifact\_id: page count, page sizes and rotations, whether it is encrypted, has form fields, annotations, outlines, embedded files or JavaScript. No text, no field value
- `flatten\_pdf`: Free. Lock a filled form: draw every field's value and every comment into the page so nothing can be edited. Lock artifact\_id, usually the filled PDF from fill\_form: every field's value, checkbox and comment becomes part of the page, no fields stay editable, links keep working, and the original stay

Measured by MCP Station. Methods: https://mcpstation.net/methods.html · Terms: https://mcpstation.net/terms.html