MCP server

Emboss

io.github.edwinorange/emboss

Checked 25 Oct 2026, 20:29 UTC · Connected to it and listed its tools

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

Website Source

At a glance

Type

MCP server

Publisher

Not verified

Status

Working at last check

Tools

28

Token cost

About 7,020 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

25 Oct 2026, 20:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

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

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.emboss]
url = "https://api.getemboss.ai/mcp"

Gemini CLI

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

Cursor

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

VS Code

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

Antigravity

agy mcp add emboss https://api.getemboss.ai/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"emboss","server_url":"https://api.getemboss.ai/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"emboss","server_url":"https://api.getemboss.ai/mcp"}

Tools

• add_attachment ~341 tokens
  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
• commit_proposal ~512 tokens
  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
• compose_pdf ~226 tokens
  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
• create_form ~349 tokens
  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 Deletes data · ~90 tokens
  Permanently removes a form and its PDFs from the user's library.
• delete_pages Deletes data · ~170 tokens
  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).
• extract_pages ~172 tokens
  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).
• fill_batch ~372 tokens
  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
• fill_form ~318 tokens
  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 ~558 tokens
  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
• find_form ~215 tokens
  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
• flatten_pdf ~278 tokens
  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
• get_batch ~102 tokens
  Progress of a fill_batch run with a download link per finished row (first 100) and a zip link when done.
• get_fax ~215 tokens
  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
• get_form ~108 tokens
  Status of one form. When ready, returns every field (id, label, kind, options, required) and a download link for the fillable PDF.
• get_job ~133 tokens
  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.
• get_proposal ~167 tokens
  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
• get_usage ~117 tokens
  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.
• inspect_pdf ~163 tokens
  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
• list_forms ~135 tokens
  Forms in the user's Emboss library. state: ready (default), processing, failed, or all. Paginate with cursor.
• merge_pdf ~176 tokens
  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.
• prepare_form ~564 tokens
  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
• read_form ~292 tokens
  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
• reorder_pages ~176 tokens
  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 ~205 tokens
  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).
• send_fax Sends messages · ~435 tokens
  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
• suggest_mapping ~205 tokens
  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).
• verify_form ~226 tokens
  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.

Browse

• GitHub tools
• Website monitoring
• PDF tools
• Spreadsheets
• Payments

Related MCP servers

• asksteps
  Turn a fillable PDF into an online form, build funnels, read submissions.
• Pdfops
  Deterministic PDF tools for AI agents: inspect fields, fill forms, merge PDFs, invoices.
• Xenition
  Docs, decks, forms, apps you build and deploy, automations, and AI images, video and voice.
• Blackbook Protocol Advisor
  Purchaser-gated MCP for Vault, HMRC TRS, 95/5 equity, and Companies House PSC.
• Citiview Agent Market
  186 pay-per-call tools: search, LLMs, UK KYB, FRED, Census, maps, crypto. x402 USDC.
• QuintaDB
  No-code databases, forms, portals and AI sites. Manage records and automation via natural language.
• Lovie Company Formation
  Form companies, manage bank accounts, cards, invoices and more — directly from your AI coding tools.
• IndiaInsurances
  Every Indian insurance policy, clause by clause, with verbatim quotes. Free, no API key.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.github.edwinorange/emboss.svg)](https://aptlynx.net/servers/io.github.edwinorange/emboss)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents