MCP Server 3.0.x - Tools reference

Tools exposed by the CAST Imaging MCP Server 3.0.x and earlier to your AI client

Overview

Your AI client selects and calls these tools on your behalf - you do not call them directly. Use this page to understand what the CAST Imaging MCP Server can answer.

Structural tools

  • Portfolio tools - tools for overall portfolio exploration for cross-application analysis when users want to explore multiple applications, compare metrics across the entire portfolio, or discover available applications before diving into specific ones.
  • Application tools - tools for application-level exploration for analyzing a single application in depth, covering architecture, quality insights, transactions, data graphs, packages, dependencies, and overall application statistics and structure.
  • Object tools - Object level exploration for drilling down into specific code artifacts (classes, methods, tables, functions) within an application - examining their properties, relationships, callers/callees, usage in transactions, and associated quality insights.

Portfolio tools

  • applications - list all available applications available in CAST Imaging.
  • applications_data_graphs - retrieve Data Call Graph views across all applications available in CAST Imaging with filtering.
  • applications_dependencies - analyse inter-application dependencies across the applications available showing incoming and outgoing relationships for each app.
  • applications_quality_insights - get quality insights across all applications in CAST Imaging with selective insight types:
    • cve - security vulnerabilities
    • cloud - cloud maturity patterns
    • green - sustainability patterns
    • structural-flaws - architectural issues
    • iso-5055 - ISO quality violations
  • applications_transactions - retrieve transactions across all applications available in CAST Imaging with optional filtering.
  • inter_app_detailed_dependencies - get detailed dependency information between two specific applications showing exact interaction points.
  • inter_applications_dependencies - analyze dependencies between applications showing inward (apps depending on this) and outward (apps this depends on) relationships.

Application tools

  • add_view_document - add document (i.e. post-its) to transactions or data graphs for knowledge capture.
  • advisors - get migration/modernization advisors, advisor rules, and violations for an advisor for an application. Includes the following focus options:
    • list - list all available advisors for the application.
    • rules - get rules for a specific advisor.
    • violations - get objects violating a specific rule in an advisor.
  • advisor_occurrences - get occurrences of findings supporting selected advisor for an application.
  • application_database_explorer - explore database tables and columns in an application with three modes:
    • List all tables
    • Filter tables by name
    • Get columns for specific table(s)
  • application_iso_5055_explorer - explore ISO 5055 software quality characteristics (Security, Reliability, Performance, Maintainability) and their associated weaknesses.
  • architectural_graph - visualize application architecture (nodes/links) for an application at a specific abstraction levels (layer, component, sub-component, technology-category, element-type).
  • architectural_graph_focus - get architecture focused on specific components for an application, useful for exploring architecture around key areas.
  • custom_node - manage custom nodes within a custom view to group objects by specific criteria. Allows filtering by transaction, object type and insight.
  • custom_views - manage custom aggregation views for grouping objects by custom criteria. Includes options to list, create, get details, delete, update, publish, or unpublish views.
  • data_graph_details - get detailed information about specific data call graph flow with multiple focus options:
    • complexity - list of complex objects in the flow graph of a data call graph.
    • insights - list objects in the data call graph flow with Quality insights
    • nodes - list of all objects in the data call graph.
    • links - list of all links/connections between objects in the data call graph
    • graph - full call graph for a data graph view.
    • type_graph - graph results aggregated by object types.
    • complexity_graph - reduced version of a data graph to represent only most complex objects.
    • documents - list documents like post-its attached to a data call graph view.
    • summary - fetch the AI-generated summary attached to the data call graph (if available)
  • data_graphs - fetch data call graph views for an application with optional filtering capabilities.
  • package_interactions - analyze interactions between different packages for an application to understand dependency relationships with it.
  • packages - list external packages, libraries or dependencies used by the application.
  • quality_insight_violations - get detailed information about the occurrences (specific locations) for a particular quality-related insight type and ID in an application. Returns quality patterns and violating objects and their details.
  • quality_insights - retrieve quality issues and vulnerabilities including CVE, cloud patterns, green patterns, structural flaws, and ISO-5055 violations for an application.
  • stats - get basic statistics for an application including size, complexity, and technology metrics.
  • transaction_details - get comprehensive details about specific transactions with multiple focus options:
    • complexity - list of complex objects in the flow graph of transaction.
    • insights - list objects in the transaction flow with Quality insights
    • nodes - list of all objects in the transaction graph
    • links - list of all links/connections between objects in the transaction graph
    • graph - full call graph of the transaction
    • type_graph - graph results aggregated by object types
    • complexity_graph - reduced version of a transaction graph to represent only most complex objects.
    • documents - list documents like post-its attached to a transaction
    • summary - fetch the AI-generated summary attached to the transaction (if available)
  • transactions - fetch transactions for an application with optional filtering capabilities by name or type of the transaction.
  • views - manage saved views for an application with options to list all views, create new views with selected objects, update existing views, get complete view details, or delete them.

Object tools

  • add_object_document - attach document (post-its) to an object for knowledge preservation or note-taking.
  • data_graphs_involving_object - find all data call graphs involving specific objects based on criteria. Essential for understanding data dependencies.
  • manage_object_tags - add or delete tags on code elements (objects) in an application. Allows specifying multiple tags to append or remove for a list of object IDs.
  • object_details - get comprehensive details about specific objects with multiple focus options:
    • intra - basic properties and child objects
    • inward - incoming dependencies (callers)
    • outward - outgoing dependencies (callees)
    • testing - fetch related transactions and data graphs.
    • code - source code snippets (when IMAGING_CODE=True in the app.config)
    • insights - quality issues/insights for object
    • documents - fetch attached documents i.e. post-its to an object (if available)
  • objects - search and filter objects (classes, methods, tables, etc.) in an application. Supports:
    • filtering by name, fullname, type, mangling, filepath or annotation with the contains (default), equals, startswith or endswith operator. All filters in one query must use the same operator, e.g. name:contains:Order,type:contains:Method.
    • restricting results to internal or external objects with searchtype:eq:internal or searchtype:eq:external.
    • filtering by tags.
  • source_file_details - get detailed dependency analysis for source files with multiple nature options:
    • inventory - all defined code elements
    • intra - internal dependencies within file
    • inward - incoming dependencies to file
    • outward - outgoing dependencies from file
    • testing - elements requiring tests if file changes
  • source_files - find source files that define code objects, matching a specified file path pattern (contains filter).
  • transactions_using_object - identify all transactions that use a specific object based on a criteria.