Fakto.app — MCP Server for wFirma & Fakturownia
Polska wersja / Polish version → README.pl.md
Fakto.app is a hosted Model Context Protocol (MCP) server that connects AI assistants — Claude, ChatGPT, n8n, Make and any other MCP client — to the two most popular Polish accounting platforms:
- wFirma.pl — 45 MCP tools
- Fakturownia.pl — 37 MCP tools
Issue invoices, look up contractors, analyze finances, check stock levels or forecast cash flow — in plain language, straight from your AI assistant.
> This repository contains documentation, examples and prompts for the hosted service at fakto.app. The server itself is a managed, closed-source service — you don't need to run anything yourself.
Endpoints
| System | Endpoint | Transport |
|---|---|---|
| wFirma | https://fakto.app/wfirma/stream |
HTTP Streamable (JSON-RPC) |
| Fakturownia | https://fakto.app/fakturownia/stream |
HTTP Streamable (JSON-RPC) |
Both support OAuth 2.0 with Dynamic Client Registration (RFC 7591) — Claude and ChatGPT connect without any manual client configuration.
Quick start
1. Create an account
Sign up at fakto.app — there is a free plan (no credit card) — and connect your own wFirma or Fakturownia API keys in the dashboard.
2. Connect your client
Claude (Desktop or claude.ai)
1. Settings → Connectors → Add custom connector
2. URL: https://fakto.app/wfirma/stream (or /fakturownia/stream)
3. Click Connect — you'll be taken through OAuth and asked for your API keys once.
ChatGPT
1. Settings → Connectors → add MCP server
2. Server URL: https://fakto.app/wfirma/stream
3. Discovery URL: https://fakto.app/.well-known/openid-configuration
4. Leave Client ID/Secret empty — ChatGPT registers itself automatically (RFC 7591).
n8n / Make / custom automations
Use a Bearer token generated in the fakto.app dashboard, or pass credentials in a header:POST https://fakto.app/wfirma/stream
Authorization: Bearer <token from dashboard>
Content-Type: application/json
Ready-made n8n workflows are in examples/n8n/ — import the JSON, set your environment variables, done. Step-by-step guides (in Polish):
- Claude quickstart
- ChatGPT quickstart
- n8n quickstart
- Make quickstart
3. Try it
> "Show my 3 latest invoices" · "Create an invoice for ACME Sp. z o.o., consulting services, 5000 PLN net" · "Which invoices are overdue?" · "Summarize my revenue for last month"
Tools
The full, auto-generated list of all 82 tools (invoices, contractors, expenses, warehouse, payments, tax registers/KPiR, financial analytics, forecasting, automation) is in TOOLS.md.
AI accountant prompt
prompts/asystent-ksiegowy-pl.md contains a battle-tested Polish system prompt for an AI accounting agent (n8n AI Agent, Claude Projects, custom GPTs) — Polish VAT rates, tax deadlines, response formats and safety rules included.
Security
- Credentials are encrypted at rest with AES-256-GCM and never logged.
- TLS everywhere; servers hosted in the EU; GDPR-compliant.
- You connect your own wFirma/Fakturownia API keys — data flows directly between the AI client, Fakto.app and your accounting system.
Pricing
Free plan (read-only, 100 requests/month) plus paid plans with invoice creation, warehouse, analytics and forecasting: fakto.app/mcp/pricing.
Support
- Guides (PL): fakto.app/mcp/poradniki
- FAQ: fakto.app/mcp/faq
- Email: contact@elvai.app
License
The contents of this repository (documentation, example workflows, prompts) are released under the MIT License. The Fakto.app service itself is proprietary.
