inFakt MCP Bridge

The recommended way to connect AI assistants to inFakt accounting API - zero configuration bridge for Claude Desktop, Cursor, and VS Code.

Why Use This Bridge?

This npm package provides instant access to the enterprise inFakt MCP Server without requiring Python, Valkey, or complex setup. It's a lightweight TypeScript bridge that connects your MCP client to our production AWS-hosted server with <100ms latency and 99.9% uptime.

Installation

1-minute setup - no Python or dependencies required:

npx -y infakt-mcp-bridge

Quick Start

Add to your MCP client configuration:

{
  "mcpServers": {
    "infakt": {
      "command": "npx",
      "args": ["-y", "infakt-mcp-bridge"],
      "env": {
        "INFAKT_API_KEY": "your-api-key-here"
      }
    }
  }
}

API Key Required: Get your key from infakt.pl

What You Get

Access to 21+ AI-powered tools for natural language interaction with inFakt API:

🤖 Natural Language Queries

Ask questions like:

• "Show me unpaid invoices from last month"
• "What are my top clients by revenue?"
• "List all costs from Q3"

📄 Invoice Operations

• VAT, corrective, and margin invoices
• Processing status tracking
• Automated workflows

📊 Business Intelligence

• Client analytics and management
• Product catalog with smart search
• Cost tracking and categorization
• Bank account monitoring

🔧 Enterprise Features

• Multi-tenant data isolation
• Production-grade performance
• Horizontal scalability
• Real-time synchronization

Supported Clients

Claude Desktop

Config location:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Cursor & VS Code

Configure through MCP extension settings or workspace configuration.

How It Works

Your AI Assistant → Bridge (this package) → AWS MCP Server → inFakt API
                    ↑                        ↑
                   stdio                    HTTP
                  (local)               (authenticated)

The bridge:

1. Receives MCP requests from your AI client via stdio
2. Forwards them to our production server at https://api.infakt.pl/mcp
3. Returns responses with full tool capabilities
4. Handles authentication via X-InFakt-ApiKey header

Comparison with Direct Server Installation

| | NPM Bridge (this) | Direct Python Server | |---|---|---| | Setup time | 1 minute | 5+ minutes | | Dependencies | None | Python, Valkey, pip packages | | Configuration | Automatic | Manual | | Updates | npm update | Manual git pull | | Best for | IDEs, quick start | Custom deployments |

Troubleshooting

Can't see inFakt tools?

# Test the bridge connection
INFAKT_API_KEY="your-key" npx infakt-mcp-bridge --version

Then restart your MCP client and check the logs.

Related Projects

• inFakt API Docs - Official API documentation

License

MIT © inFakt