Docs/MCP Server
MCP Server

Quick Start

receiptconverter-mcp is an official MCP server that gives Claude, Cursor, Windsurf, and any MCP-compatible AI client a native convert_receipt tool — no custom HTTP code required.

1. Install

No installation needed. npx downloads and runs the package automatically when your MCP client starts it.

npx receiptconverter-mcp

Requires Node.js 18 or later. Check with node --version.

2. Get an API key

Sign in at receiptconverter.com, open Dashboard → API Keys, and generate a key. It starts with sk_live_.

Free accounts include API access. Pro plans get 100 conversions/month. See pricing.

3. Add to your MCP client

The config is the same pattern for every client — swap in your API key:

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

See client-specific instructions below for exact file paths.

Client setup guides

Available tools

Once connected, your AI client can call these tools:

convert_receipt(url or file_path)

Parse a receipt or invoice into structured JSON. Returns vendor, date, total, subtotal, tip, currency, payment method, expense category, line items, and taxes.

check_usage((none))

Check remaining conversions and plan limits for the current API key.

4. Test it

Once your client is restarted, try these prompts:

“Parse this receipt: https://example.com/lunch.jpg”
“Scan /Users/me/Downloads/expense.pdf and give me the total and line items”
“How many receipt conversions do I have left this month?”
“Extract all items from this receipt and format them as a markdown table”

What you get back

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