PHPackages                             codevenom/fakturownia-bundle - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. codevenom/fakturownia-bundle

ActiveSymfony-bundle[API Development](/categories/api)

codevenom/fakturownia-bundle
============================

Symfony bundle for Fakturownia API with built-in MCP tools

v0.1.1(1mo ago)1169MITPHPPHP >=8.1

Since Apr 30Pushed 1mo agoCompare

[ Source](https://github.com/codevenom-co/fakturownia-bundle)[ Packagist](https://packagist.org/packages/codevenom/fakturownia-bundle)[ RSS](/packages/codevenom-fakturownia-bundle/feed)WikiDiscussions main Synced 1w ago

READMEChangelogDependencies (10)Versions (4)Used By (0)

codevenom/fakturownia-bundle
============================

[](#codevenomfakturownia-bundle)

 [ ![CODEVENOM Fakturownia Bundle - Symfony package with MCP tools](./docs/github-banner.svg) ](https://github.com/codevenom-co/fakturownia-bundle)

Symfony bundle for the Fakturownia API with built-in MCP tools.

What This Gives You
-------------------

[](#what-this-gives-you)

- Fakturownia integration as a standard Symfony service (`InvoiceClient`, `CustomerClient`, `PricingClient`).
- Multi-context architecture (Invoice, Customer, Pricing, Report) for clean domain boundaries.
- Ready-to-use MCP tools that can be exposed to any AI agent through `symfony/mcp-bundle`.
- Built-in financial reporting engine with extensible strategies.
- A single Composer package, without a separate MCP microservice.

Available MCP Tools (v1)
------------------------

[](#available-mcp-tools-v1)

DomainTool NameDescription**Invoices**`codevenom.fakturownia.invoice.add`Create a new invoice in Fakturownia.`codevenom.fakturownia.invoice.find_by_number`Finds an invoice by its number.**Customers**`codevenom.fakturownia.customer.list`Lists all customers from Fakturownia.`codevenom.fakturownia.customer.find_by_id`Finds a customer by their ID.`codevenom.fakturownia.customer.add`Add a new customer to Fakturownia.`codevenom.fakturownia.customer.update`Update an existing customer in Fakturownia.`codevenom.fakturownia.customer.delete`Delete a customer from Fakturownia.**Pricing**`codevenom.fakturownia.pricing.list`Lists all price lists from Fakturownia.`codevenom.fakturownia.pricing.add`Adds a new price list to Fakturownia.`codevenom.fakturownia.pricing.update`Updates an existing price list in Fakturownia.`codevenom.fakturownia.pricing.delete`Deletes a price list from Fakturownia.**Reports**`codevenom.fakturownia.report.get`Generates decision-ready financial reports (health, AR aging, cash forecast, DSO trend, etc.).Requirements
------------

[](#requirements)

- PHP 8.1+
- Symfony 7.3+ or 8.x
- `symfony/mcp-bundle` (required)

Installation
------------

[](#installation)

```
composer require codevenom/fakturownia-bundle symfony/mcp-bundle
```

Symfony Configuration
---------------------

[](#symfony-configuration)

`config/packages/codevenom_fakturownia.yaml`

```
codevenom_fakturownia:
  base_url: '%env(FAKTUROWNIA_BASE_URL)%' # e.g. https://your-subdomain.fakturownia.pl
  api_token: '%env(FAKTUROWNIA_API_TOKEN)%'
  seller_name: 'Your Company Name'
  seller_tax_id: 'PL1234567890'
  timeout: 15
```

`.env`

```
FAKTUROWNIA_BASE_URL=https://your-subdomain.fakturownia.pl
FAKTUROWNIA_API_TOKEN=your_api_token
```

`config/routes.yaml`

```
mcp:
  resource: .
  type: mcp
```

`config/packages/mcp.yaml`

```
mcp:
  app: 'CHANGE_ME'
  version: '1.0.0'
  description: '....'
  client_transports:
    stdio: true
    http: true
```

Run MCP Server (stdio)
----------------------

[](#run-mcp-server-stdio)

```
php bin/console mcp:server
```

This is the command you register as an MCP server in the client (e.g. Codex/VS Code).

Example MCP Client Configuration (STDIO)
----------------------------------------

[](#example-mcp-client-configuration-stdio)

```
{
  "mcpServers": {
    "codevenom-fakturownia": {
      "command": "php",
      "args": ["/abs/path/to/project/bin/console", "mcp:server"],
      "env": {
        "APP_ENV": "prod",
        "FAKTUROWNIA_BASE_URL": "https://your-subdomain.fakturownia.pl",
        "FAKTUROWNIA_API_TOKEN": "***"
      }
    }
  }
}
```

Note About MCP Capability Auto-Discovery
----------------------------------------

[](#note-about-mcp-capability-auto-discovery)

`symfony/mcp-bundle` discovers capabilities via attributes (`#[McpTool]`). In most setups, it is enough that the attributed service is loaded by the container.

If vendor capabilities are not automatically discovered in your app, ensure that the bundle services are correctly imported in your `services.yaml`:

```
imports:
    - { resource: '@CodevenomFakturowniaBundle/Resources/config/services.yaml' }
```

Product Strategy
----------------

[](#product-strategy)

This package is both a library and MCP integration:

- as a library: you can use `FakturowniaClient` without AI,
- as MCP: you expose the same use cases to AI agents through the MCP standard.

This lets you deploy the bundle in SHARDN while also publishing it as a public CODEVENOM OSS package.

Development
-----------

[](#development)

If you have Docker and [Task](https://taskfile.dev/) installed, you can easily run tests and tools:

```
task install
task test
task cs-fix
task verify-recipes
```

Recipe Verification
-------------------

[](#recipe-verification)

To verify that the bundle and its recipes work correctly across different PHP and Symfony versions (similar to the QA pipelines in `symfony/recipes-contrib`), you can use the provided verification script:

```
./scripts/verify-recipes.sh 8.2 7
./scripts/verify-recipes.sh 8.4 7
./scripts/verify-recipes.sh 8.4 8
```

Note: This bundle requires Symfony 7.3+ to support MCP features.

Or via Task:

```
task verify-recipes
```

This requires Docker to be installed on your machine.

###  Health Score

39

—

LowBetter than 84% of packages

Maintenance92

Actively maintained with recent releases

Popularity17

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity34

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

40d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/4d4462ebdb62f04adfb50394a453b3ebcf51af9158be72ef0e9fafecbdbb6a6a?d=identicon)[levan-cdv](/maintainers/levan-cdv)

---

Top Contributors

[![levan-cdv](https://avatars.githubusercontent.com/u/262112285?v=4)](https://github.com/levan-cdv "levan-cdv (8 commits)")

---

Tags

accountingai-agentai-toolsapiautomationbundleclaudecodevenomcodexcursorfakturowniaintegrationinvoicingmcpmodel-context-protocolossphpsymfony

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/codevenom-fakturownia-bundle/health.svg)

```
[![Health](https://phpackages.com/badges/codevenom-fakturownia-bundle/health.svg)](https://phpackages.com/packages/codevenom-fakturownia-bundle)
```

###  Alternatives

[rcsofttech/audit-trail-bundle

Enterprise-grade, high-performance Symfony audit trail bundle. Automatically track Doctrine entity changes with split-phase architecture, multiple transports (HTTP, Queue, Doctrine), and sensitive data masking.

1155.2k](/packages/rcsofttech-audit-trail-bundle)[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.5k5.8M710](/packages/sylius-sylius)[sulu/sulu

Core framework that implements the functionality of the Sulu content management system

1.3k1.4M195](/packages/sulu-sulu)[kimai/kimai

Kimai - Time Tracking

4.7k8.7k1](/packages/kimai-kimai)[web-auth/webauthn-framework

FIDO2/Webauthn library for PHP and Symfony Bundle.

51090.8k2](/packages/web-auth-webauthn-framework)[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

585.4M506](/packages/shopware-core)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)