Connect to https://mcp.opencommerce.sh/mcp with your Commerce SDK credentials as Authorization: Bearer <YOUR_CLIENT_ID>:<YOUR_CLIENT_SECRET>. See Connect your agent.
save_address isn’t available on the server yet. Until it is, a call answers saved_addresses_unavailable.
Behavior: Changes state. Saving under a name replaces what was saved there, so sending the same save again changes nothing more.
What it does
Saves an address under a name the shopper gave it, only after the shopper said yes to keeping it. Copy every field from what the shopper gave. Never invent or fill in a field: ask for a missing one.
Inputs
Field
Type
Description
shopper_id(required)
string
Your own stable id for the shopper. The same value on every call for the same person.
label(required)
string
The name the shopper gave the address, such as Dad or Office. Any spelling of a saved name matches it. 1 to 100 characters.
address(required)
object
The address as the shopper gave it. The fields are listed under Notes.
is_default
boolean
true only when the shopper asked for this to be their default address.
Returns
Field
Type
Description
label
string
The name the address is saved under. Use it when the shopper says where an order ships.
line
string
The name and the city, such as Dad · Austin, TX. The street is never returned.