kelnix-receipt-mcp-api
Provides a specialized BaseTool subclass to integrate receipt processing into CrewAI multi-agent bookkeeping workflows.
Allows for the ingestion and processing of receipt images provided in JPEG format.
Features a dedicated tool node for building complex expense management agents using the LangGraph framework.
Generates human-readable Markdown summaries of processed receipt data for reports and documentation.
Supports asynchronous receipt processing by leveraging Redis as a task queue for background jobs.
Integrates Stripe for handling credit pack purchases and managing monthly service subscriptions.
Offers an interactive Swagger-based interface for exploring API endpoints and testing receipt processing tools.
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"}'Related MCP server: Doc Agent
💰 Pricing
Credit Packs
Credits | Price | Per credit |
100 | $5 | $0.050 |
500 | $20 | $0.040 |
1,000 | $40 | $0.040 |
5,000 | $150 | $0.030 |
10,000 | $300 | $0.030 |
📅 Subscriptions
Plan | Credits/mo | Price |
🆓 Free | 50 (signup) | $0 |
⭐ Basic | 200/mo | $15/mo |
🚀 Pro | 2,000/mo | $99/mo |
🔧 Tool Costs
Tool | Cost |
| 1 credit |
| 1 credit |
| 1 credit |
| 🆓 Free |
| 🆓 Free |
| 🆓 Free |
| 🆓 Free |
Full pricing also available at GET /pricing (no auth required).
📖 API Reference
🔧 Tools
Method | Endpoint | Cost | Description |
POST |
| Free | Upload receipt image/PDF |
POST |
| 1 credit | Extract structured data |
POST |
| 1 credit | Upload + process in one call (idempotent) |
POST |
| Free | Get processed receipt as Markdown |
POST |
| 1 credit | AI-suggest GL account code |
POST |
| Free | Check credits and plan |
POST |
| Free | List receipts with filters |
POST |
| 1 credit | Queue async processing (requires Redis) |
💳 Billing
Method | Endpoint | Description |
POST |
| Buy credit pack (Stripe Checkout) |
POST |
| Subscribe to monthly plan |
POST |
| Buy credits with 300+ cryptocurrencies |
POST |
| Check crypto payment status |
GET |
| Full balance with transaction history |
📡 Discovery & Info
Method | Endpoint | Description |
GET |
| Tool catalogue with schemas, examples, constraints |
GET |
| MCP server discovery metadata |
GET |
| Public pricing (no auth) |
GET |
| Terms of Service |
GET |
| Privacy Policy |
GET |
| Code snippets for LangGraph, CrewAI, AutoGen |
GET |
| Interactive Swagger documentation |
GET |
| Health check |
🔐 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:
Framework | Integration |
🦜 LangGraph | Tool node integration |
🚢 CrewAI | BaseTool subclass |
🤖 AutoGen | Registered function |
🐍 Raw Python | Full flow with httpx |
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 8000Requires Python 3.11+. See deploy/setup.sh for production deployment with nginx, SSL, and systemd.
Variable | Required | Description |
| ✅ Yes | Anthropic API key for Claude vision |
| ❌ No | Stripe secret key for billing |
| ❌ No | Stripe webhook signing secret |
| ❌ No | NOWPayments API key for crypto |
| ❌ No | Redis URL for async processing |
📜 License
MIT
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- FlicenseBquality-maintenanceHeadless document processing for AI agents. Invoice extraction, contract analysis, and Dutch business verification. Pay-per-use via X402 on Solana. No API keys needed.Last updated101
- Alicense-qualityDmaintenanceEnables extraction of structured data from documents like invoices, receipts, and bank statements using local Vision AI (Ollama) or cloud providers (Gemini), with data stored in a local SQLite database.Last updated16MIT
- FlicenseAqualityDmaintenanceExtracts structured JSON data from unstructured text using predefined schemas for receipts, invoices, resumes, and emails. It allows users to transform messy text into organized data through built-in or custom-defined fields.Last updated1
- Alicense-qualityDmaintenanceEnables AI agents to extract structured JSON from invoices and receipts in PDF and image formats using Claude Vision. Supports full document parsing, line item extraction, validation, and batch CSV export with API key or cryptocurrency payment options.Last updatedMIT
Related MCP Connectors
Turn any PDF into structured JSON via AI + OCR: invoices, bank statements, contracts.
Generate professional receipt PDFs and structured receipt data with AI-ready MCP tools.
AU GST/ABN receipt extraction — assigns entertainment/ITC tax codes per line, not just OCR.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/kelnixsolutions/kelnix-receipt-mcp-api'
If you have feedback or need assistance with the MCP directory API, please join our Discord server