mcp-business-pdf-field-extractor

Business PDF Field Extractor MCP Server

An MCP server for the Mamba Labs Business PDF Field Extractor actor on Apify. Read invoices, purchase orders, and contracts from PDFs as fixed fields.

What's Inside

• What it does
• Quick start
• Prerequisites
• Example prompts
• Tool
• Inputs
• Pricing
• Full actor documentation
• License

What it does

Give PDF addresses. The actor reads each file's text, or runs OCR on scanned pages, works out whether it is an invoice, a purchase order, or a contract, and returns fixed fields. Invoices and purchase orders return numbers, dates, parties, totals, line items, and a check that the amounts add up. Contracts return parties, dates, term, renewal, notice days, governing law, and which standard clauses appear. It uses labels and column position with no AI, so a value with no known label stays null and is listed as missing.

All of the work runs on Apify. This package is a thin client that starts the actor run, waits for it, and hands back the dataset rows.

Quick start

You need Node.js 18 or newer and an Apify account with an API token.

Add this to your Claude Desktop config (claude_desktop_config.json), Cursor, or any MCP client:

{
  "mcpServers": {
    "mamba-business-pdf-field-extractor": {
      "command": "npx",
      "args": [
        "-y",
        "@mambalabsdev/mcp-business-pdf-field-extractor"
      ],
      "env": {
        "APIFY_TOKEN": "your-apify-token"
      }
    }
  }
}

Restart the client. The extract_business_pdf_fields tool appears.

Prerequisites

• Node.js 18 or newer.
• An Apify API token from console.apify.com/account/integrations, set as APIFY_TOKEN. The server lists its tool without a token; a call needs one.

Example prompts

• "Extract the fields from this invoice PDF: "
• "Read these purchase orders and list the line items: "
• "What is the renewal and notice wording in this contract PDF: "

Tool

extract_business_pdf_fields. One tool. Example arguments:

{
  "pdf_urls": [
    "https://docs.oasis-open.org/ubl/cd-UBL-1.0/fs/Order/pdf/OfficeOrder.Example-us.pdf",
    "https://raw.githubusercontent.com/Azure/azure-sdk-for-python/main/sdk/formrecognizer/azure-ai-formrecognizer/samples/sample_forms/forms/Invoice_1.pdf",
    "https://gba.georgia.gov/document/publication/services-contractsample-agreement-templatepdf/download"
  ]
}

Inputs

Every buyer facing input of the actor. Omitted inputs take the actor's own defaults.

Input	Type	Required	Description
pdf_urls	array	no	Web addresses of PDF files, up to 1,000. Each file up to 40 MB. The address must answer without a login. In Clay, put the column in a one item list.
pdf_file	string	no	Optional. One PDF file from your computer, stored in your Apify account.
document_type	string	no	auto (default) works it out per file. Set invoice, purchase_order, or contract to read every file as that type.
date_order	string	no	How to read a date such as 03/04/2025 when both readings are valid. mdy (default) reads March 4, dmy reads 3 April. Unambiguous dates ignore this.
read_scans	boolean	no	yes (default): a page with no text layer goes through OCR, charged per page. no: those pages are skipped and the row says so.
ocr_language	string	no	Language of scanned pages: eng (default), deu, fra, spa, nld, ita, or por.
max_pages	number	no	Pages to read per file, up to 500. Default 50.
max_ocr_pages	number	no	Scanned pages to read per file, up to 100. Default 10. This caps the OCR charge per file.
max_documents	number	no	Files to read in this run, up to 1,000. Default 100.
line_item_rows	boolean	no	yes (default): each line item is also its own free row, which suits CSV and Clay. no: line items stay in the line_items field only.
include_text	boolean	no	yes: add the document text to the row, up to 200,000 characters. Default no.
max_charge_usd	string	no	Optional. The run stops before a charge that would pass this amount. Summary rows are always returned.

Pricing

Pay per event on Apify, billed to your Apify account. Prices in USD.

Event	Free plan	Bronze	Silver	Gold
document-row, one PDF with at least one field read	$0.01	$0.0095	$0.009	$0.0085
ocr-page, one scanned page read by OCR, charged when OCR returned text	$0.015	$0.01425	$0.0135	$0.01275
apify-actor-start, per run start	$0.004	$0.004	$0.004	$0.004

Line item rows, documents with no fields read, failed downloads, and refused input are free. Mamba Labs pays the platform costs of the run, Apify proxy traffic included.

Full actor documentation

apify.com/mambalabs/business-pdf-field-extractor

License

MIT. See LICENSE.