# 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](https://apapyr.com/dashboard.html) (free tier: 50 pages/month).

### 2. Add to Claude Code

```bash
claude mcp add apapyr -- npx @apapyr/mcp-server
```

Then set your API key:

```bash
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):

```json
{
  "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

| Tool | Description |
|------|-------------|
| `extract_document` | Extract structured data from a PDF or image |
| `get_extraction` | Get a previous extraction result by ID |
| `list_extractions` | List recent extractions |
| `get_usage` | Check current plan usage and limits |
| `list_document_schemas` | See 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

- [Website](https://apapyr.com)
- [API Docs](https://apapyr.com/docs.html)
- [Dashboard](https://apapyr.com/dashboard.html)
- [Free Tool](https://apapyr.com/free-tool.html)