Cisco CX Cloud MCP Server

Instructions

Implementation Reference

• src/index.ts:251-265 (handler)

  Handler for the get_hardware_inventory tool. Extracts customerId from arguments, validates it, calls the makeApiCall helper to fetch data from /inventory/hardware endpoint, and returns the JSON-formatted response.

  case "get_hardware_inventory": {
    const customerId = args?.customerId as string;
    if (!customerId) {
      throw new Error("customerId is required");
    }
    const data = await makeApiCall("/inventory/hardware", customerId);
    return {
      content: [
        {
          type: "text",
          text: JSON.stringify(data, null, 2),
        },
      ],
    };
  }

• src/index.ts:94-107 (registration)

  Tool registration in the tools array, including name, description, and input schema. Used by the ListTools handler to advertise the tool's availability and parameters.

  {
    name: "get_hardware_inventory",
    description: "Get hardware inventory for a specific customer. Returns details about all hardware assets.",
    inputSchema: {
      type: "object",
      properties: {
        customerId: {
          type: "string",
          description: "The customer ID (get from get_customer_accounts first)",
        },
      },
      required: ["customerId"],
    },
  },

• src/index.ts:97-106 (schema)

  Input schema definition for the get_hardware_inventory tool, specifying that a customerId string is required.

  inputSchema: {
    type: "object",
    properties: {
      customerId: {
        type: "string",
        description: "The customer ID (get from get_customer_accounts first)",
      },
    },
    required: ["customerId"],
  },