Skip to content
MCP server

PHP Point of Sale MCP by usefulapi

Hosted MCP connector giving AI assistants read and limited write access to PHP Point

Install
Pricing
Freemium
Platforms
API, Web, vscode
Runs
Remotely
Version
1.21.1
Listing updated
today

About PHP Point of Sale MCP by usefulapi

PHP Point of Sale MCP by usefulapi is a freemium MCP server for e-commerce. It runs as a hosted remote server, so there is nothing to install locally.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://php-point-of-sale.usefulapi.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "php-point-of-sale": {
      "url": "https://php-point-of-sale.usefulapi.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (26)

Read directly from the server.

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.

What it does

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

Pricing

Freemium, from $9 a month

Free plan with 50 tool calls/month; Pro $9/mo or $90/yr; Pro+ $39/mo or $390/yr.

Prices change. Check usefulapi.io before you buy.

PHP Point of Sale MCP by usefulapi 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

What are the best alternatives to PHP Point of Sale MCP by usefulapi?

The closest alternatives to PHP Point of Sale MCP by usefulapi are O'So MCP Server for PrestaShop, SecureCloud, MadMax Trade Supply parts, Renta and Shopify MCP Server (any store).

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.

How AIPoweredBot checks servers

Alternatives to PHP Point of Sale MCP by usefulapi

  1. Let Claude, ChatGPT or Cursor manage a PrestaShop shop with per-employee permissions

    Not checked yet
    • Remote
    • Open source
    • 2 GitHub stars
    • E-commerce
  2. SecureCloud

    MCP server

    SentinelOne and IT security catalog, prices, quotes and checkout links for Israel

    • 7 tools
    • Remote
    • Free
    • Security
  3. Search replacement filters, alarms and batteries, check fit and build a cart link

    • 7 tools
    • Remote
    • Free
    • E-commerce
  4. Renta

    MCP server

    Remote MCP server for running an outdoor rental shop on Renta from an AI client

    • Remote
    • Paid
    • E-commerce
  5. Hosted MCP server that returns any Shopify store's products, prices and stock

    Not checked yet
    • 4 tools
    • Remote
    • Paid
    • E-commerce
  6. repairinfo

    MCP server

    Repairability scores and spare-parts years for EU appliances and electronics

    • 4 tools
    • Remote
    • Freemium
    • Analytics and data