README

A Laravel SDK for the Minimax accounting API (SI / HR / RS). It handles OAuth2 auth and token caching, and wraps issued invoices, orders, customers, items and the code lists behind a small fluent API.

• Zero-config auth — OAuth2 password grant with automatic, leeway-aware token caching.
• Fake mode — canned fixtures so the SDK and admin UI run end-to-end before your credentials arrive.
• Fluent resources — typed CRUD helpers plus a generic escape hatch for any endpoint.
• Local admin UI — dashboard, live diagnostics and a resource browser (local env only).
• MCP server — read the API from AI coding agents (Laravel Boost, Claude, Codex).

Requirements

• PHP 8.4+
• Laravel 13

Install

composer require nejcc/minimax-sdk
php artisan vendor:publish --tag=minimax-config

Add your credentials to .env:

MINIMAX_LOCALIZATION=SI
MINIMAX_CLIENT_ID=...
MINIMAX_CLIENT_SECRET=...
MINIMAX_USERNAME=...
MINIMAX_PASSWORD=...
MINIMAX_ORG_ID=123456

No credentials yet? Set MINIMAX_FAKE=true and everything runs off canned fixtures. See the Configuration wiki for every option.

Usage

use Nejcc\Minimax\Facades\Minimax;

// which orgs can this user see
$orgs = Minimax::orgs()->all();

// customers in the default org
$customers = Minimax::customers()->all()['Rows'];

// switch org for one chain
Minimax::forOrg(654321)->items()->all();

// resolve a VAT rate by its code
$vat = Minimax::vatRates()->byCode('S');

// create a draft invoice, issue it, grab the PDF
$invoice = Minimax::invoices()->create([...]);
$pdf = Minimax::invoices()->pdf($invoice['IssuedInvoiceId'], $invoice['RowVersion']);

Every resource shares the same CRUD surface: all(), find(), byCode(), create(), update(), delete(). Endpoints without a dedicated class are reachable through Minimax::resource('journals')->all(). Full details in the Usage and Invoices wiki pages.

Admin UI

In the local environment the package mounts a small dashboard at /admin/minimax — config status, live diagnostics and a resource browser. Handy for checking your setup before wiring the SDK into anything.

MCP (AI coding agents)

If laravel/mcp is installed, the package registers a local MCP server named minimax with three read-only tools: list-organisations, list-resource and find-record. Point your AI coding agent — the MCP client (Claude Code, Codex, Cursor …) — at it:

php artisan mcp:start minimax

Laravel Boost? Boost is a separate MCP server (its own dev tools), not a client, so it won't absorb these tools. Run the two side by side — add both to your agent's config and it sees both toolsets.

Example client config (.mcp.json / Claude Code) — minimax runs alongside any other MCP servers, such as Boost:

{
  "mcpServers": {
    "boost":   { "command": "php", "args": ["artisan", "boost:mcp"] },
    "minimax": { "command": "php", "args": ["artisan", "mcp:start", "minimax"] }
  }
}

Pair it with MINIMAX_FAKE=true to let an agent explore the API shape with no credentials. To also expose the server over HTTP, publish and edit the routes: php artisan vendor:publish --tag=minimax-ai-routes. More in the MCP wiki.

Documentation

• Wiki — https://github.com/Nejcc/minimax-sdk/wiki
• Offline — open docs/index.html in a browser for the full reference.

Testing

composer test

Changelog

See CHANGELOG.md for release notes.

Contributing

See CONTRIBUTING.md, and ask questions in Discussions.

Security

Please report vulnerabilities privately — see SECURITY.md.

License

MIT. See LICENSE.