scp_create_intent

Create shopping intents with authorized merchants to define customer purchase goals and enable personalized shopping assistance through the Shopper Context Protocol.

Instructions

Create a new shopping intent with a merchant. Domain must be authorized with intent:create scope.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`ai_assistant`	No	Name of the AI assistant
`base_intent`	Yes	Natural language description of the shopping goal
`context`	No	Additional context about the intent
`domain`	Yes	Merchant domain
`mechanism`	No	How the intent was created	conversational_ai
`visibility`	No	Who can see this intent	merchant_only

Implementation Reference

src/server.ts:933-957 (handler)

The main handler function for the 'scp_create_intent' MCP tool. It validates authorization, retrieves the access token, constructs the request parameters, calls the SCP HTTP client to create the intent, and returns the result.

 * Tool handler: scp_create_intent
 */
async function handleCreateIntent(domain: string, params: any) {
  const { auth, accessToken } = await checkAuthorizationOrThrow(domain);
  const token = await accessToken;

  const data = await scpClient.createIntent(auth.scp_endpoint, token, {
    base_intent: params.base_intent,
    mechanism: params.mechanism || 'conversational_ai',
    ai_assistant: params.ai_assistant,
    ai_session_id: params.ai_session_id,
    context: params.context,
    visibility: params.visibility || 'merchant_only',
    expires_at: params.expires_at
  });

  return {
    content: [
      {
        type: 'text',
        text: JSON.stringify(data, null, 2)
      }
    ]
  };
}

src/server.ts:470-506 (schema)

The input schema definition and description for the 'scp_create_intent' tool, registered in the ListTools response.

{
  name: 'scp_create_intent',
  description: 'Create a new shopping intent with a merchant. Domain must be authorized with intent:create scope.',
  inputSchema: {
    type: 'object',
    properties: {
      domain: {
        type: 'string',
        description: 'Merchant domain'
      },
      base_intent: {
        type: 'string',
        description: 'Natural language description of the shopping goal'
      },
      context: {
        type: 'object',
        description: 'Additional context about the intent'
      },
      mechanism: {
        type: 'string',
        description: 'How the intent was created',
        default: 'conversational_ai'
      },
      ai_assistant: {
        type: 'string',
        description: 'Name of the AI assistant'
      },
      visibility: {
        type: 'string',
        description: 'Who can see this intent',
        enum: ['merchant_only', 'shared_with_customer'],
        default: 'merchant_only'
      }
    },
    required: ['domain', 'base_intent']
  }
},

src/server.ts:576-577 (registration)
The switch case in the CallToolRequestSchema handler that routes calls to the scp_create_intent tool to its handler function.
```
case 'scp_create_intent':
  return await handleCreateIntent(args.domain as string, args);
```

SCP Local MCP Server