PHP Point of Sale MCP by usefulapi
io.usefulapi/php-point-of-sale · v1.5.0 · MCP 2025-06-18
Read PHP Point of Sale items, sales, customers and 138 reports; manage customers, items, expenses.
Reachability
reachable
checked 2026-10-26 05:31 UTC
Registry status active
Tools pinned 26
31b375d5e07e
Tools last changed
unchanged since first capture 2026-10-25
Repo last push 2026-10-26
as of 2026-10-26
GitHub stars 0
as of 2026-10-26
Provenance
Registry namespace io.usefulapi
(domain verified by the official registry)
Repository
github.com/m190/usefulapi-mcp
Remote endpoints
https://php-point-of-sale.usefulapi.io/mcp (streamable-http)
Observed changes
| When (UTC) | Event | Detail |
|---|---|---|
| 2026-10-25 05:30 | first capture | 26 tools pinned |
Pinned tool definitions (26)
| Tool | Description |
|---|---|
| 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.... |
| 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).... |
| 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... |
| 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,... |
| 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'... |
| 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... |
| 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. |
Get alerted when this changes.
Email the moment io.usefulapi/php-point-of-sale drifts, dies, or revives.
Status badge
[](https://toolpin.dev/servers/io.usefulapi/php-point-of-sale)
Maintain this server? Add the badge to your README. It links your users to this live status page.