# Kelnix Receipt MCP

Turn any receipt into structured, accounting-ready JSON or clean Markdown with one API call. AI-powered vision extracts

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add kelnix/kelnix-receipt-mcp

# Browse available tools
npx -y @smithery/cli@latest tool list kelnix/kelnix-receipt-mcp

# Get full schema for a tool
npx -y @smithery/cli@latest tool get kelnix/kelnix-receipt-mcp receipts.upload

# Call a tool
npx -y @smithery/cli@latest tool call kelnix/kelnix-receipt-mcp receipts.upload '{}'
```

## Direct MCP Connection

Endpoint: `https://kelnix-receipt-mcp--kelnix.run.tools`

**Optional config:**
- `receiptApiKey` (query) — Your Kelnix Receipt MCP API key. Get one free at https://receipt-mcp-api.kelnix.org/docs

## Tools (7)

- `receipts.upload` — Upload a receipt image or PDF for later processing.
- `receipts.process` — Extract structured expense data from an uploaded receipt using AI vision.
- `receipts.upload_and_process` — Upload and process a receipt in a single call — the fastest way to go from image to structured data.
- `receipts.get_markdown` — Get a clean Markdown-formatted view of a processed receipt.
- `accounting.suggest_gl_account` — Suggest the best General Ledger account code for an expense using AI reasoning.
- `credits.check_balance` — Check your current credit balance and subscription plan.
- `receipts.list` — List your uploaded receipts with their processing status.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get kelnix/kelnix-receipt-mcp <tool-name>
```

## Resources

- `receipt://pricing` — Current pricing for receipt processing credits.
- `receipt://supported-formats` — Supported file formats for receipt upload.

## Prompts (2)

- `process_expense` (receipt_source, company) — Step-by-step guide to process a receipt and get structured expense data.
- `expense_report` (time_period) — Generate an expense report from processed receipts.