Sherpo customer MCP

Add https://customer-mcp.sherpo.it/s/{store hostname}/mcp to your MCP client as a remote server. The client registers itself with the store's authorization server, https://customer-auth.sherpo.it/s/{store hostname}, and sends you there to sign in with a code mailed to you and to choose what it may do. You can disconnect it at any time.

The tools act for you in that store alone. A tool the connection's scopes don't cover isn't listed. A failed call is a tool error whose structuredContent holds the service's code and context; a write carries no idempotency key, so after a failed write read the state back before trying again. A private file comes back inside get_attachment_url's result, up to 8 MiB; what the merchant keeps off MCP stays off it.

Tools

Tool	What it does	Scope
`get_profile`	Reads the customer's profile	`read`
`update_profile`	Updates the customer's name and preferences	`profile:write`
`list_contacts`	Lists the customer's email addresses and phones	`read`
`get_store`	Reads the store: its name, branding and settings	any connection
`list_products`	Pages the store's products with what the customer holds of each	`read`
`get_product`	Reads one product with its offers and access	`read`
`list_entries`	Pages a product's entries with their access	`read`
`get_entry`	Reads one entry with its access	`read`
`list_pages`	Pages the store's custom pages	`read`
`get_page`	Reads one custom page	`read`
`read_body`	Reads a product's, entry's or page's body, where the customer may	`read`
`get_attachment_url`	Mints a short-lived URL to an attachment's file, where the customer may reach it	`read`
`complete_entry`	Marks an entry complete for the customer	`progress:write`
`list_completions`	Pages the customer's completed entries	`read`
`list_checkouts`	Pages the customer's checkouts	`read`
`get_checkout`	Reads one of the customer's checkouts	`read`
`list_orders`	Pages the customer's orders	`read`
`get_order`	Reads one of the customer's orders	`read`
`list_order_items`	Pages an order's lines	`read`
`list_order_refunds`	Pages an order's refunds	`read`
`list_subscriptions`	Pages the customer's subscriptions	`read`
`get_subscription`	Reads one of the customer's subscriptions	`read`
`cancel_subscription`	Cancels a subscription at the end of its period	`subscription:write`
`resume_subscription`	Withdraws a subscription's scheduled cancellation	`subscription:write`
`list_grants`	Pages the customer's grants of access	`read`
`list_entitlements`	Pages what the customer may reach	`read`
`list_reviews`	Pages a product's reviews	`read`
`write_review`	Writes or updates the customer's review of a product	`review:write`
`delete_review`	Deletes the customer's review	`review:write`
`start_attempt`	Starts an attempt at a quiz	`quiz:write`
`submit_attempt`	Submits answers to an attempt and grades it	`quiz:write`
`forfeit_quiz`	Gives up the open attempt at a quiz	`quiz:write`
`list_attempts`	Pages the customer's quiz attempts	`read`
`list_certificates`	Pages the certificates issued to the customer	`read`
`get_certificate`	Reads one certificate issued to the customer	`read`
`verify_certificate`	Checks that a certificate was issued and is not revoked	any connection
`get_portfolio`	Reads a portfolio product's book, as far as the customer may	`read`
`list_portfolio_events`	Pages a portfolio's events	`read`
`list_portfolio_snapshots`	Pages a portfolio's daily snapshots	`read`

Prompts

The prompts of the products you hold are offered as MCP prompts, each named after its file (with the product's slug in front where two share a name), when the connection holds read. A prompt the merchant keeps off MCP, or one you no longer hold, isn't listed.