One Stop: Payments, cart and favourites MCP tools
Service overview · CLI reference · All MCP tools · Data types
Payments, cart and favourites
Payment tools prepare a link to the native gateway; they do not complete a payment. Checkout preparation and submission are separate operations, and submission requires host confirmation. Saved-cart loading appends items, while replacement replaces the current cart.
onestop_list_payment_services
Search/browse services in the student's native payment directory, preserving its active/category/access filter. Use leading * for substring search. Does not create a payment or charge anything.
Inputs
| Field | Type | Required | Details |
|---|---|---|---|
query |
string |
No | maximum length: 100; default: "" |
limit |
integer |
No | minimum: 1; maximum: 100; default: 20 |
offset |
integer |
No | minimum: 0; default: 0 |
Output
| Field | Type | Required | Details |
|---|---|---|---|
offset |
integer |
Yes | minimum: 0 |
available_count |
integer |
Yes | minimum: 0 |
total_count |
integer or null |
Yes | minimum: 0 |
complete |
boolean |
Yes | — |
next_offset |
integer or null |
Yes | minimum: 0 |
retrieved_at |
string |
Yes | format: date-time |
source_url |
string |
Yes | — |
cached |
boolean |
Yes | — |
records |
array of PortalRecord |
Yes | — |
Unknown fields are not accepted.
onestop_get_payment_service
Read a visible payment service's native fixed-amount information. The ID must appear in your payment directory. Variable amounts are completed at the separate payment gateway.
Inputs
| Field | Type | Required | Details |
|---|---|---|---|
service_id |
string |
Yes | pattern: ^[0-9a-f]{32}$ |
Output
| Field | Type | Required | Details |
|---|---|---|---|
retrieved_at |
string |
Yes | format: date-time |
source_url |
string |
Yes | — |
cached |
boolean |
Yes | — |
service_id |
string |
Yes | — |
title |
string |
Yes | — |
fixed_amount |
string or null |
Yes | — |
Unknown fields are not accepted.
onestop_get_cart
Read your native shopping cart, item quantities/prices, saved-cart IDs/names and checkout defaults. Does not order, load or alter any cart.
Inputs
None.
Output
| Field | Type | Required | Details |
|---|---|---|---|
retrieved_at |
string |
Yes | format: date-time |
source_url |
string |
Yes | — |
cached |
boolean |
Yes | — |
items |
array of CartItem |
Yes | — |
saved_carts |
array of SavedCart |
Yes | — |
delivery_address |
string or null |
Yes | — |
special_instructions |
string or null |
Yes | — |
two_step_checkout |
boolean |
Yes | — |
Unknown fields are not accepted.
onestop_get_saved_cart
Inspect items in a verified own saved cart before loading it. Does not merge or replace the active cart.
Inputs
| Field | Type | Required | Details |
|---|---|---|---|
saved_cart_id |
string |
Yes | pattern: ^[0-9a-f]{32}$ |
Output
| Field | Type | Required | Details |
|---|---|---|---|
offset |
integer |
Yes | minimum: 0 |
available_count |
integer |
Yes | minimum: 0 |
total_count |
integer or null |
Yes | minimum: 0 |
complete |
boolean |
Yes | — |
next_offset |
integer or null |
Yes | minimum: 0 |
retrieved_at |
string |
Yes | format: date-time |
source_url |
string |
Yes | — |
cached |
boolean |
Yes | — |
records |
array of PortalRecord |
Yes | — |
Unknown fields are not accepted.
onestop_list_favourites
Read your saved catalog favourites and which are pinned to the homepage. The native portal permits up to four pins.
Inputs
None.
Output
| Field | Type | Required | Details |
|---|---|---|---|
retrieved_at |
string |
Yes | format: date-time |
source_url |
string |
Yes | — |
cached |
boolean |
Yes | — |
items |
array of Favourite |
Yes | — |
pinned_count |
integer |
Yes | — |
maximum_pins |
integer |
No | default: 4 |
Unknown fields are not accepted.
onestop_prepare_cart_checkout
Create a 15-minute local checkout preview with the current own cart, delivery address and instructions. Does not order anything. submit_cart_checkout rechecks that cart contents have not changed.
This tool changes local workflow state.
Inputs
| Field | Type | Required | Details |
|---|---|---|---|
delivery_address |
string or null |
No | default: null; maximum length: 10000 |
special_instructions |
string or null |
No | default: null; maximum length: 10000 |
Output
| Field | Type | Required | Details |
|---|---|---|---|
checkout_id |
string |
Yes | — |
source_url |
string |
Yes | — |
expires_at |
string |
Yes | format: date-time |
items |
array of CartItem |
Yes | — |
delivery_address |
string |
Yes | — |
special_instructions |
string |
Yes | — |
Unknown fields are not accepted.
onestop_prepare_payment
Ask One Stop to prepare a checkout link for a visible payment service. Returns the native HTTPS gateway URL for the user to open and complete. Does not enter bank/card credentials, authenticate with a bank, or confirm a charge.
MCP host confirmation is required before this action.
Inputs
| Field | Type | Required | Details |
|---|---|---|---|
service_id |
string |
Yes | pattern: ^[0-9a-f]{32}$ |
Output
| Field | Type | Required | Details |
|---|---|---|---|
service_id |
string |
Yes | — |
title |
string |
Yes | — |
checkout_url |
string |
Yes | — |
requires_browser_completion |
true |
No | default: true |
Unknown fields are not accepted.
onestop_update_cart
Change your native cart: set a permitted quantity, remove/clear items, append a saved cart, replace with a saved cart, or delete a saved cart. IDs must appear in get_cart. replace_with_saved replaces current contents; load_saved appends. Does not checkout.
MCP host confirmation is required before this action.
Inputs
| Field | Type | Required | Details |
|---|---|---|---|
action |
"set_quantity", "remove", "clear", "load_saved", "replace_with_saved", "delete_saved" |
Yes | — |
item_id |
string or null |
No | default: null; pattern: ^[0-9a-f]{32}$ |
quantity |
integer or null |
No | default: null; minimum: 1; maximum: 100 |
saved_cart_id |
string or null |
No | default: null; pattern: ^[0-9a-f]{32}$ |
Output
| Field | Type | Required | Details |
|---|---|---|---|
operation |
string |
Yes | — |
completed_at |
string |
Yes | format: date-time |
source_url |
string |
Yes | — |
resource_id |
string or null |
Yes | — |
outcome |
"completed", "unchanged", "uncertain", "requires_user_action" |
Yes | — |
verified |
boolean |
Yes | — |
message |
string or null |
Yes | — |
references |
array of NamedValue |
Yes | — |
Unknown fields are not accepted.
onestop_save_cart
Save the current cart, or selected own cart item IDs, as a new named cart using native name/selection validation. Existing saved names are not overwritten. Does not submit an order.
MCP host confirmation is required before this action.
Inputs
| Field | Type | Required | Details |
|---|---|---|---|
name |
string |
Yes | minimum length: 1; maximum length: 100 |
item_ids |
array of string or null |
No | default: null |
Output
| Field | Type | Required | Details |
|---|---|---|---|
operation |
string |
Yes | — |
completed_at |
string |
Yes | format: date-time |
source_url |
string |
Yes | — |
resource_id |
string or null |
Yes | — |
outcome |
"completed", "unchanged", "uncertain", "requires_user_action" |
Yes | — |
verified |
boolean |
Yes | — |
message |
string or null |
Yes | — |
references |
array of NamedValue |
Yes | — |
Unknown fields are not accepted.
onestop_submit_cart_checkout
Submit a reviewed cart checkout exactly once after checking account identity, expiry and unchanged cart contents. Returns the native request receipt. Accounts requiring an additional two-step form receive a portal handoff. Uncertain submissions must be inspected before another checkout.
MCP host confirmation is required before this action.
Inputs
| Field | Type | Required | Details |
|---|---|---|---|
checkout_id |
string |
Yes | minimum length: 16; maximum length: 100 |
Output
| Field | Type | Required | Details |
|---|---|---|---|
operation |
string |
Yes | — |
completed_at |
string |
Yes | format: date-time |
source_url |
string |
Yes | — |
resource_id |
string or null |
Yes | — |
outcome |
"completed", "unchanged", "uncertain", "requires_user_action" |
Yes | — |
verified |
boolean |
Yes | — |
message |
string or null |
Yes | — |
references |
array of NamedValue |
Yes | — |
Unknown fields are not accepted.
onestop_update_favourite
Pin/unpin/remove one own saved favourite or clear all favourites. The native four-pin limit and unpin-before-removal rules apply. clear affects every unpinned favourite; it does not clear the shopping cart.
MCP host confirmation is required before this action.
Inputs
| Field | Type | Required | Details |
|---|---|---|---|
action |
"pin", "unpin", "remove", "clear" |
Yes | — |
favourite_id |
string or null |
No | default: null; pattern: ^[0-9a-f]{32}$ |
Output
| Field | Type | Required | Details |
|---|---|---|---|
operation |
string |
Yes | — |
completed_at |
string |
Yes | format: date-time |
source_url |
string |
Yes | — |
resource_id |
string or null |
Yes | — |
outcome |
"completed", "unchanged", "uncertain", "requires_user_action" |
Yes | — |
verified |
boolean |
Yes | — |
message |
string or null |
Yes | — |
references |
array of NamedValue |
Yes | — |
Unknown fields are not accepted.