# PHP Point of Sale MCP by usefulapi

> PHP Point of Sale MCP by usefulapi is a freemium MCP server for e-commerce. Hosted MCP connector giving AI assistants read and limited write access to PHP Point. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $9 a month
- **Platforms:** API, Web, vscode, CLI
- **Website:** https://usefulapi.io/php-point-of-sale/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/php-point-of-sale
- **MCP Registry name:** io.usefulapi/php-point-of-sale
- **Categories:** [e-commerce](https://ai-powered.com/categories/e-commerce)
- **Listing updated:** 2026-11-18

## About

The server is hosted by usefulapi and links an AI client to a PHP Point of Sale store through the store's own API. After you sign in with your store name and an API key, the assistant can query items, sales, customers, suppliers, invoices, gift cards and appointments, and run any of the store's 138 built-in reports for a chosen date range and locations.

The tool set is split into 21 read-only calls and 5 that create or change data: new customers and items, edits to existing customers and items, and recorded expenses. The README says write tools should be confirmed by the client before they run. Keys with Read/Write scope are needed for those changes, while a Read key limits the assistant to questions.

It suits store owners and managers who want to ask about stock levels, sales totals or customer balances in plain language. It is an independent service and is not affiliated with PHP Point of Sale.

## Features

- **Plain-language store queries:** Ask about sales, items and customers in ordinary sentences and let the assistant choose the right tool.
- **138 built-in reports:** Run store reports such as sales summaries, top sellers and low inventory for chosen dates and locations.
- **Customer and invoice lookup:** Find customers by email, phone or name and review their sales, invoices and loyalty points.
- **Scoped API key access:** Read-only or Read/Write keys control whether the assistant can change customers, items or expenses.
- **OAuth sign-in:** Clients connect to the URL and sign in through a login page, so no key is placed in the client config.

## Good for

- Check yesterday's sales total and best-selling items
- Find items that have fallen below their reorder level
- Look up a customer's recent sales and account balance
- Review supplier invoices and stock received over a date range
- Record an expense or add a new inventory item from a chat

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http php-point-of-sale https://php-point-of-sale.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://php-point-of-sale.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "php-point-of-sale": {
      "url": "https://php-point-of-sale.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "php-point-of-sale": {
      "type": "http",
      "url": "https://php-point-of-sale.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "php-point-of-sale": {
      "serverUrl": "https://php-point-of-sale.usefulapi.io/mcp"
    }
  }
}
```

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
https://php-point-of-sale.usefulapi.io/mcp
```

Enter a Name (for example "PHP Point of Sale MCP by usefulapi"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "php-point-of-sale": {
      "type": "http",
      "url": "https://php-point-of-sale.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `phppos_list_locations`: List the store's locations (shops/warehouses) with name, address, phone, email, time zone and default tax rates, plus each location's registers (id and name). Use the location ids to filter sales, expenses, customers and reports. Payment-processor credentials and device settings are never returned. GET /locations.
- `phppos_list_items`: List or search inventory items with name, item number, category, supplier, prices and reorder level. Search by text, or by one field (name, item_number, product_id, supplier, tag_name...). GET /items.
- `phppos_get_item`: One inventory item by id: prices, tax settings, category, supplier, tags, attributes, variations, tier pricing and per-location settings. GET /items/{id}.
- `phppos_list_categories`: List item categories with their ids. Use the ids to filter items or to file a new item. GET /categories.
- `phppos_list_item_kits`: List item kits (bundles of items sold together) with their prices. GET /item_kits.
- `phppos_list_sales`: List or search completed sales, by date range, customer (id or email) or location. verbosity: minimal (headline fields), medium (adds customer, totals, profit, location - the default here) or full (every line item, payment and tax). Suspended sales (layaways, estimates) are fetched with suspended_type. GET /sales.
- `phppos_get_sale`: One sale by id with line items, payments, taxes, customer and employee (verbosity full by default). GET /sales/{id}.
- `phppos_list_receivings`: List receivings (stock received from suppliers, purchase orders, transfers) with supplier, totals and items, by date range. GET /receivings.
- `phppos_get_receiving`: One receiving by id: supplier, items, quantities, costs and payments. GET /receivings/{id}.
- `phppos_list_customers`: List or search customers with contact details, tier, store-account balance, credit limit and loyalty points. Search by text or by one field (email, phone_number, first_name, last_name, account_number). GET /customers.
- `phppos_get_customer`: One customer by person id: contact details, tier, tax settings, balance, credit limit, points, notes and custom fields. GET /customers/{person_id}.
- `phppos_list_suppliers`: List or search suppliers with contact details, company, account number and balance. GET /suppliers.
- `phppos_get_supplier`: One supplier by person id. GET /suppliers/{person_id}.
- `phppos_list_employees`: List employees with name, contact details, username, hire date, manager, commission and pay rate settings and assigned locations. Passwords and the permission maps are never returned. GET /employees.
- `phppos_list_invoices`: List customer invoices (money customers owe) or supplier invoices (money the store owes) with date, due date, status and amount. GET /invoices/customer or /invoices/supplier.
- `phppos_list_expenses`: List recorded expenses with type, description, date, amount, tax, payment type, category and location. GET /expenses.
- `phppos_list_gift_cards`: List gift cards with number, description, remaining value, customer and whether inactive. GET /giftcards.
- `phppos_get_gift_card`: One gift card by its card number (or id): remaining value, customer and status. GET /giftcards/{giftcard_number}.
- `phppos_list_appointments`: List appointments (bookings) with customer, employee, service, start and end time, optionally within a time window. GET /appointments.
- `phppos_list_reports`: The catalog of the store's reports (138 of them: sales summaries, top sellers, inventory low/aging/summary, profit and loss, taxes, payments, employee, customer, supplier and store-account reports) with the inputs each accepts. Without `search` only the report keys are returned; with `search` (for example 'inventory' or 'profit') the matching reports are returned with their inputs. GET /reports.
- `phppos_run_report`: Run one of the store's reports and return it (title, summary, detail rows); `paging.next_offset` is set when more detail rows remain. Report keys and their inputs come from phppos_list_reports (for example summary_sales, top_sellers, inventory_low, summary_profit_and_loss, summary_taxes, closeout). Typical inputs go in `params`: start_date, end_date, sale_type, location_ids (array), category_id, s
- `phppos_create_customer`: WRITE: create a customer in the store. Store-account balance, credit limit and loyalty points cannot be set here. Needs a Read/Write API key. Retrying creates a duplicate (check phppos_list_customers first). The store's 'new customer' webhook, if configured, fires. POST /customers.
- `phppos_update_customer`: WRITE: change fields of an existing customer; only the fields you pass are sent. Overwrites the current values. Needs a Read/Write API key. The store's 'edit customer' webhook, if configured, fires. POST /customers/{person_id}.
- `phppos_create_item`: WRITE: create an inventory item (name required). Stock quantities are not set here. Needs a Read/Write API key. Retrying creates a duplicate (search with phppos_list_items first). The store's item webhooks, if configured, fire. POST /items.
- `phppos_update_item`: WRITE: change fields of an existing item (for example its price, category or active state); only the fields you pass are sent. Overwrites the current values, and a price change applies to the next sale. Needs a Read/Write API key. The store's 'edit item' webhook, if configured, fires. POST /items/{item_id}.
- `phppos_create_expense`: WRITE: record an expense in the store's books (description, amount and date). It affects expense and profit-and-loss reports. Needs a Read/Write API key. Retrying records it twice (check phppos_list_expenses first). POST /expenses.

## FAQ

### Is this an official PHP Point of Sale product?

No. usefulapi is an independent service and is not affiliated with or endorsed by PHP Point of Sale.

### Can the AI change my store data?

Yes, through 5 write tools that create or update customers and items and record expenses. The other 21 tools are read-only. Most MCP clients ask for approval before a tool call runs.

### What does it cost?

The Free plan includes 50 tool calls a month. Pro is $9 per month or $90 per year with 10,000 calls, and Pro+ is $39 per month or $390 per year with 100,000 calls. Each paid plan covers this server only.

### Which AI clients can connect?

Any client that supports remote MCP servers over Streamable HTTP with OAuth, including Claude, ChatGPT, Claude Code, Cursor, VS Code and Codex.

### Is PHP Point of Sale MCP by usefulapi free?

PHP Point of Sale MCP by usefulapi has a free plan, with paid plans for more usage or features. Paid plans start at $9 a month.

### How do I add PHP Point of Sale MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http php-point-of-sale https://php-point-of-sale.usefulapi.io/mcp

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Status and tools: checked automatically by AIPoweredBot on 13 November 2026.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Simple Inventory Management](https://ai-powered.com/mcp/simple-inventory-management): Simple Inventory Management is a freemium MCP server for e-commerce.

---
Source: https://ai-powered.com/mcp/php-point-of-sale-mcp-by-usefulapi
