PHP Point of Sale MCP by usefulapi
Hosted MCP connector giving AI assistants read and limited write access to PHP Point
- 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/mcpAdd to Settings → Connectors → Add custom connector
https://php-point-of-sale.usefulapi.io/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"php-point-of-sale": {
"url": "https://php-point-of-sale.usefulapi.io/mcp"
}
}
}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.
Alternatives to PHP Point of Sale MCP by usefulapi
O'So MCP Server for PrestaShop
MCP serverLet Claude, ChatGPT or Cursor manage a PrestaShop shop with per-employee permissions
Not checked yet- Remote
- Open source
- 2 GitHub stars
- E-commerce

SecureCloud
MCP serverSentinelOne and IT security catalog, prices, quotes and checkout links for Israel
- 7 tools
- Remote
- Free
- Security

MadMax Trade Supply parts
MCP serverSearch replacement filters, alarms and batteries, check fit and build a cart link
- 7 tools
- Remote
- Free
- E-commerce

Renta
MCP serverRemote MCP server for running an outdoor rental shop on Renta from an AI client
- Remote
- Paid
- E-commerce

Shopify MCP Server (any store)
MCP serverHosted MCP server that returns any Shopify store's products, prices and stock
Not checked yet- 4 tools
- Remote
- Paid
- E-commerce

repairinfo
MCP serverRepairability scores and spare-parts years for EU appliances and electronics
- 4 tools
- Remote
- Freemium
- Analytics and data