Skip to content
MCP server

Emboss

Make PDF forms fillable, fill them from data or documents, then fax the result

Install
Pricing
Freemium
Platforms
API, Web
Runs
Remotely
Version
1.10.0
Listing updated
3 days ago

About Emboss

Emboss is a freemium MCP server for files and documents. It runs as a hosted remote server, so there is nothing to install locally.

Emboss turns a flat PDF into a fillable form, then fills it from supplied values or by reading attached documents. It can verify the result, read a filled form back and send it as a fax, charged per transmitted page.

The server exposes 28 tools under two OAuth scopes: forms:read covers listing and fetching forms, jobs, proposals and faxes, while forms:write covers creating, filling, committing and batch work, plus eight free PDF utilities for merging, extracting, deleting, reordering, rotating, inspecting, composing and flattening pages. Anyone can connect and list tools without signing in; calling them needs sign-in or an API key sent as a bearer token.

There is no subscription. Each account gets 5 free operations of each kind per month on documents up to 5 pages, then billing is in cents per call.

Install

Run in a terminal

claude mcp add --transport http emboss https://api.getemboss.ai/mcp

Add to Settings → Connectors → Add custom connector

https://api.getemboss.ai/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "emboss": {
      "url": "https://api.getemboss.ai/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "emboss": {
      "type": "http",
      "url": "https://api.getemboss.ai/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "emboss": {
      "serverUrl": "https://api.getemboss.ai/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "emboss": {
      "type": "http",
      "url": "https://api.getemboss.ai/mcp"
    }
  }
}

Tools this server provides (28)

Read directly from the server.

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 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
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 as one form creation; the first 5 each month are free. Optional retention: ephemeral or account_defa
delete_form
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.
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. Returns a download link plus any labels that did not match (ask the user about those). Billed as one
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 library=<slug> from find_form to start from a form Emboss already keeps. policy is safe (write high
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 context_text and/or context_urls), but nothing is written into the PDF: read the proposal, answer what is
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). 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
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 to 50 rows finish before this returns; larger ones keep running, poll get_batch. Each row is billed
get_batch
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.
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 confirmations); plus any values the agent decided for fields still open (field_id, value, and an opti
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 charge to read it.
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. Pass dry_run=true to rehearse this call without doing it: nothing is stored, charged or sent, and no AI
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 is recognised, each value also carries its label and whether it was required, plus a completeness ver
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 20 per proposal. requirement: the name of an entry in the form's attachments_required list to satis
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 reports ready, a form_id for the fillable form, or one PDF by pdf_url or pdf_base64, or a sources list
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 status stays working; attempts, max_attempts and next_attempt_at say where it is. A failed or expired
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 download_url (a link that works for about an hour). Page selections: https://getemboss.ai/docs/artifacts.
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 values.
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 stays as it is. Returns the new artifact_id, a download_url (a link that works for about an hour) and a

What it does

Make PDFs fillable
create_form detects fields so a flat PDF becomes fillable.
Fill from documents
fill_form_from_context reads supporting documents to complete fields.
Batch fill
fill_batch fills many forms from spreadsheet rows.
Fax sending
send_fax transmits the result, billed per page.
Free PDF tools
Merge, extract, rotate, flatten and more cost nothing.

Good for

  • Complete a government form from a person's documents
  • Fill hundreds of identical forms from a spreadsheet
  • Check a filled PDF's values before submitting
  • Merge and reorder pages into a submission pack

Pricing

Freemium

Pay per call; 5 free of each operation monthly (documents up to 5 pages)

Prices change. Check getemboss.ai before you buy.

Emboss FAQ

How is it billed?

Per call in cents, with no subscription; each account gets 5 free operations of each kind monthly on short documents.

Do I need to sign in?

Listing tools needs no sign-in; using them requires sign-in or an API key.

Which scopes exist?

forms:read and forms:write; an API key has both.

Is Emboss free?

Emboss has a free plan, with paid plans for more usage or features.

How do I add Emboss to Claude Code?

Run this command in your terminal: claude mcp add --transport http emboss https://api.getemboss.ai/mcp

What are the best alternatives to Emboss?

The closest alternatives to Emboss are ASTra, CARTESIAN ECU, Invoices, SigPen and ConvertAudioToText.

Alternatives to Emboss

  1. ASTra

    MCP server

    Let agents read, edit, validate and undo Word .docx files with exact operations

    Runs locally
    • 5 tools
    • Freemium
    • Files and documents
  2. CARTESIAN ECU

    MCP server

    Check and repair ECU and TCU flash-file checksums from Claude (Ultimate plan)

    Not checked yet
    • 5 tools
    • Remote
    • Paid
    • Files and documents
  3. Invoices

    MCP server

    MCP server that reads supplier invoices and returns data plus DATEV, CSV or Excel files

    • 4 tools
    • Remote
    • Paid
    • Files and documents
  4. SigPen

    MCP server

    MCP server that drafts e-signature documents while you approve every send

    Not checked yet
    • 13 tools
    • Remote
    • Freemium
    • Files and documents
  5. Transcribe audio and video links from Claude or ChatGPT and read the results

    Not checked yet
    • 5 tools
    • Remote
    • Freemium
    • Design and media
  6. WhoScribe

    MCP server

    Search and read your WhoScribe audio and video transcripts from ChatGPT, read-only

    Not checked yet
    • Remote
    • Freemium
    • Design and media