MCP 服务器

receiptconverter-mcp

MCP server for ReceiptConverter that allows AI assistants to parse any receipt or invoice image/PDF into structured JSON with a single tool call.

README

receiptconverter-mcp

MCP server for ReceiptConverter — parse any receipt or invoice into structured JSON with a single tool call.

Connects Claude Desktop, Cursor, Windsurf, and any Model Context Protocol client directly to the ReceiptConverter API. No HTTP setup required — just drop in your API key and your AI assistant can scan receipts natively.

Quick start

1. Get an API key

2. Add to Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "receiptconverter": {
      "command": "npx",
      "args": ["receiptconverter-mcp"],
      "env": {
        "RECEIPTCONVERTER_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}

Restart Claude. You'll see receiptconverter appear in the tools panel.

3. Add to Cursor

Open Cursor Settings → MCP and add:

{
  "receiptconverter": {
    "command": "npx",
    "args": ["receiptconverter-mcp"],
    "env": {
      "RECEIPTCONVERTER_API_KEY": "sk_live_your_key_here"
    }
  }
}

Tools

`convert_receipt`

Parse a receipt or invoice image/PDF into structured JSON.

Parameter	Type	Description
`url`	string	Public URL of a receipt image or PDF
`file_path`	string	Absolute path to a local file
`file_name`	string	Optional filename hint

One of url or file_path is required.

Supported formats: JPG, PNG, WEBP, HEIC, TIFF, BMP, PDF (text-based)

Returns:

{
  "vendor": "Starbucks",
  "date": "2024-03-15",
  "total": 12.50,
  "subtotal": 11.00,
  "tip": 1.50,
  "currency": "USD",
  "payment_method": "Visa",
  "category": "Food & Drink",
  "taxes": [{ "label": "Sales Tax", "rate": 8.875, "amount": 0.98 }],
  "items": [
    { "name": "Oat Latte", "quantity": 1, "unit_price": 6.50, "total_price": 6.50 },
    { "name": "Croissant",  "quantity": 1, "unit_price": 4.50, "total_price": 4.50 }
  ]
}

Example prompts:

"Parse the receipt at https://example.com/receipt.jpg"
"Convert /Users/me/Downloads/expense.pdf to JSON"
"Extract all line items from this receipt and add them to my expense spreadsheet"

`check_usage`

Check your remaining conversions for the current billing period.

No parameters required.

Example — Claude workflow

You: Parse this receipt and add the total to my expenses spreadsheet
     [attaches receipt.jpg]

Claude: I'll use the convert_receipt tool to parse this.

        Vendor:    Whole Foods Market
        Date:      2024-03-20
        Total:     USD 47.83
        Items (6): Organic Milk × 1 @ $5.99 ...
        Category:  Groceries

        I've extracted 6 line items. Want me to format these for your spreadsheet?