servicenow-cmdb

ServiceNow CMDB - manage configuration items, relationships, and class metadata

Server path: /servicenow-cmdb | Type: Application | PCID required: Yes

Tools

Tool	Description
servicenow_cmdb_add_ci_relation	Add a relationship to a CI
servicenow_cmdb_create_configuration_item	Create a configuration item
servicenow_cmdb_delete_ci_relation	Delete a CI relationship
servicenow_cmdb_get_class_metadata	Get CMDB class metadata
servicenow_cmdb_get_configuration_item	Get a configuration item
servicenow_cmdb_list_configuration_items	List configuration items by class
servicenow_cmdb_update_configuration_item	Update a configuration item

---

servicenow_cmdb_add_ci_relation

Add a relationship to a CI

Parameters:

Parameter	Type	Required	Default	Description
className	string	Yes	—	CMDB class name of the source CI
sys_id	string	Yes	—	sys_id of the source CI
target	object	Yes	—	Target CI for the relationship
type	object	Yes	—	Relationship type

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "className": {
      "type": "string",
      "description": "CMDB class name of the source CI"
    },
    "sys_id": {
      "type": "string",
      "description": "sys_id of the source CI"
    },
    "target": {
      "type": "object",
      "description": "Target CI for the relationship",
      "properties": {
        "value": {
          "type": "string",
          "description": "sys_id of the target CI"
        }
      },
      "required": [
        "value"
      ]
    },
    "type": {
      "type": "object",
      "description": "Relationship type",
      "properties": {
        "value": {
          "type": "string",
          "description": "sys_id of the cmdb_rel_type record"
        }
      },
      "required": [
        "value"
      ]
    }
  },
  "required": [
    "PCID",
    "className",
    "sys_id",
    "target",
    "type"
  ]
}

---

servicenow_cmdb_create_configuration_item

Create a configuration item

Parameters:

Parameter	Type	Required	Default	Description
className	string	Yes	—	CMDB class name for the new CI (e.g., cmdb_ci_server, cmdb_ci_linux_server)
attributes	object	No	—	CI field values (e.g., {“name”: “server01”, “ip_address”: “10.0.0.1”, “os”: “Linux”})
inbound_relations	object[]	No	—	Inbound relationships to create
outbound_relations	object[]	No	—	Outbound relationships to create

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "className": {
      "type": "string",
      "description": "CMDB class name for the new CI (e.g., cmdb_ci_server, cmdb_ci_linux_server)"
    },
    "attributes": {
      "type": "object",
      "description": "CI field values (e.g., {\"name\": \"server01\", \"ip_address\": \"10.0.0.1\", \"os\": \"Linux\"})"
    },
    "inbound_relations": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "type": {
            "type": "object",
            "description": "The type value"
          },
          "source": {
            "type": "object",
            "description": "The source value"
          }
        }
      },
      "description": "Inbound relationships to create"
    },
    "outbound_relations": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "type": {
            "type": "object",
            "description": "The type value"
          },
          "target": {
            "type": "object",
            "description": "The target value"
          }
        }
      },
      "description": "Outbound relationships to create"
    }
  },
  "required": [
    "PCID",
    "className"
  ]
}

---

servicenow_cmdb_delete_ci_relation

Delete a CI relationship

Parameters:

Parameter	Type	Required	Default	Description
className	string	Yes	—	CMDB class name of the source CI
sys_id	string	Yes	—	sys_id of the source CI
rel_sys_id	string	Yes	—	sys_id of the relationship record to delete

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "className": {
      "type": "string",
      "description": "CMDB class name of the source CI"
    },
    "sys_id": {
      "type": "string",
      "description": "sys_id of the source CI"
    },
    "rel_sys_id": {
      "type": "string",
      "description": "sys_id of the relationship record to delete"
    }
  },
  "required": [
    "PCID",
    "className",
    "sys_id",
    "rel_sys_id"
  ]
}

---

servicenow_cmdb_get_class_metadata

Get CMDB class metadata

Parameters:

Parameter	Type	Required	Default	Description
className	string	Yes	—	CMDB class name to get metadata for (e.g., cmdb_ci_server)

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "className": {
      "type": "string",
      "description": "CMDB class name to get metadata for (e.g., cmdb_ci_server)"
    }
  },
  "required": [
    "PCID",
    "className"
  ]
}

---

servicenow_cmdb_get_configuration_item

Get a configuration item

Parameters:

Parameter	Type	Required	Default	Description
className	string	Yes	—	CMDB class name of the CI
sys_id	string	Yes	—	sys_id of the CI to retrieve

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "className": {
      "type": "string",
      "description": "CMDB class name of the CI"
    },
    "sys_id": {
      "type": "string",
      "description": "sys_id of the CI to retrieve"
    }
  },
  "required": [
    "PCID",
    "className",
    "sys_id"
  ]
}

---

servicenow_cmdb_list_configuration_items

List configuration items by class

Parameters:

Parameter	Type	Required	Default	Description
className	string	Yes	—	CMDB class name (e.g., cmdb_ci_server, cmdb_ci_linux_server, cmdb_ci_database)
sysparm_query	string	No	—	Encoded query to filter CIs
sysparm_limit	integer	No	—	Maximum number of CIs to return
sysparm_offset	integer	No	—	Starting index for pagination

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "className": {
      "type": "string",
      "description": "CMDB class name (e.g., cmdb_ci_server, cmdb_ci_linux_server, cmdb_ci_database)"
    },
    "sysparm_query": {
      "type": "string",
      "description": "Encoded query to filter CIs"
    },
    "sysparm_limit": {
      "type": "integer",
      "description": "Maximum number of CIs to return"
    },
    "sysparm_offset": {
      "type": "integer",
      "description": "Starting index for pagination"
    }
  },
  "required": [
    "PCID",
    "className"
  ]
}

---

servicenow_cmdb_update_configuration_item

Update a configuration item

Parameters:

Parameter	Type	Required	Default	Description
className	string	Yes	—	CMDB class name of the CI
sys_id	string	Yes	—	sys_id of the CI to update
attributes	object	No	—	CI attributes to update (e.g., {“ip_address”: “10.0.0.2”, “os_version”: “Ubuntu 22.04”})

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "className": {
      "type": "string",
      "description": "CMDB class name of the CI"
    },
    "sys_id": {
      "type": "string",
      "description": "sys_id of the CI to update"
    },
    "attributes": {
      "type": "object",
      "description": "CI attributes to update (e.g., {\"ip_address\": \"10.0.0.2\", \"os_version\": \"Ubuntu 22.04\"})"
    }
  },
  "required": [
    "PCID",
    "className",
    "sys_id"
  ]
}