Service Mapping MCP tools reference

  • Release version: Zurich
  • Updated May 20, 2026
  • 3 minutes to read
    • Summarize
    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 Service Mapping MCP tools reference

    This reference describes five read-only Service Mapping MCP tools provided by the Now Assist CMDB MCP Server. These tools enable MCP-compatible AI clients, such as Claude, to retrieve detailed application service data from a ServiceNow instance without modifying any records. The tools support querying application services, service topologies, server impacts, and identifying unmapped configuration items (CIs) to enhance Service Mapping accuracy and coverage.

    Show full answer Show less

    Key Features

    • getallapplicationservicenames: Lists all application service names with optional filtering by mapping type (pattern-based, tag-based, or calculated). Returns paginated service names, system IDs, and service types to efficiently handle large datasets.
    • getallapplicationservicesforaserver: Retrieves all application services containing a specified server CI by name or system ID. Each service entry includes name, system ID, type, and mapping status. Returns an empty list if no services are found, avoiding false error reports.
    • getapplicationservicetopology: Provides the full, current topology of a specified application service, including all member CIs and CMDB relationships, with details on CI name, class, relationship type, and direction (upstream/downstream). For large services (over 50 members), summaries or counts are recommended to prevent exceeding message limits.
    • getserverimpactgraph: Returns all CIs related to a given server CI through CMDB relationships and observed TCP traffic connections. Differentiates between relationship-based and traffic-based connections to assist in impact analysis and identifying candidates for service mapping inclusion.
    • getunmappedtopology: Identifies CIs that have CMDB relationships or TCP traffic but are not members of any application service, helping to pinpoint mapping gaps. Supports optional filtering by CI class, such as Linux servers, to prioritize Service Mapping efforts.

    Practical Use for ServiceNow Customers

    • Use these tools to query and analyze application services and their components efficiently without altering your CMDB data.
    • Filter and paginate results to manage large datasets and avoid overwhelming responses.
    • Leverage topology and impact graph tools to visualize service components and dependencies, aiding troubleshooting and impact analysis.
    • Identify unmapped or partially mapped infrastructure to prioritize Service Mapping improvements and increase CMDB completeness.
    • Integrate these tools with AI assistants like Claude using natural-language queries to streamline data retrieval and decision-making.

    Reference information for the five Service Mapping MCP tools provided by the Now Assist CMDB MCP Server, including their inputs, outputs, and example natural-language queries for use with Claude.

    The Now Assist CMDB MCP Server exposes five tools that an MCP-compatible AI client can invoke to retrieve application service data from a ServiceNow instance. All tools are read-only and do not create, update, or delete records.

    get_all_application_service_names

    Returns a list of all application service names in the instance.

    Input
    An optional filter parameter to limit results by mapping type: pattern-based, tag-based, or calculated. If no filter is provided, all service types are returned.
    Output
    A paginated list of entries. Each entry includes:
    • Service name
    • System ID
    • Service type
    The response is paginated or bounded to prevent oversized payloads.
    Example queries
    • "Use the ServiceNow Service Mapping tool, get_all_application_service_names, to list all application services."
    • "List all tag-based application services in ServiceNow."

    get_all_application_services_for_a_server

    Returns all application services that include a specified server as a member CI.

    Input
    Server CI name or System ID.
    Output
    A list of application services. Each entry includes:
    • Service name
    • System ID
    • Service type
    • Mapping status
    If no services are found for the specified server, an empty list is returned. This is not treated as an error.
    Example queries
    • "Use the ServiceNow Service Mapping tool, get_all_application_services_for_a_server, to find which services contain server emse-10152008.servicenow.com"
    • "Which application services include server haproxy-s?"

    get_application_service_topology

    Returns the full topology of a specified application service, including all member CIs and the CMDB relationships (edges) connecting them.

    Input
    Application service name or System ID.
    Output
    The complete topology of the service. Each CI entry includes:
    • CI name
    • CI class
    • Relationship type
    • Direction: upstream or downstream
    The topology reflects the current state of the service map, not a cached version.
    Example queries
    • "Use the ServiceNow Service Mapping tool, get_application_service_topology, to get the topology for the Inclusion service. Just show me the member count and edge count, don't visualize."
    • "Show me the topology of the Payroll service."
    Usage note
    Application services with a large number of member CIs and edges (more than 50 members) return a significant volume of data. When querying topology for large services, ask Claude for a summary or specific counts rather than a full visualization to avoid reaching message-length limits on the Claude free tier.

    get_server_impact_graph

    Given a server CI, returns all CIs related to it via CMDB relationships and all CIs with observed TCP traffic connections to or from that server.

    Input
    Server CI name or System ID.
    Output
    A set of related CIs. The response distinguishes between:
    • CIs related via CMDB relationships. Uses [cmdb_rel_ci] or equivalent.
    • CIs with observed TCP traffic connections to or from the specified server
    This distinction enables AI-assisted identification of candidates for service map inclusion.
    Example queries
    • "Use the ServiceNow Service Mapping tool, get_server_impact_graph, to get impact analysis for server haproxy-s."
    • "What CIs are related to server db-cluster-02 via CMDB or traffic?"

    get_unmapped_topology

    Returns CIs that have CMDB relationships, TCP traffic signals or both, but are not currently members of any application service. Use this tool to identify mapping gaps and prioritize further Service Mapping work.

    Input
    An optional CI class filter, for example to return only Linux servers or only application servers.
    Output
    A list of unmapped CIs. Each entry includes:
    • CI name
    • CI class
    • Number of CMDB relationship edges
    • Number of TCP traffic connections
    Example queries
    • "Use the ServiceNow Service Mapping tool, get_unmapped_topology, to show me which CIs have relationships or traffic signals but are not in any application service."
    • "Use the ServiceNow Service Mapping tool, get_unmapped_topology, to show me unmapped Linux servers in ServiceNow."