npm package: @infakt/mcp-bridge
Description: inFakt MCP Bridge - Stdio-to-HTTP bridge for connecting MCP clients to inFakt API v3 via AWS
Author: inFakt
Latest version: 1.0.5

# inFakt MCP Bridge

[![npm version](https://img.shields.io/npm/v/@infakt/mcp-bridge.svg)](https://www.npmjs.com/package/@infakt/mcp-bridge)
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
[![Node.js Version](https://img.shields.io/node/v/@infakt/mcp-bridge.svg)](https://nodejs.org)

**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:

```bash
npx -y infakt-mcp-bridge
```

## Quick Start

Add to your MCP client configuration:

```json
{
  "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](https://www.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?**
```bash
# 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](https://docs.infakt.pl/)** - Official API documentation

## License

MIT © inFakt