🧾 Kelnix Receipt MCP API

Turn any receipt into structured, accounting-ready JSON with one API call. AI vision extracts everything — merchant, date, line items, tax, totals — and suggests GL accounts for instant bookkeeping.

Built for AI agents that automate expense management, accounts payable, and bookkeeping. No dashboard, no login — just an API that speaks MCP.

🎁 50 free credits on signup. No credit card required.

🌐 Live at receipt-mcp-api.kelnix.org — Interactive Docs

📧 Contact: info@kelnix.org | 🔗 kelnix.org

⚡ Quickstart

1️⃣ Register (instant, no approval)

curl -X POST https://receipt-mcp-api.kelnix.org/register_agent \
  -H "Content-Type: application/json" \
  -d '{"agent_name": "my-expense-bot"}'

✅ Returns your API key + 50 free credits.

2️⃣ Process a receipt (1 credit)

curl -X POST https://receipt-mcp-api.kelnix.org/tools/upload_and_process \
  -H "X-API-Key: rct_your-key-here" \
  -F "file=@receipt.jpg" \
  -F "mime_type=image/jpeg"

✅ Returns structured JSON: vendor, date, line items, totals, tax, currency, confidence scores.

3️⃣ Buy more credits when you need them

# 💳 With card (Stripe)
curl -X POST https://receipt-mcp-api.kelnix.org/billing/buy_credits \
  -H "X-API-Key: rct_your-key-here" \
  -H "Content-Type: application/json" \
  -d '{"credits": 1000}'

# 🪙 With crypto (300+ coins)
curl -X POST https://receipt-mcp-api.kelnix.org/billing/buy_credits_crypto \
  -H "X-API-Key: rct_your-key-here" \
  -H "Content-Type: application/json" \
  -d '{"credits": 1000, "preferred_coin": "eth"}'

💰 Pricing

Credit Packs

📅 Subscriptions

🔧 Tool Costs

Full pricing also available at GET /pricing (no auth required).

📖 API Reference

🔧 Tools

💳 Billing

📡 Discovery & Info

🔐 Authentication

All tool and billing endpoints require the X-API-Key header. Get a key via POST /register_agent.

When you run out of credits, paid endpoints return 402 with links to buy more:

{
  "error": "Insufficient credits: 0 available, 1 required.",
  "buy_credits_url": "/billing/buy_credits",
  "buy_credits_crypto_url": "/billing/buy_credits_crypto",
  "pricing_url": "/pricing",
  "cheapest_option": "100 credits for $5.00"
}

🔌 MCP Protocol

Works with Claude Desktop, Cursor, and any MCP-compatible client:

{
  "mcpServers": {
    "kelnix-receipt": {
      "command": "python",
      "args": ["/path/to/mcp_server.py"],
      "env": { "ANTHROPIC_API_KEY": "sk-ant-..." }
    }
  }
}

Also discoverable via /.well-known/mcp.json and listed on Smithery.ai.

🧩 Framework Integrations

GET /integrations returns ready-to-use code for:

See examples/ directory for complete implementations.

🪙 Crypto Payments

Pay with BTC, ETH, SOL, USDC, USDT, DOGE, and 280+ more coins. Credits priced in USD, crypto amount locked at current rate for ~20 minutes.

curl -X POST https://receipt-mcp-api.kelnix.org/billing/buy_credits_crypto \
  -H "X-API-Key: rct_your-key-here" \
  -H "Content-Type: application/json" \
  -d '{"credits": 1000, "preferred_coin": "btc"}'

Returns payment address and exact amount. Credits granted automatically on confirmation.

🛠️ Self-Hosting

git clone https://github.com/kelnixsolutions/Kelnix-Receipt-MCP-API.git
cd Receipt-Accounting-Entry-MCP-Server
pip install -r requirements.txt
export ANTHROPIC_API_KEY=sk-ant-...
uvicorn app:app --host 0.0.0.0 --port 8000

Requires Python 3.11+. See deploy/setup.sh for production deployment with nginx, SSL, and systemd.

📜 License

MIT

Built with ❤️ by Kelnix
_{Powering the next generation of AI expense agents}