SCP Local MCP Server

Instructions

Implementation Reference

• src/server.ts:912-930 (handler)

  Main execution handler for scp_get_intents tool. Checks authorization, fetches access token, calls SCP client to retrieve shopping intents, and returns JSON-formatted response.

  async function handleGetIntents(domain: string, params: any) {
    const { auth, accessToken } = await checkAuthorizationOrThrow(domain);
    const token = await accessToken;
  
    const data = await scpClient.getIntents(auth.scp_endpoint, token, {
      status: params.status || ['active', 'in_progress'],
      limit: params.limit || 10,
      offset: params.offset || 0
    });
  
    return {
      content: [
        {
          type: 'text',
          text: JSON.stringify(data, null, 2)
        }
      ]
    };
  }

• src/server.ts:446-469 (schema)

  Input schema and metadata for the scp_get_intents tool, defining required 'domain' and optional 'status' and 'limit' parameters.

  {
    name: 'scp_get_intents',
    description: 'Get shopping intents from a merchant. Domain must be authorized first.',
    inputSchema: {
      type: 'object',
      properties: {
        domain: {
          type: 'string',
          description: 'Merchant domain'
        },
        status: {
          type: 'array',
          items: { type: 'string' },
          description: 'Filter by status (e.g., [\'active\', \'in_progress\'])'
        },
        limit: {
          type: 'number',
          description: 'Maximum number of intents to return',
          default: 10
        }
      },
      required: ['domain']
    }
  },

• src/server.ts:573-575 (registration)

  Tool handler registration in the CallToolRequestSchema switch statement, mapping tool name to handleGetIntents function.

  case 'scp_get_intents':
    return await handleGetIntents(args.domain as string, args);

• src/server.ts:811-825 (helper)

  Shared authorization check helper function used by the handler to ensure the domain is authorized before accessing data.

  async function checkAuthorizationOrThrow(domain: string): Promise<{ auth: any; accessToken: Promise<string> }> {
    const auth = await getAuthorization(domain);
  
    if (!auth) {
      const errorMessage = `❌ Not authorized with ${domain}.\n\n` +
        `Please authorize first by calling:\n` +
        `scp_authorize with domain="${domain}", email="your@email.com", and scopes=["orders", "loyalty", "preferences", "intent:read", "intent:create"]`;
      throw new Error(errorMessage);
    }
  
    return {
      auth,
      accessToken: getValidAccessToken(domain)
    };
  }

• src/http/client.ts:124-135 (helper)

  HTTP client helper that wraps the JSON-RPC call to the merchant's SCP endpoint for fetching intents.

  export async function getIntents(
    endpoint: string,
    accessToken: string,
    params?: {
      status?: string[];
      mechanism?: string;
      limit?: number;
      offset?: number;
    }
  ): Promise<any> {
    return makeRPCRequest(endpoint, accessToken, 'scp.get_intents', params);
  }