CS-Cart MCP Server

Instructions

Implementation Reference

• src/index.js:531-544 (handler)

  Implements the core logic of the get_users tool: builds query parameters from input arguments (page, items_per_page, status, user_type) and performs a GET request to the CS-Cart /users API endpoint via makeRequest helper, returning the result as formatted JSON text.

  async getUsers(args) {
    const params = new URLSearchParams();
    
    if (args.page) params.append('page', args.page.toString());
    if (args.items_per_page) params.append('items_per_page', args.items_per_page.toString());
    if (args.status) params.append('status', args.status);
    if (args.user_type) params.append('user_type', args.user_type);
  
    const queryString = params.toString();
    const endpoint = `/users${queryString ? `?${queryString}` : ''}`;
    
    const result = await this.makeRequest('GET', endpoint);
    return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
  }

• src/index.js:330-354 (schema)

  Defines the input schema for the get_users tool, specifying properties for pagination (page, items_per_page), filtering by status (A/D) and user_type (A/V/C).

  inputSchema: {
    type: 'object',
    properties: {
      page: {
        type: 'number',
        description: 'Page number for pagination',
        default: 1,
      },
      items_per_page: {
        type: 'number',
        description: 'Number of items per page',
        default: 10,
      },
      status: {
        type: 'string',
        description: 'User status filter (A=Active, D=Disabled)',
        enum: ['A', 'D'],
      },
      user_type: {
        type: 'string',
        description: 'User type filter (A=Admin, V=Vendor, C=Customer)',
        enum: ['A', 'V', 'C'],
      },
    },
  },

• src/index.js:327-355 (registration)

  Registers the get_users tool in the ListTools response, including its name, description, and full input schema.

  {
    name: 'get_users',
    description: 'Get list of users/customers',
    inputSchema: {
      type: 'object',
      properties: {
        page: {
          type: 'number',
          description: 'Page number for pagination',
          default: 1,
        },
        items_per_page: {
          type: 'number',
          description: 'Number of items per page',
          default: 10,
        },
        status: {
          type: 'string',
          description: 'User status filter (A=Active, D=Disabled)',
          enum: ['A', 'D'],
        },
        user_type: {
          type: 'string',
          description: 'User type filter (A=Admin, V=Vendor, C=Customer)',
          enum: ['A', 'V', 'C'],
        },
      },
    },
  },

• src/index.js:410-411 (registration)

  In the CallToolRequest handler switch statement, routes 'get_users' calls to the getUsers method.

  case 'get_users':
    return await this.getUsers(args);

• src/index.js:424-440 (helper)

  Shared helper method used by getUsers (and other tools) to make authenticated HTTP requests to the CS-Cart API endpoints.

  async makeRequest(method, endpoint, data = null) {
    const config = {
      method,
      url: `${process.env.CSCART_API_URL}${endpoint}`,
      headers: {
        'Content-Type': 'application/json',
        'Authorization': `Basic ${Buffer.from(`${process.env.CSCART_API_EMAIL}:${process.env.CSCART_API_KEY}`).toString('base64')}`,
      },
    };
  
    if (data) {
      config.data = data;
    }
  
    const response = await axios(config);
    return response.data;
  }