AureusERP MCP Plugin

This plugin adds MCP servers to AureusERP so AI clients (MCP Inspector, coding agents, ERP assistants) can use ERP tools securely.

What this plugin provides

Two MCP servers are exposed:

Dev Agent Server

Use the stdio transport for local AI coding agents (Cursor, Claude Code, GitHub Copilot, etc.) via .mcp.json. Use the HTTP transport for remote or OAuth-authenticated clients.

Tools: documentation search, plugin introspection, route discovery, model inspection, Filament resource listing, API resource discovery.

ERP Agent Server

READ-ONLY business insights (34 tools across Sales, Purchases, Invoices, Accounting, Inventory, Projects). No stdio transport — this server requires authentication.

OAuth discovery + registration endpoints are also exposed (via Mcp::oauthRoutes()):

• GET /.well-known/oauth-protected-resource/{path?}
• GET /.well-known/oauth-authorization-server/{path?}
• POST /oauth/register

Requirements

• PHP ^8.2
• Laravel ^11
• Filament ^4
• laravel/mcp ^0.5
• laravel/passport ^13
• AureusERP plugin manager

Install

First, require the package via Composer:

composer require aureuserp/mcp

You can then complete the installation in two ways:

Option 1: Via Command Line

Run:

php artisan mcp:install

This command does the setup automatically:

• publishes CORS config (config/cors.php) if not already published
• publishes MCP OAuth authorization view (mcp-views)
• runs Passport API install scaffold (install:api --passport)
• ensures config/auth.php has MCP API guard/provider
• configures Passport authorization view from the MCP plugin service provider
• clears caches

Option 2: Via Web Plugin Manager

Navigate to the Plugin Manager in your AureusERP admin panel and install the MCP plugin from there.

Plugin install hook

If you install via plugin manager or composer, setup is auto-triggered from the plugin install command.

Transport: streamable-http (HTTP) / stdio (artisan)

Tool catalog

Dev Agent server

Available via stdio (php artisan mcp:dev) and HTTP (POST /mcp/dev).

For developers and coding agents. Always call search_docs first before writing any plugin or feature code.

Tools (7)

• search_docs — Search the official AureusERP developer documentation at devdocs.aureuserp.com
• list_plugins — List all installed plugins with activation status
• plugin_summary — Get plugin details, dependency graph, and installation state
• route_list — List registered routes filtered by plugin, HTTP method, or URI prefix
• filament_resource_list — List Filament resources, pages, and widgets per panel