Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| SCP_TEST_ENDPOINT | No | Endpoint to use for testing with a development server. This bypasses DNS discovery and directs all requests to your local test server. |
Schema
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| scp-usage-guide | How to use Shopper Context Protocol (SCP) tools |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| scp_authorize | BEFORE USING THIS ENSURE THE DOMAIN SUPPORTS SCP BY CALLING scp_discover FIRST. Authorize access to a merchant's customer context via SCP. Must be called before accessing any customer data. IMPORTANT: You must ask the user for their REAL email address - never use placeholder emails like user@example.com. Ask: "What email address do you use with [Merchant]?" and wait for their response. |
| scp_check_authorization | Check if authorized with a merchant domain |
| scp_revoke_authorization | Revoke authorization with a merchant domain |
| scp_discover | Discover SCP endpoint for a merchant domain via DNS |
| scp_get_orders | Get order history from a merchant. Domain must be authorized first. |
| scp_get_loyalty | Get loyalty status and points from a merchant. Domain must be authorized first. |
| scp_get_offers | Get active personalized offers from a merchant. Domain must be authorized first. |
| scp_get_preferences | Get saved customer preferences (sizes, styles, addresses) from a merchant. Domain must be authorized first. |
| scp_get_intents | Get shopping intents from a merchant. Domain must be authorized first. |
| scp_create_intent | Create a new shopping intent with a merchant. Domain must be authorized with intent:create scope. |
| scp_update_intent | Update an existing shopping intent. Domain must be authorized with intent:write scope. |