# ReceiptsAPI MCP Server

Use ReceiptsAPI directly inside **Claude Desktop** and any MCP-compatible AI client.

Parse receipts, invoices, and documents without leaving your AI assistant.

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

---

## What it does

Gives your AI assistant three tools:

| Tool | Description |
|---|---|
| `parse_receipt` | Extract structured data from a receipt or invoice (merchant, totals, line items, date, payment method) |
| `extract_document` | Extract data from any document — invoice, ID, contract, form. Optionally specify exact fields. |
| `check_usage` | Check your monthly usage and remaining quota |

## Quick Start

### 1. Get a free API key

Sign up at **[receiptsapi.com](https://receiptsapi.com)** — free tier includes 50 docs/month, no credit card needed.

### 2. Install

```bash
pip install mcp httpx
```

### 3. Download the server

```bash
curl -O https://raw.githubusercontent.com/YOUR_USERNAME/receiptsapi-mcp/main/mcp_server.py
```

### 4. Add to Claude Desktop

Edit `~/.config/claude/claude_desktop_config.json` (Mac/Linux) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):

```json
{
  "mcpServers": {
    "receiptsapi": {
      "command": "python",
      "args": ["/path/to/mcp_server.py"],
      "env": {
        "MCP_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}
```

Restart Claude Desktop. You'll see the ReceiptsAPI tools available.

---

## Usage Examples

Once installed, just ask Claude naturally:

> "Parse this receipt: https://example.com/receipt.jpg"

> "Extract the invoice number, vendor name, and total from this PDF: [url]"

> "How many docs have I used this month?"

---

## Use with OpenAI

```python
import openai, requests

# Get the tool schema
tool = requests.get("https://api.receiptsapi.com/v1/tools/openai").json()

client = openai.OpenAI()
response = client.chat.completions.create(
    model="gpt-4o",
    tools=[tool],
    messages=[{"role": "user", "content": "Parse this receipt: https://example.com/receipt.jpg"}]
)
```

## Use with Anthropic

```python
import anthropic, requests

tool = requests.get("https://api.receiptsapi.com/v1/tools/anthropic").json()

client = anthropic.Anthropic()
response = client.messages.create(
    model="claude-opus-4-5",
    tools=[tool],
    messages=[{"role": "user", "content": "Parse this receipt: https://example.com/receipt.jpg"}]
)
```

---

## Direct API

```bash
curl -X POST https://api.receiptsapi.com/v1/parse \
  -H "Authorization: Bearer sk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/receipt.jpg"}'
```

Response:
```json
{
  "status": "completed",
  "elapsed_seconds": 2.8,
  "data": {
    "merchant": { "name": "Walmart", "address": "123 Main St" },
    "transaction": { "date": "2026-03-01", "payment_method": "card" },
    "amounts": { "subtotal": 45.20, "tax": 3.62, "total": 48.82, "currency": "USD" },
    "line_items": [
      { "description": "Milk 2%", "quantity": 2, "unit_price": 3.99, "total": 7.98 }
    ],
    "category": "shopping",
    "confidence": 0.97
  }
}
```

---

## Pricing

| Plan | Price | Docs/month |
|---|---|---|
| Free | $0 | 50 |
| Starter | $9/mo | 500 |
| Growth | $29/mo | 2,000 |
| Pro | $79/mo | 10,000 |
| Business | $199/mo | 50,000 |

[View all plans →](https://receiptsapi.com/#pricing)

---

## Feedback & Support

Found a bug or have a feature request? Open an issue or email **feedback@receiptsapi.com**

We respond fast. We want your feedback.