PHPackages heygeeks/bagisto-mcp - 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. heygeeks/bagisto-mcp ActiveLibrary[API Development](/categories/api) heygeeks/bagisto-mcp ==================== Bagisto MCP Server for LLM Integration 32PHP Since Jan 21Pushed 5mo agoCompare [ Source](https://github.com/HeyGeeks/bagisto-mcp)[ Packagist](https://packagist.org/packages/heygeeks/bagisto-mcp)[ RSS](/packages/heygeeks-bagisto-mcp/feed)WikiDiscussions main Synced today READMEChangelogDependenciesVersions (1)Used By (0) Bagisto MCP Server ================== [](#bagisto-mcp-server) [![Bagisto MCP](src/Resources/assets/images/logo.png)](src/Resources/assets/images/logo.png) [![Status](https://camo.githubusercontent.com/263f3694f42afc27e06a1ff829cd63884893b55624e13a16893dd0a3ba772b94/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7374617475732d6163746976652d737563636573732e737667)](https://github.com/heygeeks/bagisto-mcp/actions) [![Latest Stable Version](https://camo.githubusercontent.com/72a0e2a351ce54cd425c856146817709c7d3ae71da0124e61e0812523e66d14a/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6865796765656b732f6261676973746f2d6d6370)](https://packagist.org/packages/heygeeks/bagisto-mcp) [![License](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667)](https://bgcp.heygeeks.in) Bagisto MCP Server ================== [](#bagisto-mcp-server-1) **Model Context Protocol for Bagisto E-Commerce** A Laravel package that exposes Bagisto e-commerce capabilities to LLMs (Large Language Models) like Claude via the **Model Context Protocol (MCP)**. This enables AI agents to safely interact with your Bagisto store to search products, manage carts, check orders, and more—all controlled via a dedicated Admin Panel. --- 📋 Table of Contents ------------------- [](#-table-of-contents) - [Features](#-features) - [Installation](#-installation) - [Configuration](#-configuration) - [Admin Panel](#-admin-panel) - [Claude Desktop Integration](#-claude-desktop-integration) - [Available Tools](#-available-tools) - [Contributing](#-contributing) --- 🚀 Features ---------- [](#-features) - **Native PHP MCP Server**: Runs directly within your Laravel application using `stdio`. - **Admin Panel Integration**: Enable/Disable tools and manage settings directly from the Bagisto Admin. - **Granular Control**: Toggle individual tools like `products.search` or `customer.profile`. - **Authentication**: Secure sensitive tools with token-based authentication (Sanctum). - **Dual Transport**: Supports both Local Stdio (for Claude Desktop) and HTTP Endpoint methods. --- 📦 Installation -------------- [](#-installation) ### 1. Install via Composer [](#1-install-via-composer) ``` composer require heygeeks/bagisto-mcp ``` ### 2. Publish Assets & Configuration [](#2-publish-assets--configuration) Publish the configuration file and database migrations: ``` php artisan vendor:publish --provider="HeyGeeks\BagistoMCP\MCPServiceProvider" ``` ### 3. Run Migrations [](#3-run-migrations) Create the necessary database tables for tool settings: ``` php artisan migrate ``` ### 4. Clear Caches [](#4-clear-caches) Ensure the new routes and config are loaded: ``` php artisan route:clear php artisan config:clear ``` --- ⚙️ Configuration ---------------- [](#️-configuration) The main configuration file is located at `config/mcp.php`. ``` return [ 'enabled' => true, // Master switch for the MCP server 'endpoint' => 'mcp', // HTTP Endpoint (e.g., yourstore.com/mcp) 'auth' => 'sanctum', // Auth method for protected tools 'tools' => [ // Registered Tool Classes 'products.list' => \HeyGeeks\BagistoMCP\Tools\ProductListTool::class, // ... ], ]; ``` --- 🖥️ Admin Panel -------------- [](#️-admin-panel) Manage your MCP Server directly from the Bagisto Admin Panel. 1. Log in to your **Bagisto Admin**. 2. Navigate to **MCP** in the sidebar. 3. **Dashboard**: View server status and tool statistics. 4. **Settings**: Configure global settings like Rate Limiting and Endpoint URL. 5. **Tools**: Toggle individual tools On/Off and configure their specific settings. > **Note**: If you disable a tool in the Admin Panel, it will immediately become unavailable to connected LLMs. --- 🤖 Claude Desktop Integration ---------------------------- [](#-claude-desktop-integration) To use Bagisto MCP with Claude Desktop, you need to configure it to run the PHP server script. ### 1. Locate the Server Script [](#1-locate-the-server-script) The server script is located at: `packages/heygeeks/bagisto-mcp/bin/server.php`(or inside `vendor/heygeeks/bagisto-mcp/bin/server.php` if installed via vendor) ### 2. Edit Claude Config [](#2-edit-claude-config) Edit your Claude Desktop configuration file: - **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json` - **Windows**: `%APPDATA%\Claude\claude_desktop_config.json` Add the following configuration: ``` { "mcpServers": { "bagisto": { "command": "php", "args": [ "/ABSOLUTE/PATH/TO/YOUR/PROJECT/packages/heygeeks/bagisto-mcp/bin/server.php" ] } } } ``` **Important**: Replace `/ABSOLUTE/PATH/TO/YOUR/PROJECT` with the actual full path to your Laravel project root. ### 3. Restart Claude [](#3-restart-claude) Restart Claude Desktop. You should see the Bagisto tools (e.g., `products_search`, `store_info`) available in the tool picker. --- 🌐 Public Access (HTTP/SSE) -------------------------- [](#-public-access-httpsse) If you need to expose the MCP server to users who cannot use SSH, you can use the **HTTP Endpoint**. This allows clients to connect via Server-Sent Events (SSE). ### Endpoint URL [](#endpoint-url) The default endpoint is: `https://your-store.com/mcp` (You can change the `/mcp` prefix in `config/mcp.php`) ### Client Connection [](#client-connection) To connect standard MCP clients (like Claude Desktop) to the HTTP endpoint, you need a local bridge script because Claude only supports local commands. We provide a Node.js bridge script in `packages/heygeeks/bagisto-mcp/client/`. #### 1. Setup the Client Bridge [](#1-setup-the-client-bridge) ``` cd packages/heygeeks/bagisto-mcp/client npm install ``` #### 2. Configure Claude Desktop [](#2-configure-claude-desktop) Edit your `claude_desktop_config.json`: ``` { "mcpServers": { "bagisto-http": { "command": "node", "args": [ "/ABSOLUTE/PATH/TO/bagisto-mcp/client/remote-client.js", "https://your-store.com/mcp" ] } } } ``` (If you have an auth token, pass it as the second argument: `"args": [..., "https://url...", "YOUR_TOKEN"]`) ### Security Warning [](#security-warning) Warning Exposing the MCP server publicly allows anyone to query your product catalog. - **Authentication**: By default, the endpoint is public but sensitive tools require tokens. - **HTTPS**: Always use HTTPS for the remote URL. --- 🔒 Remote Server Usage (SSH Tunneling) ------------------------------------- [](#-remote-server-usage-ssh-tunneling) For **Admins and Developers**, the recommended secure method is to use **SSH Tunneling**. ### Configuration (Claude Desktop) [](#configuration-claude-desktop) Update your local `claude_desktop_config.json`: ``` { "mcpServers": { "bagisto-ssh": { "command": "ssh", "args": [ "user@your-server.com", "php", "/var/www/html/bagisto/packages/heygeeks/bagisto-mcp/bin/server.php" ] } } } ``` ### Important Notes for SSH [](#important-notes-for-ssh) 1. **User Permissions**: Run as a user with read access to the project. 2. **Encryption**: Traffic is fully encrypted via SSH. --- 🛠️ Available Tools ------------------ [](#️-available-tools) CategoryTool NameDescriptionAuth**Products**`products.list`List products with filtering❌`products.search`Full-text search for products❌`products.detail`Get product details by ID/SKU❌**Categories**`categories.list`List all product categories❌**Customer**`customer.login`Authenticate customer❌`customer.profile`Get customer profile✅**Orders**`orders.status`Check order status❌`orders.history`View order history✅**Cart**`cart.preview`View current cart❌**Store**`store.info`Get store configuration❌**Wishlist**`wishlist.view`View customer wishlist✅--- 🤝 Contributing -------------- [](#-contributing) We welcome contributions! 1. Fork the repository. 2. Create a feature branch. 3. Submit a Pull Request. 📄 License --------- [](#-license) MIT License. See [LICENSE](LICENSE) for details. ### Health Score 19 — LowBetter than 9% of packages Maintenance49 Moderate activity, may be stable Popularity5 Limited adoption so far Community6 Small or concentrated contributor base Maturity13 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. ### Community Maintainers ![](https://avatars.githubusercontent.com/u/82125834?v=4)[Mohit Kumar](/maintainers/mohitky2018)[@mohitky2018](https://github.com/mohitky2018) --- Top Contributors [![mohitky2018](https://avatars.githubusercontent.com/u/82125834?v=4)](https://github.com/mohitky2018 "mohitky2018 (10 commits)") ### Embed Badge ![Health badge](/badges/heygeeks-bagisto-mcp/health.svg) ``` [![Health](https://phpackages.com/badges/heygeeks-bagisto-mcp/health.svg)](https://phpackages.com/packages/heygeeks-bagisto-mcp) ``` ### Alternatives [exsyst/swagger A php library to manipulate Swagger specifications 35916.4M7](/packages/exsyst-swagger)[hubspot/api-client Hubspot API client 24016.2M20](/packages/hubspot-api-client)[pocketmine/bedrock-protocol An implementation of the Minecraft: Bedrock Edition protocol in PHP 172445.0k15](/packages/pocketmine-bedrock-protocol)[botman/driver-telegram Telegram driver for BotMan 93459.5k6](/packages/botman-driver-telegram) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)