MCP 服务器

ReceiptsAPI MCP Server

Parse Receipts

README

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.

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

2. Install

pip install mcp httpx

3. Download the server

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

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

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

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

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:

{
  "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
  }
}