mcpField
A
Apapyr

Apapyr

Local
github.com/AkilaJFinance0Updated 31w ago
Repository

About Apapyr

Apapyr is an MCP server for extracting structured data from invoices, receipts, tax forms, bank statements, and contracts. It serves AI assistants that need document fields with confidence scores, and also provides tools to retrieve past extractions and check usage.

Key features

  1. 01Extract data from PDFs and images
  2. 02Support invoices, receipts, W-2s, statements, contracts
  3. 03Retrieve previous extraction results
  4. 04List recent extractions and schemas
  5. 05Check plan usage and limits

Use cases

  1. 01Extract totals and line items from invoices
  2. 02Parse receipt amounts and payment details
  3. 03Read wages from W-2 forms
  4. 04Review balances and transactions in statements

MCP support

The MCP server exposes document extraction and account tools to compatible AI clients. Tools include extraction, retrieval, listing schemas, and checking usage.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "apapyr": {
      "command": "npx",
      "args": [
        "-y",
        "apapyr-mcp-server"
      ],
      "env": {
        "APAPYR_API_KEY": "<APAPYR_API_KEY>"
      }
    }
  }
}
Run commandnpx -y apapyr-mcp-server
Environment variables to set
APAPYR_API_KEYSecret

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmapapyr-mcp-server

Tools

5

Saved tool list · updated 3w ago

ParameterTypeRequiredDescription
file_pathstringYesAbsolute or relative path to the document file (PDF, PNG, JPG, or WEBP)
document_typeenumNoType of document. Use 'auto' to detect automatically. Default: autoauto | invoice | receipt | w2 | bank_statement | contract

Details

From the project README

aPapyr MCP Server

Extract structured data from documents using AI agents. This MCP server lets Claude Code, Cursor, Windsurf, and any MCP-compatible AI assistant natively extract data from invoices, receipts, tax forms, bank statements, and contracts.

Quick Setup

1. Get an API Key

Sign up at apapyr.com (free tier: 50 pages/month).

2. Add to Claude Code
claude mcp add apapyr -- npx @apapyr/mcp-server

Then set your API key:

export APAPYR_API_KEY=sk_live_your_key
3. Add to Cursor / VS Code

Add to your MCP settings (.cursor/mcp.json or VS Code MCP config):

{
  "mcpServers": {
    "apapyr": {
      "command": "npx",
      "args": ["@apapyr/mcp-server"],
      "env": {
        "APAPYR_API_KEY": "sk_live_your_key"
      }
    }
  }
}

What You Can Do

Once connected, just ask your AI assistant naturally:

  • "Extract the data from invoice.pdf"
  • "Parse this receipt and give me the total"
  • "What fields can you extract from a W-2?"
  • "How many pages have I used this month?"

Available Tools

ToolDescription
extract_documentExtract structured data from a PDF or image
get_extractionGet a previous extraction result by ID
list_extractionsList recent extractions
get_usageCheck current plan usage and limits
list_document_schemasSee supported document types and fields

Supported Documents

  • Invoices — vendor, total, tax, due date, line items
  • Receipts — merchant, total, tax, tip, payment method
  • W-2 Tax Forms — employer, wages, withholdings
  • Bank Statements — balances, transactions
  • Contracts — parties, dates, key terms

Links

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.