{"id":"io.github.edwinorange/emboss","slug":"io-github-edwinorange-emboss","title":"Emboss","description":"Make any PDF form fillable, fill it from data or documents, read it back, and fax the result.","version":"1.10.0","publisher":{"kind":"github","id":"edwinorange","label":"@edwinorange on GitHub","url":"https://github.com/edwinorange"},"website":"https://getemboss.ai/docs/mcp-tools","repository":"https://github.com/GetEmboss-ai/emboss-claude-plugin","remotes":[{"type":"streamable-http","url":"https://api.getemboss.ai/mcp"}],"packages":[],"published":"2026-11-12","updated":"2026-11-12","status":"online","auth":"","latency_ms":1350,"checked":"2026-11-19","uptime":100,"checks":3,"tools":[{"name":"list_forms","title":"List your forms","description":"Forms in the user's Emboss library. state: ready (default), processing, failed, or all. Paginate with cursor.","read_only":true},{"name":"get_form","title":"Get a form and its fields","description":"Status of one form. When ready, returns every field (id, label, kind, options, required) and a download link for the fillable PDF.","read_only":true},{"name":"find_form","title":"Find a blank government form","description":"Find a blank government form in the Emboss library by name or number, ready to fill. Search the Emboss library of blank government forms by name, number, alias or place (w9, W-9, form w 9 and taxpayer identification all find the same form). When a form belongs to a state or country, say so in the query or pass region or country. Leave query empty and pass region, country or category to list every ","read_only":true},{"name":"get_usage","title":"Check free tier and usage","description":"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.","read_only":true},{"name":"create_form","title":"Create a fillable form from a PDF","description":"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 as one form creation; the first 5 each month are free. Optional retention: ephemeral or account_defa","read_only":false},{"name":"delete_form","title":"Delete a form","description":"Permanently removes a form and its PDFs from the user's library. Pass dry_run=true to rehearse this call without doing it: nothing is stored, charged or sent, and no AI is used. The answer says whether the real call would succeed or be refused, what it would cost, and what a rehearsal cannot check.","read_only":false},{"name":"fill_form","title":"Fill a form from values","description":"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. Returns a download link plus any labels that did not match (ask the user about those). Billed as one","read_only":false},{"name":"fill_form_from_context","title":"Fill a form from documents or notes","description":"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 library=<slug> from find_form to start from a form Emboss already keeps. policy is safe (write high ","read_only":false},{"name":"prepare_form","title":"Prepare a form from documents","description":"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 context_text and/or context_urls), but nothing is written into the PDF: read the proposal, answer what is ","read_only":false},{"name":"get_job","title":"Check a context fill job","description":"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.","read_only":true},{"name":"suggest_mapping","title":"Map spreadsheet columns to form fields","description":"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). Pass dry_run=true to rehearse this call without doing it: nothing is stored, charged or sent, and no AI is used. The answer says whether the real call would succeed or be refused, what ","read_only":false},{"name":"fill_batch","title":"Fill the form once per spreadsheet row","description":"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 to 50 rows finish before this returns; larger ones keep running, poll get_batch. Each row is billed ","read_only":false},{"name":"get_batch","title":"Check a batch fill","description":"Progress of a fill_batch run with a download link per finished row (100 at a time; pass next_cursor as cursor for the next 100) and a zip link when done.","read_only":true},{"name":"commit_proposal","title":"Commit a proposal and produce the PDF","description":"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 confirmations); plus any values the agent decided for fields still open (field_id, value, and an opti","read_only":false},{"name":"get_proposal","title":"Read a proposal","description":"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 charge to read it.","read_only":true},{"name":"verify_form","title":"Check a filled form","description":"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. Pass dry_run=true to rehearse this call without doing it: nothing is stored, charged or sent, and no AI","read_only":false},{"name":"read_form","title":"Read a filled form back","description":"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 is recognised, each value also carries its label and whether it was required, plus a completeness ver","read_only":false},{"name":"add_attachment","title":"Attach a document to a proposal","description":"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 20 per proposal. requirement: the name of an entry in the form's attachments_required list to satis","read_only":false},{"name":"send_fax","title":"Send a PDF by fax","description":"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 reports ready, a form_id for the fillable form, or one PDF by pdf_url or pdf_base64, or a sources list ","read_only":false},{"name":"get_fax","title":"Check a fax","description":"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 status stays working; attempts, max_attempts and next_attempt_at say where it is. A failed or expired ","read_only":true},{"name":"compose_pdf","title":"Compose a PDF from artifacts","description":"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 download_url (a link that works for about an hour). Page selections: https://getemboss.ai/docs/artifacts.","read_only":false},{"name":"merge_pdf","title":"Merge PDFs","description":"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.","read_only":false},{"name":"extract_pages","title":"Extract pages","description":"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).","read_only":false},{"name":"delete_pages","title":"Delete pages","description":"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).","read_only":false},{"name":"reorder_pages","title":"Reorder pages","description":"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).","read_only":false},{"name":"rotate_pages","title":"Rotate pages","description":"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).","read_only":false},{"name":"inspect_pdf","title":"Inspect a PDF","description":"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 values.","read_only":true},{"name":"flatten_pdf","title":"Lock a filled form","description":"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 stays as it is. Returns the new artifact_id, a download_url (a link that works for about an hour) and a ","read_only":false}],"server_info":{"icons":[{"mimeType":"image/png","sizes":["512x512"],"src":"https://getemboss.ai/emboss-logo-512.png"}],"name":"Emboss","title":"Emboss","version":"1.10.0","websiteUrl":"https://getemboss.ai"},"category":"productivity","tags":["hr","travel","web-search"],"kind":"remote","source":"registry","submitted":{},"first_party":false,"domain_rank":null,"score":100,"indexable":true,"first_seen":"2026-08-30","stars":0,"badges":[],"sponsor":null,"page":"https://agentsindex.org/agents/io-github-edwinorange-emboss/"}