Merchant360 MCP by usefulapi
io.usefulapi/merchant360 · v1.2.0 · MCP 2025-11-25
Read shifts and requests; create, change, publish and delete shifts; decide requests in Merchant360.
Reachability
reachable
checked 2026-11-21 05:33 UTC
Registry status active
Tools pinned 42
7c7b5d98f287
Tools last changed
unchanged since first capture 2026-11-19
Repo last push 2026-11-21
as of 2026-11-21
GitHub stars 1
as of 2026-11-21
Provenance
Registry namespace io.usefulapi
(domain verified by the official registry)
Repository
github.com/m190/usefulapi-mcp
Remote endpoints
https://merchant360.usefulapi.io/mcp (streamable-http)
Observed changes
| When (UTC) | Event | Detail |
|---|---|---|
| 2026-11-19 05:30 | first capture | 42 tools pinned |
Pinned tool definitions (42)
| Tool | Description |
|---|---|
| merchant360_check_key | Show the merchant the API key acts on, the key's name, its scopes and whether it is live or test. Use it first to confirm the connection. Merchant360 API: GET /me. |
| merchant360_list_staff | List the staff roster (name, title, sort order, whether the person has a login). This list is read-only and not paginated. Shift workers use the roster key from merchant360_list_shifts. Merchant360 API: GET /staff. |
| merchant360_list_shifts | List team shifts that start in a window, draft and published, earliest first, with the roster of people who can be scheduled (roster[].key is the worker_key to use when writing a shift). Not paginated. The default window starts at... |
| merchant360_get_shift | Get one shift by id: worker, start and end, unpaid break, role, note, and whether it is a draft or published. Merchant360 API: GET /shifts/{id}. |
| merchant360_list_schedule_requests | List staff time-off requests and shift trade requests (drop, pickup, handoff), newest first. Filter by status when set. Not paginated. Old requests are left out by the vendor. Merchant360 API: GET /schedule-requests. |
| merchant360_create_shift | WRITE: create a DRAFT shift. Staff do not see it and no text is sent until merchant360_publish_shifts publishes its window. Omit worker_key for an open shift. A shift lasts at most 24 hours. Merchant360 API: POST /shifts. |
| merchant360_update_shift | WRITE: change one shift. Fields you omit keep their value. Send worker_key null to make the shift open, and role or note null (or empty) to clear them. A published shift shows the change to staff only after merchant360_publish_shifts... |
| merchant360_delete_shift | WRITE: permanently delete one shift, draft or published. No text is sent. A deleted published shift leaves the staff schedule at the next publish. Merchant360 API: DELETE /shifts/{id}. |
| merchant360_publish_shifts | WRITE: publish every DRAFT shift that starts in the window, so staff can see it. Each worker with a published shift and a mobile number gets a text with a link to their schedule. Publishing an already-published window publishes nothing... |
| merchant360_decide_schedule_request | WRITE: approve or deny one staff time-off or shift trade request. The worker is texted the outcome, with the note when given. Approved time off also blocks those days on the public booking calendar. A decided request returns 409.... |
| merchant360_list_payments | List the merchant's card payments, newest first (keyed/online by default; channel card_present lists card-reader sales). Read-only: no tool here charges or refunds. Scope payments:read. Merchant360 API: GET /payments. |
| merchant360_get_payment | Get one payment by id (a keyed payment uuid or a card-present tp_ id), with its status and processor result. Scope payments:read. Merchant360 API: GET /payments/{id}. |
| merchant360_list_invoices | List invoices (not estimates), newest first, optionally by status. Scope invoices:read. Merchant360 API: GET /invoices. |
| merchant360_get_invoice | Get one invoice or estimate by id, with its lines, totals, balance and status. Scope invoices:read. Merchant360 API: GET /invoices/{id}. |
| merchant360_list_estimates | List estimates, newest first, optionally by status. Get one with merchant360_get_invoice. Scope estimates:read. Merchant360 API: GET /estimates. |
| merchant360_list_customers | List customers, newest first. search matches name, legal name or email (any part), or 3+ digits of the phone. Scope customers:read. Merchant360 API: GET /customers. |
| merchant360_get_customer | Get one customer. Scope customers:read. Merchant360 API: GET /customers/{id}. |
| merchant360_list_catalog | List active products and services, sorted by name (price and cost in cents, stock when tracked). Scope inventory:read. Merchant360 API: GET /catalog. |
| merchant360_get_catalog_item | Get one catalog item. Scope inventory:read. Merchant360 API: GET /catalog/{id}. |
| merchant360_list_subscriptions | List every subscription (recurring billing), including the open bill of invoice subscriptions. Not paginated. Scope recurring:read. Merchant360 API: GET /subscriptions. |
| merchant360_get_subscription | Get one subscription with its schedule and open bill. Scope recurring:read. Merchant360 API: GET /subscriptions/{id}. |
| merchant360_list_plans | List up to 200 subscription plans, newest first. Scope recurring:read. Merchant360 API: GET /plans. |
| merchant360_list_appointments | List appointments, oldest start first, optionally between two start times. Scope scheduling:read. Merchant360 API: GET /appointments. |
| merchant360_get_appointment | Get one appointment. Scope scheduling:read. Merchant360 API: GET /appointments/{id}. |
| merchant360_list_reservations | List reservations, newest first, optionally by status. Pass next_cursor from the previous page as cursor. Scope reservations:read. Merchant360 API: GET /reservations. |
| merchant360_get_reservation | Get one reservation with its holds, claims and recent events. Scope reservations:read. Merchant360 API: GET /reservations/{id}. |
| merchant360_list_classes | List classes, newest first; active true or false filters. Scope scheduling:read. Merchant360 API: GET /classes. |
| merchant360_list_class_sessions | List class sessions with seats left, earliest first (includes canceled sessions), optionally for one class and a time window. Scope scheduling:read. Merchant360 API: GET /class-sessions. |
| merchant360_list_session_bookings | List every booking on one class session (confirmed, waitlist, canceled). Scope scheduling:read. Merchant360 API: GET /class-sessions/{id}/bookings. |
| merchant360_list_credit_memos | List credit memos, newest first. Scope credit_memos:read. Merchant360 API: GET /credit-memos. |
| merchant360_list_statements | List the months that have a processing statement, newest first. Scope statements:read. Merchant360 API: GET /statements. |
| merchant360_list_tax_rates | List the merchant's tax rates (default first). Use an id as tax.rate_id on an invoice or estimate. Scope tax_rates:read. Merchant360 API: GET /tax-rates. |
| merchant360_list_payment_links | List payment links, newest first, including links made for invoices. Scope payment_links:read. Merchant360 API: GET /payment-links. |
| merchant360_create_customer | Create a customer (name required). Scope customers:write. Merchant360 API: POST /customers. |
| merchant360_update_customer | Change the fields you send; fields left out keep their value. null clears legal_name, email or phone. Scope customers:write. Merchant360 API: PATCH /customers/{id}. |
| merchant360_create_invoice | Create an invoice in DRAFT status from lines (unit_price in cents), with automatic or chosen tax and an optional discount. It charges nothing. send: true emails it to customer.email and moves it to OPEN with a pay link (the customer... |
| merchant360_create_estimate | Create an estimate in DRAFT status from lines (unit_price in cents), with automatic or chosen tax and an optional discount. It charges nothing. send: true emails it to customer.email and moves it to OPEN, where the customer can accept... |
| merchant360_send_invoice | Email an invoice or estimate with its PDF and a pay link for the remaining balance to the customer's email (and text the link when Text2Pay is on). It charges nothing; the customer pays on the hosted page. Scope invoices:write.... |
| merchant360_create_catalog_item | Create a product or service (price in cents). A SKU is generated from the name when left out. Scope inventory:write. Merchant360 API: POST /catalog. |
| merchant360_update_catalog_item | Change name, sku, category, description, price, cost, taxable or track_stock; fields left out keep their value. Stock on hand does not change here. Scope inventory:write. Merchant360 API: PATCH /catalog/{id}. |
| merchant360_create_appointment | Create an appointment (status scheduled). Merchant360 refuses a time that clashes with the assignee's open appointments. It sends no email or text. Scope scheduling:write. Merchant360 API: POST /appointments. |
| merchant360_update_appointment_status | Set an appointment's status (scheduled, confirmed, arrived, in_progress, completed, canceled, no_show). Status is the only field this changes; no email or text is sent. Scope scheduling:write. Merchant360 API: PATCH /appointments/{id}. |
Get alerted when this changes.
Email the moment io.usefulapi/merchant360 drifts, dies, or revives.
Status badge
[](https://toolpin.dev/servers/io.usefulapi/merchant360)
Maintain this server? Add the badge to your README. It links your users to this live status page.