--- sourceDocument: Australia ServiceNow AI Platform Capabilities sourceDocumentLink: https://www.servicenow.com/docs/r/australia/servicenow-platform Release : - australia ft:locale : - en-US ft:publication_title : - Australia ServiceNow AI Platform Capabilities ft:clusterId : - platcap bundleId : - platcap workflow : - Platform --- # MCP Server tools reference # CMDB MCP Server tools reference {#ariaid-title1} Release version: Australia Updated August 25, 2026 ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 5 minutes to read Summarize ![AI sparkle icon](https://servicenow.com/docs/portal-asset/ai-sparkle-icon) Summarized using AI This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete. ## Summary of CMDB MCP Server tools reference The CMDB Model Context Protocol (MCP) Server tools enable AI agents to interact with the ServiceNow Configuration Management Database (CMDB) by searching for Configuration Items (CIs), creating CIs, and querying the CMDB data model. These tools provide natural language interfaces to simplify and enhance CMDB management and impact analysis. Show full answer Show less ## CMDB MCP Server Tools * **CMDB Search:** Searches CIs based on natural language queries or specific sysid. It supports grouping results by CI class or other fields and returns detailed information or summary counts depending on the number of matches. This tool helps users quickly locate relevant CIs using plain language. * **Get Similar CI Classes:** Finds CI classes matching a given name or keyword before CI creation. It assists in identifying the correct technical class names and required attributes, reducing errors when adding new CIs. * **Create CI:** Enables creation of a new CI by specifying the class and attribute values. It requires confirmation of the class via the Get Similar CI Classes tool. The tool provides confirmation on success or detailed errors if creation fails. * **Get Impacted Items:** Uses the Impact Analysis Skill to identify CIs, services, and teams affected by a specified change request. It returns a detailed impact list, including impact type and confidence, helping users understand the blast radius of changes. * **Get CI Topology:** Returns the topology of impacted CIs related to a change request or incident, including upstream and downstream dependencies. It automatically triggers impact analysis if not already available, providing a visual map of affected components. * **Explain CMDB Data Model:** Answers natural language questions about the CMDB data model, including tables, fields, and relationships, using the Data Model Navigator agent. This tool helps users understand the structure and relationships within the CMDB. ## Practical Use and Benefits * **Simplified CMDB Interaction:** Natural language queries reduce complexity in searching and managing CIs, enabling enhanced productivity. * **Accurate CI Management:** Pre-creation class discovery and attribute validation minimize errors when adding new CIs. * **Impact Analysis Integration:** Identifying impacted items and topology aids in risk assessment and change management. * **Data Model Insights:** Understanding CMDB schema and relationships empowers better configuration and reporting. ## Access and Roles Each tool requires specific roles for activation and use, ensuring proper security and governance over CMDB interactions. The CMDB Model Context Protocol (MCP) Server tools let an AI agent search for and create CIs, and ask questions about the CMDB data model, with example utterances for each tool. ## MCP Server tools {#na-cmdb-mcp-server-ref__section-mcp-tools-intro} The CMDB MCP Server exposes six tools. CMDB Search, Get Similar CI Classes, and Create CI are general availability. Get Impacted Items, Get CI Topology, and Explain CMDB Data Model are currently store-2026-09. ## CMDB Search {#na-cmdb-mcp-server-ref__section-cmdb-search} Searches the CMDB for CIs based on the user utterance. If the utterance resolves to a table that isn't a valid, accessible CMDB entity, the tool returns a validation error. {#na-cmdb-mcp-server-ref__table_search_input__entry__3} | Parameter | Required | Description | |-|-|-| | utterance | Conditional | Natural language search query, for example "find all linux servers". Required unless cisysid is provided. | | cisysid | Conditional | Limits the search to the Configuration Item \[cmdb_ci\] record with this sys_id. Required unless utterance is provided. | | groupby | Optional | Field name used to group search results. | [Table 1. Input] {#na-cmdb-mcp-server-ref__table_search_input} {#na-cmdb-mcp-server-ref__table_search_output__entry__2} | Match count | Response | |-|-| | No matches | A message stating that no records matched the search. | | Single match | The matching CI's sys_id, table, name, class, and a summary, plus links to the CI's form and map views. | | 2 to 10 matches | A list of the matching CIs, each with sys_id, name, class, table, and last updated date, plus a link to the full list. | | More than 10 matches | Results grouped by CI class or by the groupby field, up to 20 groups, with a count for each group. If the specified groupby field isn't valid for the table, the response falls back to grouping by CI class and includes a warning. | [Table 2. Output] {#na-cmdb-mcp-server-ref__table_search_output} Example utterances: * "Find all Linux servers in the CMDB." * "Search for CIs with a non-operational status, grouped by CI class." {#na-cmdb-mcp-server-ref__ul_search_examples} ## Get Similar CI Classes {#na-cmdb-mcp-server-ref__section-get-similar-ci-classes} Finds CI classes that match a specified name or keyword. Use this tool before creating a CI to identify the correct technical class name and its required attributes. {#na-cmdb-mcp-server-ref__table_similar_classes_input__entry__3} | Parameter | Required | Description | |-|-|-| | class_name | Required | CI class name or keyword to search for, for example "linux server" or "cmdb_ci_win_server". | [Table 3. Input] {#na-cmdb-mcp-server-ref__table_similar_classes_input} On a match, the tool returns up to five candidate CI classes, each with its display label and technical class name. If no class matches the provided name, the tool returns an error. The error message notes that creation can still be attempted directly with a technical class name, though it's unlikely to succeed. Example utterances: * "What CI class should I use for a Linux server?" * "Find CI classes similar to cmdb_ci_win_server." {#na-cmdb-mcp-server-ref__ul_similar_classes_examples} ## Create CI {#na-cmdb-mcp-server-ref__section-create-ci} Creates a new CI for a specified CI class with the provided attributes. Before using this tool, use Get Similar CI Classes to confirm the correct class name and required fields. {#na-cmdb-mcp-server-ref__table_create_ci_input__entry__3} | Parameter | Required | Description | |-|-|-| | ci_class_name | Required | Technical name of the CI class, for example "cmdb_ci_linux_server". | | attributes_map | Required | Key-value pairs of CI attribute names and values. | [Table 4. Input] {#na-cmdb-mcp-server-ref__table_create_ci_input} On success, the tool returns a confirmation message with a link to the new CI in CMDB Workspace. If required attributes are missing, if a matching CI already exists, or if the CI can't be created, the tool returns an error describing the problem. Example utterances: * "Create a CI for a Linux server named app-db-03 with IP address 10.10.5.42." * "Create a new CMDB CI for an app server called payment-gateway-02." {#na-cmdb-mcp-server-ref__ul_create_ci_examples} ## Get Impacted Items {#na-cmdb-mcp-server-ref__section-get-impacted-items} Returns the CIs, services, and teams impacted by a given change request, using the Impact Analysis Skill capability. {#na-cmdb-mcp-server-ref__table_impacted_items_input__entry__3} | Parameter | Required | Description | |-|-|-| | change_request_number | Required | The change request number to analyze for impact, for example CHG0001234. | [Table 5. Input] {#na-cmdb-mcp-server-ref__table_impacted_items_input} On success, the tool returns the impacted-items list produced by the Impact Analysis Skill capability. See [CMDB impact analysis agentic workflow details](https://www.servicenow.com/docs/Pjxt~OX6IUcjQv_VdaLqQg "Reference information for the Assess CMDB impact agentic workflow, including input modes, output schema, supported record types, workflow tools, and constraints.") for the full output schema, including impact level, impact type, and confidence for each impacted CI. If change_request_number is missing, or the Impact Analysis Skill capability doesn't complete successfully, the tool returns an error describing the problem. The response includes chunks_analysed and total_chunks, which show how many of the topology chunks the analysis assessed. The partial field is `true` when the analysis assessed only some chunks, so the impacted items can be incomplete. In that case, the response also includes a warning message. Example utterances: * "What CIs are impacted by change CHG0001234?" * "Use the CMDB MCP Server tool, Get Impacted Items, to check the blast radius of change CHG0005678." {#na-cmdb-mcp-server-ref__ul_impacted_items_examples} ## Get CI Topology {#na-cmdb-mcp-server-ref__section-get-ci-topology} Returns the topology impacted by a change request or incident as nodes and edges, including upstream and downstream relationships. If the task has no impact analysis yet, the tool runs one first. {#na-cmdb-mcp-server-ref__table_topology_input__entry__3} | Parameter | Required | Description | |-|-|-| | task_number | Required | The change request or incident number to analyze, for example CHG0001234 or INC0001234. The record must have a CI set. | [Table 6. Input] {#na-cmdb-mcp-server-ref__table_topology_input} On success, the tool returns the topology's nodes, edges, and root CI. If the analysis stops before it covers the full topology, the response also includes a truncation flag and a warning that some impacted CIs might be missing. If task_number is missing, or the task isn't an active change request or incident with a CI set, the tool returns an error. Example utterances: * "Show me the topology impacted by change CHG0001234, including everything upstream and downstream." * "Use the CMDB MCP Server tool, Get CI Topology, to map the dependencies affected by incident INC0001234." {#na-cmdb-mcp-server-ref__ul_topology_examples} ## Explain CMDB Data Model {#na-cmdb-mcp-server-ref__section-explain-data-model} Answers natural language questions about the CMDB data model, including classes, tables, fields, and relationships, using the Data Model Navigator (DMN) agent. See [Data Model Navigator app features](https://www.servicenow.com/docs/7I3~rxY13lpFbGSSt~5JXA "The Data Model Navigator app provides comprehensive information about CMDB tables, attributes, and relationships with context-aware guidance for specific use cases. While users can view the data, the primary purpose is to generate up-to-date indexed data for use by ServiceNow Otto agents and skills.") for the agent's own reference documentation. {#na-cmdb-mcp-server-ref__table_dmn_input__entry__3} | Parameter | Required | Description | |-|-|-| | user_query | Required | Natural language question about the CMDB data model, for example "What fields does the cmdb_ci_server table have?" | [Table 7. Input] {#na-cmdb-mcp-server-ref__table_dmn_input} {#na-cmdb-mcp-server-ref__table_dmn_output__entry__2} | Match type | Fields returned | |-|-| | Field | Field name and description, sample data, the owning table and its description, and a relevance score. | | Table | Table name, table description, and a relevance score. | | Business context | Context name, context description, and a relevance score. | | Relationship | Source table, target table, and a description of the relationship. Results are limited to 5 relationships per table and 15 relationships total. | [Table 8. Output] {#na-cmdb-mcp-server-ref__table_dmn_output} If user_query is missing, or the requester doesn't have the required roles, the tool returns an error. Example utterances: * "What fields does the cmdb_ci_server table have?" * "How is the cmdb_ci table related to cmdb_rel_ci?" {#na-cmdb-mcp-server-ref__ul_dmn_examples} ## Role access {#na-cmdb-mcp-server-ref__section-role-access} Access to each tool is controlled by the role specified in the prerequisites of [Activate the CMDB MCP Server](https://www.servicenow.com/docs/92IRX5eCcWLmpAeRJe4bIA "Enable AI agents and other clients to securely access data and perform actions using the Model Context Protocol (MCP)."). **Related concepts** * [CMDB MCP Server](https://www.servicenow.com/docs/WmrizOlT6_RcB~uSzlH9WQ "The CMDB MCP Server exposes CMDB capabilities to external AI clients using the Model Context Protocol (MCP), so those clients can work with your configuration data without direct database access.") * [Analyzing the impact of a change or incident](https://www.servicenow.com/docs/VW_vxXCAIzYZprs4oeD1Ug "The Assess CMDB impact agentic workflow identifies the upstream services and CIs that are likely to be affected by an incident or by a proposed change. The workflow reasons about propagation likelihood based on CMDB dependency topology and the nature of the change. The workflow returns a structured list with impact levels and the reasoning.") **Related tasks** * [Activate the CMDB MCP Server](https://www.servicenow.com/docs/92IRX5eCcWLmpAeRJe4bIA "Enable AI agents and other clients to securely access data and perform actions using the Model Context Protocol (MCP).") **Related reference** * [CMDB impact analysis agentic workflow details](https://www.servicenow.com/docs/Pjxt~OX6IUcjQv_VdaLqQg "Reference information for the Assess CMDB impact agentic workflow, including input modes, output schema, supported record types, workflow tools, and constraints.")