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
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.
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.
# π³ 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: Invoice Parser MCP
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 |
Plan | Credits/mo | Price |
π Free | 50 (signup) | $0 |
β Basic | 200/mo | $15/mo |
π Pro | 2,000/mo | $99/mo |
Tool | Cost |
| 1 credit |
| 1 credit |
| 1 credit |
| π Free |
| π Free |
| π Free |
| π Free |
Full pricing also available at GET /pricing (no auth required).
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) |
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 |
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 |
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"
}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.
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.
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.
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 |
MIT
This server cannot be deployed
Invoice and receipt extractor: reads PDF and image invoices/receipts with AI, pulling dateβ¦
Turn any PDF into structured JSON via AI + OCR: invoices, bank statements, contracts.
DocForge turns documents into structured data. Upload a PDF, image, or Office file and get fielded JSON back with per-field confidence scores. 95 templates (invoices, receipts, bank statements, ID docs), custom JSON Schema mode, auto-detect, natural-language instructions. Keyless demo tool included. Free 7-day trial.
Turn PDFs, scans and photos into a queryable database. Invoices, CVs, receipts, in bulk.
