FastPospal is a Python SDK and MCP Server for automating interactions with the 银豹 (PosPal) POS web backend, enabling AI agents (e.g., Cursor, Claude Desktop) and programs to manage products, members, inventory, stock flows, and sales records.

Session & Authentication

• View current login session details and force re-login

• Check if official PosPal OpenAPI appId/appKey are configured

Product Category Management

• Retrieve the full category tree; create, rename, and batch delete categories

Product Management

• Get product count statistics, paginated product listing, and keyword search

• Fetch product details by ID or barcode

• Create, update, and delete products

Member (Customer) Management

• Look up members by card number or phone; paginated listing with status filtering

• Retrieve supplementary member info (punch cards, benefit cards, gift cards, coupons)

• Create, update, and soft-delete members

Inventory & Stock Management

• Paginated store-wide inventory summary

• View stock change history for a specific product over a time range

• Set min/max stock thresholds for a product

Logistics / Stock Flows

• Paginated stock movement records (purchases, outbound, transfers)

Suppliers

• Retrieve the full supplier list

Sales & Orders

• Paginated sales tickets (valid, voided, returns, member, wholesale)

• Paginated self-operated online shop orders and purchase order records

1. Click on "Install Server".

2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.

3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@FastPospal show me today's product count"

That's it! The server will respond to your query, and you can continue using it as needed.

Here is a step-by-step guide with screenshots.