# MuleSoft Platform MCP Server Unified MuleSoft Anypoint management console with AI agents, governance, and catalog discovery. - **Version:** 0.1.0 - **MCP Spec:** [mcp.yaml](https://dev-portal.mulesoft.com/mcps/mulesoft-platform/mcp.yaml) - **Endpoints:** `https://omni.mulesoft.com/mcp/` ## Tools (68) ### apply_policy_to_instance **Apply Policy To Asset Instance** Apply the selected policy to the target asset instance using the provided configuration data. For non-MuleSoft providers, pass provider and gateway_id; policy_template_id is the plugin name for Kong or the template ID for Apigee. **Input Parameters:** | Parameter | Type | Description | Required | |-----------|------|-------------|----------| | `api_instance_id` | string | | no | | `asset_id` | string | | no | | `asset_version` | string | | no | | `configuration_data` | string | | no | | `disabled` | string | | no | | `environment_id` | string | | no | | `gateway_id` | string | | no | | `group_id` | string | | no | | `label` | string | | no | | `order` | string | | no | | `organization_id` | string | | yes | | `pointcut_data` | string | | no | | `policy_template_id` | string | | no | | `provider` | string | | no | ### check_control_scope_targets **Check Control Scope Targets** Preview APIs matched by a control scope filter. **Input Parameters:** | Parameter | Type | Description | Required | |-----------|------|-------------|----------| | `organization_id` | string | | no | | `scope_filter` | string | | yes | ### check_policy_conformance **Check Policy Conformance** Convert the selected policy application payload to JSON-LD and print it in backend logs. **Input Parameters:** | Parameter | Type | Description | Required | |-----------|------|-------------|----------| | `api_instance_id` | string | | yes | | `asset_id` | string | | no | | `asset_version` | string | | no | | `configuration_data` | string | | no | | `disabled` | string | | no | | `environment_id` | string | | yes | | `group_id` | string | | no | | `label` | string | | no | | `order` | string | | no | | `organization_id` | string | | yes | | `pointcut_data` | string | | no | | `policy_template_id` | string | | no | ### create_automated_policy_strategy **Create Automated Policy Strategy** Create a new automated-policy governance strategy from wizard inputs. **Input Parameters:** | Parameter | Type | Description | Required | |-----------|------|-------------|----------| | `allow_duplicated` | boolean | | no | | `automated_policy_configuration` | string | | no | | `automated_policy_endpoint_type_groups` | string | | no | | `automated_policy_endpoint_type_mode` | string | | no | | `automated_policy_environment_id` | string | | no | | `automated_policy_id` | string | | no | | `automated_policy_runtime` | string | | no | | `automated_policy_runtime_range_from` | string | | no | | `automated_policy_runtime_range_to` | string | | no | | `description` | string | | no | | `name` | string | | no | | `organization_id` | string | | no | | `scope_filter` | string | | no | ### create_control **Create Control** Create a new control strategy from wizard inputs. **Input Parameters:** | Parameter | Type | Description | Required | |-----------|------|-------------|----------| | `description` | string | | no | | `governance_target_type` | string | | no | | `name` | string | | no | | `organization_id` | string | | no | | `position` | string | | no | | `rules` | string | | no | | `rulesets` | string | | no | | `schedule_config` | string | | no | | `scope_condition_mode` | string | | no | | `scope_conditions` | string | | no | | `scope_filter` | string | | no | | `strategy_status` | string | | no | | `strategy_type` | string | | no | ### create_omni_gateway **Create Omni Gateway** Launch the managed Omni Gateway creation wizard for the active MuleSoft provider. When fully configured, creates the gateway in Anypoint Platform. **Input Parameters:** | Parameter | Type | Description | Required | |-----------|------|-------------|----------| | `environment_id` | string | | no | | `environment_name` | string | | no | | `environment_type` | string | | no | | `governance_override_warnings` | boolean | | no | | `organization_id` | string | | no | | `payload` | string | | no | | `provider_id` | string | | no | | `target_type` | string | | no | ### create_scanner **Create Agent Scanner** Launch the scanner creation wizard to configure and create a new agent scanner. The wizard will guide you through provider selection, authentication, and configuration. On success, returns the created scanner details including scannerId. Pass organization_id when calling this tool. Call WITHOUT name/provider to display the interactive wizard. **Input Parameters:** | Parameter | Type | Description | Required | |-----------|------|-------------|----------| | `auth_fields` | string | | no | | `auth_fields_alias` | string | | no | | `auth_method` | string | | no | | `auth_method_alias` | string | | no | | `description` | string | | no | | `filters` | string | | no | | `name` | string | | no | | `notifications` | string | | no | | `organization_id` | string | | no | | `owner_id` | string | | no | | `provider` | string | | no | | `schedule` | string | | no | ### delete_automated_policy_strategy **Delete Automated Policy Strategy** Delete one automated-policy governance strategy by strategy ID. **Input Parameters:** | Parameter | Type | Description | Required | |-----------|------|-------------|----------| | `organization_id` | string | | no | | `strategy_id` | string | | yes | ### delete_governance_strategy **Delete Governance Strategy** Delete one governance strategy by strategy id. **Input Parameters:** | Parameter | Type | Description | Required | |-----------|------|-------------|----------| | `organization_id` | string | | no | | `strategy_id` | string | | yes | ### fetch_automated_policy_template **Fetch Automated Policy Template** Fetch one policy template's full configuration schema. Pass either ``template_id`` (legacy) or ``(group_id, asset_id, asset_version)``. **Input Parameters:** | Parameter | Type | Description | Required | |-----------|------|-------------|----------| | `asset_id` | string | | no | | `asset_version` | string | | no | | `group_id` | string | | no | | `organization_id` | string | | no | | `template_id` | string | | no | ### fetch_control_ruleset **Fetch Control Ruleset** Fetch a control ruleset payload by sourceRulesetKey. **Input Parameters:** | Parameter | Type | Description | Required | |-----------|------|-------------|----------| | `organization_id` | string | | no | | `source_ruleset_key` | string | | yes | ### fetch_cost_instance_timeseries **Fetch Cost Instance Timeseries** Use this tool to get token usage and response time timeseries for a single MCP server instance. Returns time-bucketed data points with totalTokens, tokenDelta, and avgResponseTimeMs per bucket. Supports time_range values: 1h, 6h, 24h, 7d, 30d. Example: fetch_cost_instance_timeseries(organization_id=<org_id>, instance_id=<instance_id>, time_range='7d'). For org-wide overview, use fetch_cost_overview instead. **Input Parameters:** | Parameter | Type | Description | Required | |-----------|------|-------------|----------| | `instance_id` | string | | yes | | `organization_id` | string | | yes | | `time_range` | string | | no | ### fetch_cost_instances **Fetch Cost Instances** Use this tool to get per-instance token usage with optimization coverage. Each instance includes totalTokens, tokenDelta (tokens saved), avgResponseTimeMs, toolsListTokens, toolsCallTokens, environmentId, organizationId, appliedPolicies, appliedCostPolicyIds, unappliedCostPolicyIds, and optimizationCoverage (0-1). Response also includes a policyTemplates lookup (templateId -> name, description). Use filter_unoptimized=true to find instances with unapplied cost policies. Supports time_range values: 1h, 6h, 24h, 7d, 30d. Use top_n to limit results (default 10, max 50). Use sort_by to change ordering (totalTokens, tokenDelta, avgResponseTimeMs, totalCalls, tokensPerCall). To optimize a specific instance, use the unappliedCostPolicyIds list with prepare_policy_creation(asset_id=<assetId>, policy_name_hint=<policy_id>). Example: fetch_cost_instances(organization_id=<org_id>, time_range='30d', filter_unoptimized=true). **Input Parameters:** | Parameter | Type | Description | Required | |-----------|------|-------------|----------| | `filter_unoptimized` | boolean | | no | | `organization_id` | string | | yes | | `sort_by` | string | | no | | `time_range` | string | | no | | `top_n` | integer | | no | ### fetch_cost_optimization_recommendations **Fetch Cost Optimization Recommendations** Use this tool to get a ranked list of MCP server instances that should be optimized, mirroring the 'Recommended Optimizations' card on the Cost Management page. Filters to active instances (usage in window) that have at least one unapplied cost policy, projects token savings from Exchange tool metadata using the same rate analyzers as the UI, and returns the top N by projected savings. Each recommendation includes instanceId, instanceName, serverName, assetId, environment, totalTokens, projectedTokensSaved, projectedSavingsPercent, unappliedCostPolicyIds, and perPolicyProjections (policyId, policyName, rate 0-1, tokensSaved). Supports time_range values: 1h, 6h, 24h, 7d, 30d. top_n defaults to 3, max 10. Answers questions like 'what should I optimize next?', 'biggest token savings opportunities?', 'where is the most waste?'. Follow up with prepare_policy_creation(asset_id=<assetId>, policy_name_hint=<policyId>) to apply a policy. Example: fetch_cost_optimization_recommendations(organization_id=<org_id>, time_range='30d', top_n=3). **Input Parameters:** | Parameter | Type | Description | Required | |-----------|------|-------------|----------| | `organization_id` | string | | yes | | `savings_pool_size` | integer | | no | | `time_range` | string | | no | | `top_n` | integer | | no | ### fetch_cost_overview **Fetch Cost Overview** Use this tool to get org-wide token usage KPIs for MCP servers: total tokens, saved tokens (from optimization policies), and total tool calls. Optionally includes token usage timeseries. Supports time_range values: 1h, 6h, 24h, 7d, 30d. Use include_timeseries=true for chart data (increases response size). Example: fetch_cost_overview(organization_id=<org_id>, time_range='30d'). For per-instance breakdown, use fetch_cost_instances instead. **Input Parameters:** | Parameter | Type | Description | Required | |-----------|------|-------------|----------| | `include_timeseries` | boolean | | no | | `organization_id` | string | | yes | | `time_range` | string | | no | ### fetch_governance_service_report **Fetch Governance Service Report** Use this tool to get detailed governance conformance data for a single service. Returns the service summary, per-ruleset details with violation/warning counts, rule-level messages, and instance-level policy conformance when available. Use this after fetch_governance_services to drill into one service, or when the user asks about a specific service's governance status. Example: fetch_governance_service_report(organization_id=<organization_id>, service_id=<service_id>). Example: fetch_governance_service_report(organization_id=<organization_id>, service_id=<service_id>, api_version=<version>, include_rule_messages=true). **Input Parameters:** | Parameter | Type | Description | Required | |-----------|------|-------------|----------| | `api_version` | string | | no | | `include_rule_messages` | boolean | | no | | `organization_id` | string | | yes | | `service_id` | string | | yes | | `version` | string | | no | ### fetch_governance_services **Fetch Governance Services** Use this tool to search, filter, and count governance conformance across services. Returns lightweight rows with conformance status, concern-area breakdowns, error/warning/info counts, and violated rulesets for each matched service. Supports filtering by conformance status, concern area, ruleset, provider, service type, severity thresholds, and text query. Returns aggregate totals alongside paged results. Canonical conformance values: compliant, non-compliant, pending. Concern area IDs include: security-privacy, consumption-economic-governance, structural-conformity-lifecycle. Canonical provider values: mulesoft, kong, apigee, aws, azure. Example: fetch_governance_services(organization_id=<organization_id>, conformance_status_in=[<status>]). Example: fetch_governance_services(organization_id=<organization_id>, provider_in=[<provider>], limit=<n>). For detailed drill-down into one service, use fetch_governance_service_report instead. IMPORTANT: The totals object already contains aggregate counts for all matched services (statusTotals, concernTotals, providerTotals, messageTotals). providerTotals breaks down services per provider with compliant/non-compliant/pending counts. Do NOT paginate through all pages to count services yourself — use the totals. Synthesize your answer from the first page of results plus the totals. Only call again with different filters if the first result set doesn't match the user's question. **Input Parameters:** | Parameter | Type | Description | Required | |-----------|------|-------------|----------| | `concern_area_ids` | string | | no | | `conformance_status_in` | string | | no | | `include_rule_messages` | boolean | | no | | `include_rulesets` | boolean | | no | | `limit` | integer | | no | | `min_errors` | string | | no | | `min_infos` | string | | no | | `min_warnings` | string | | no | | `offset` | integer | | no | | `organization_id` | string | | yes | | `provider_in` | string | | no | | `q` | string | | no | | `ruleset_ids_in` | string | | no | | `service_ids` | string | | no | | `service_type_in` | string | | no | ### fetch_monitoring_drill_down **Fetch Monitoring Drill-Down** Use this tool to rank services or instances contributing to a specific performance metric (availability, reliability, avgLatency, requestVolume, errorRate, policyViolations). Powers the Performance view's drill-down drawer and answers questions like "which services are driving errors?" or "rank instances by latency". Filter by entity_type (apis/agents/mcp-servers/llms), service_id (narrow to one service's instances), instance_id (single instance), environments list, or providers list. Free-text `search` matches service/instance/environment names. Returns MetricContributorRow[] plus pagination metadata (totalRows, offset, pageSize). Example: fetch_monitoring_drill_down(metric='errorRate', time_range='24h'). Example: fetch_monitoring_drill_down(metric='avgLatency', entity_type='apis', sort_dir='desc'). **Input Parameters:** | Parameter | Type | Description | Required | |-----------|------|-------------|----------| | `entity_type` | string | | no | | `environment` | string | | no | | `environments` | string | | no | | `instance_id` | string | | no | | `limit` | integer | | no | | `metric` | string | | yes | | `offset` | integer | | no | | `organization_id` | string | | no | | `providers` | string | | no | | `search` | string | | no | | `service_id` | string | | no | | `sort_dir` | string | | no | | `sort_field` | string | | no | | `time_range` | string | | no | ### fetch_monitoring_instance **Fetch Monitoring Instance** Use this tool to get monitoring data for a single API instance: time-series charts (requests, error rate, latency, policy violations), top endpoints by traffic, and top clients by traffic. Requires organization_id, asset_id, and ideally instance_id. If instance_id is omitted, the first available instance is selected. Supports time_range values: 1h, 6h, 24h, 7d, 30d. Supports environment values: production, sandbox, unknown. Only MuleSoft-managed instances have monitoring data. Example: fetch_monitoring_instance(organization_id=<organization_id>, asset_id=<asset_id>, instance_id=<instance_id>, time_range=<time_range>, environment=<environment>). Example: fetch_monitoring_instance(organization_id=<organization_id>, asset_id=<asset_id>). For org-wide health overview, use fetch_monitoring_overview instead. **Input Parameters:** | Parameter | Type | Description | Required | |-----------|------|-------------|----------| | `api_version` | string | | no | | `asset_id` | string | | yes | | `asset_version` | string | | no | | `environment` | string | | no | | `instance_id` | string | | no | | `organization_id` | string | | yes | | `time_range` | string | | no | ### fetch_monitoring_overview **Fetch Monitoring Overview** Use this tool to get an org-wide monitoring health snapshot: total requests, error rate, average latency, availability, reliability, and compact trend charts. Returns KPI summary plus time-series data for request volume, error rate, average latency, and error volume over the selected time range and environment. Supports time_range values: 1h, 6h, 24h, 7d, 30d. Supports environment values: production, sandbox, unknown. Supports provider filter: currently only 'mulesoft' returns monitoring data. Other providers (kong, apigee, aws, azure) will return empty results. Canonical provider values: mulesoft, kong, apigee, aws, azure. Example: fetch_monitoring_overview(organization_id=<organization_id>, time_range=<time_range>, environment=<environment>). Example: fetch_monitoring_overview(organization_id=<organization_id>, time_range=<time_range>, environment=<environment>, provider=<provider>). For instance-level monitoring drill-down, use fetch_monitoring_instance instead. **Input Parameters:** | Parameter | Type | Description | Required | |-----------|------|-------------|----------| | `environment` | string | | no | | `include_charts` | boolean | | no | | `organization_id` | string | | yes | | `provider` | string | | no | | `time_range` | string | | no | ### fetch_service_facets **Fetch Service Facets** Use this tool when you need aggregate counts/buckets for summaries, dashboards, or filter panels, not full service-row hydration. Prefer this tool over fetch_services when the user asks 'how many', 'breakdown by type/status/provider', or other distribution insights. Fetches facet aggregates for exactly one required business_group_id. Supports either text query (q) OR typed filtering/aggregates; when q is provided, do not send filters or aggregates. Canonical typed values are api classifiers (rest-api, http-api, graphql, soap-api, grpc-api, evented-api) plus agent and mcp, and common aliases are normalized before filtering. Canonical provider values include: mulesoft, kong, apigee, aws, azure, openai, anthropic, aws-bedrock, google-vertex, agentforce, microsoft-copilot, godaddy-ans, langsmith, mistral, meta. filters MUST be a JSON object, never a Lucene-style string. Supported filter fields: providerIn (list of canonical provider strings), statusIn, apiCategoryIn, environmentTypeIn, complianceStatusIn, hasInstances (bool), hasActiveInstance (bool). Example (typed facets): fetch_service_facets(business_group_id=<business_group_id>, asset_types=[<asset_type>, ...], aggregates={'totalHits': True, 'byType': True, 'byProvider': True}). Example (query facets): fetch_service_facets(business_group_id=<business_group_id>, q=<search_query>). Returns structured payload with aggregates, total, and query context metadata. If the user then asks for specific assets, follow with fetch_services. **Input Parameters:** | Parameter | Type | Description | Required | |-----------|------|-------------|----------| | `aggregates` | string | | no | | `asset_types` | string | | no | | `business_group_id` | string | | yes | | `filters` | string | | no | | `q` | string | | no | | `size` | integer | | no | ### fetch_services **Fetch Services** Use this tool when you need concrete service rows (for example asset IDs/names, detail selection, or navigation affordances). Prefer this tool over fetch_service_facets when the user asks 'which assets' or requests item-level results. Fetches lightweight services for exactly one required business_group_id. Searches the user's business group AND the MuleSoft public catalog overlay for agent / mcp / llm asset types — public providers like GoDaddy ANS, Salesforce Agentforce, LangSmith, Microsoft Copilot, OpenAI, Anthropic, AWS Bedrock surface here. API asset types (rest-api, http-api, graphql, soap-api, grpc-api, evented-api) are user-org-only by design — the public overlay carries no API rows, so APIs are not affected. Supports either text query (q) OR typed filtering/aggregates; when q is provided, do not send filters or aggregates. Canonical typed values are api classifiers (rest-api, http-api, graphql, soap-api, grpc-api, evented-api) plus agent and mcp. The tool normalizes common aliases/plurals (for example api/apis, rest, openapi, asyncapi, agents, mcp-servers) to canonical values before filtering. Returns structured payload with services, assets (alias), total, and optional aggregates. Service rows include a provider field. Canonical provider values include: mulesoft, kong, apigee, aws, azure, openai, anthropic, aws-bedrock, google-vertex, agentforce, microsoft-copilot, godaddy-ans, langsmith, mistral, meta. If you only need counts/buckets (no row hydration), use fetch_service_facets instead. filters MUST be a JSON object, never a Lucene-style string. Supported filter fields: providerIn (list of canonical provider strings), statusIn, apiCategoryIn, environmentTypeIn, complianceStatusIn, hasInstances (bool), hasActiveInstance (bool). Example (typed rows): fetch_services(business_group_id=<business_group_id>, asset_types=[<asset_type>, ...], size=<n>). Example (provider-filtered): fetch_services(business_group_id=<business_group_id>, asset_types=['agent'], filters={'providerIn': ['godaddy-ans']}, size=50). Example (text search): fetch_services(business_group_id=<business_group_id>, q=<search_query>, size=<n>). Service rows include affordances and links for downstream navigation/actions. IMPORTANT: Do NOT paginate through all results by calling this tool multiple times with different offsets. Use the first page of results to synthesize your answer. Only call again with different filters if the first result set is clearly irrelevant to the user's question. **Input Parameters:** | Parameter | Type | Description | Required | |-----------|------|-------------|----------| | `aggregates` | string | | no | | `asset_types` | string | | no | | `business_group_id` | string | | yes | | `filters` | string | | no | | `include_affordances` | boolean | | no | | `q` | string | | no | | `size` | integer | | no | ### get_business_group **Get Business Group** Get full metadata for a business group by its ID. **Input Parameters:** | Parameter | Type | Description | Required | |-----------|------|-------------|----------| | `group_id` | string | | yes | ### get_mcp_server_state **Get MCP Server State** Read the deployed state of a catalog-managed MCP server. Returns current systems, tools, and upstream IDs needed for editing. **Input Parameters:** | Parameter | Type | Description | Required | |-----------|------|-------------|----------| | `asset_id` | string | | no | | `environment_id` | string | | no | | `organization_id` | string | | yes | | `server_name` | string | | no | ### get_omni_gateway_target_domains **Get Omni Gateway Target Domains** Get ingress domains and app unique id for a managed Omni Gateway target. **Input Parameters:** | Parameter | Type | Description | Required | |-----------|------|-------------|----------| | `environment_id` | string | | yes | | `organization_id` | string | | no | | `provider_id` | string | | no | | `target_id` | string | | yes | ### get_omni_gateway_usage_report **Get Omni Gateway Usage Report** Get current managed Omni Gateway size entitlement usage. **Input Parameters:** | Parameter | Type | Description | Required | |-----------|------|-------------|----------| | `organization_id` | string | | no | | `provider_id` | string | | no | ### get_policy_template_form **Get Policy Template Form** Load one policy template detail, including configuration schema, to dynamically render the creation form. Use this immediately after the user selects a policy in prepare_policy_creation. For non-MuleSoft providers, pass provider and gateway_id alongside template_id. **Input Parameters:** | Parameter | Type | Description | Required | |-----------|------|-------------|----------| | `api_instance_id` | string | | no | | `asset_id` | string | | no | | `asset_version` | string | | no | | `direction` | string | | no | | `environment_id` | string | | no | | `gateway_id` | string | | no | | `group_id` | string | | no | | `organization_id` | string | | yes | | `provider` | string | | no | | `template_id` | string | | no | ### get_provision_status **Get Provision Status** Poll the status of a provisioning or update job. Returns status (running/complete/failed), progress step, completed steps, result (MCP URL on success), and can_resume flag. **Input Parameters:** | Parameter | Type | Description | Required | |-----------|------|-------------|----------| | `job_id` | string | | yes | | `organization_id` | string | | no | ### get_trusted_mcp_catalog **Get Trusted MCP Catalog** Return the catalog of SaaS systems available for MCP server provisioning. Each item includes tools, auth type, credential fields, and upstream config. **Input Parameters:** | Parameter | Type | Description | Required | |-----------|------|-------------|----------| | `organization_id` | string | | no | ### list_agents **List Agents** List agents registered in the MuleSoft Platform for a given organization. Presents an interactive UI for browsing, filtering, and selecting agents. **Input Parameters:** | Parameter | Type | Description | Required | |-----------|------|-------------|----------| | `name` | string | | no | | `organization_id` | string | | no | | `provider` | string | | no | ### list_apis **List APIs** List APIs from the MuleSoft Platform catalog for a given organization. Presents an interactive UI for browsing, filtering, and selecting APIs. **Input Parameters:** | Parameter | Type | Description | Required | |-----------|------|-------------|----------| | `api_category` | string | | no | | `name` | string | | no | | `organization_id` | string | | no | | `provider` | string | | no | ### list_business_groups **List Business Groups** List available business groups, optionally filtering by name. **Input Parameters:** | Parameter | Type | Description | Required | |-----------|------|-------------|----------| | `name` | string | | no | ### list_governance_strategies **List Governance Strategies** List governance strategies for an organization. Shows the same searchable and filterable table style as the main web app. **Input Parameters:** | Parameter | Type | Description | Required | |-----------|------|-------------|----------| | `organization_id` | string | | no | | `strategy_type` | string | | no | ### list_llms **List LLMs** List LLM models registered in the MuleSoft Platform for a given organization. Presents an interactive UI for browsing, filtering, and selecting LLMs. **Input Parameters:** | Parameter | Type | Description | Required | |-----------|------|-------------|----------| | `category` | string | | no | | `name` | string | | no | | `organization_id` | string | | no | | `provider` | string | | no | ### list_mcp_servers **List MCP Servers** List MCP servers registered in the MuleSoft Platform for a given organization. Presents an interactive UI for browsing, filtering, and selecting MCP servers. **Input Parameters:** | Parameter | Type | Description | Required | |-----------|------|-------------|----------| | `name` | string | | no | | `organization_id` | string | | yes | | `protocol` | string | | no | ### list_omni_gateway_environments **List Omni Gateway Environments** List Anypoint environments available for managed Omni Gateway creation. **Input Parameters:** | Parameter | Type | Description | Required | |-----------|------|-------------|----------| | `organization_id` | string | | no | | `provider_id` | string | | no | ### list_omni_gateway_targets **List Omni Gateway Targets** List managed Omni Gateway deployment targets for an environment. **Input Parameters:** | Parameter | Type | Description | Required | |-----------|------|-------------|----------| | `environment_id` | string | | yes | | `organization_id` | string | | no | | `provider_id` | string | | no | ### list_provider_gateways **List Provider Gateways** List gateways for the active provider. Today only MuleSoft is supported (Kong / Apigee are roadmap), so the tool defaults ``provider_id`` to ``provider-mulesoft`` and returns Omni Gateways without requiring ``select_active_provider`` to be called first. ``organization_id`` defaults to the caller's active Anypoint org. Both parameters are optional. **Input Parameters:** | Parameter | Type | Description | Required | |-----------|------|-------------|----------| | `organization_id` | string | | no | | `provider_id` | string | | no | ### list_scanner_providers **List Scanner Providers** Get the list of available scanner providers (Google Vertex, Microsoft Copilot, etc.) ### login **Login to MuleSoft Platform** Authenticate with MuleSoft Platform. MUST be called before any other tool. Call WITHOUT arguments to display the interactive login panel where the user enters their credentials. Do NOT ask the user for username/password in the chat. **Input Parameters:** | Parameter | Type | Description | Required | |-----------|------|-------------|----------| | `password` | string | | no | | `username` | string | | no | ### logout **Logout from MuleSoft Platform** Clear the stored authentication token. ### prepare_automated_policy_creation **Prepare Automated Policy Creation** Open the automated-policy creation wizard with scope options and policy templates. **Input Parameters:** | Parameter | Type | Description | Required | |-----------|------|-------------|----------| | `organization_id` | string | | no | ### prepare_control_creation **Prepare Control Creation** Open the control creation wizard with scope options and control rule catalog data, using the same scope, selection, and naming flow as the web app. **Input Parameters:** | Parameter | Type | Description | Required | |-----------|------|-------------|----------| | `organization_id` | string | | no | ### prepare_policy_creation **Prepare Policy Creation** Load policy options for one asset instance. Returns only policies that are not already applied. Accepts api_instance_id (numeric) or asset_id (Exchange asset ID) — when asset_id is provided the numeric instance ID is resolved automatically. Pass policy_name_hint to filter the list to policies matching a name — use this when the user names a specific policy. After the user selects a policy from the selector UI, call get_policy_template_form with the same organization_id, environment_id, api_instance_id, plus the selected template_id/asset_id/group_id/asset_version/direction to open the policy form UI. Set provider to a non-MuleSoft platform (e.g. 'kong') and gateway_id to dispatch to that provider's policy backend instead of Anypoint API Manager. **Input Parameters:** | Parameter | Type | Description | Required | |-----------|------|-------------|----------| | `api_instance_id` | string | | no | | `asset_id` | string | | no | | `environment_id` | string | | no | | `gateway_id` | string | | no | | `organization_id` | string | | yes | | `policy_name_hint` | string | | no | | `provider` | string | | no | ### provision_mcp_server **Provision MCP Server** Provision a composite MCP server on Omni Gateway from selected catalog systems. Returns a job_id — poll with get_provision_status until complete or failed. PRECONDITIONS: organization_id and environment_id must be UUIDs (call list_business_groups + list_environments first — do NOT pass friendly names like 'development'). target_id / target_name come from list_provider_gateways. Each servers[] entry needs assetId + tools[] from get_trusted_mcp_catalog (the catalog tools include the upstream config and credential schema). If any lookup returns no usable entry, STOP and ask the user — do not invent IDs. **Input Parameters:** | Parameter | Type | Description | Required | |-----------|------|-------------|----------| | `base_path` | string | | yes | | `environment_id` | string | | yes | | `organization_id` | string | | yes | | `server_name` | string | | yes | | `servers` | array | | yes | | `target_id` | string | | yes | | `target_name` | string | | yes | ### resume_provision_job **Resume Provision Job** Resume a failed provisioning or update job from its last checkpoint. Only works on jobs with status 'failed' that have completed steps. **Input Parameters:** | Parameter | Type | Description | Required | |-----------|------|-------------|----------| | `job_id` | string | | yes | | `organization_id` | string | | no | ### search_assets_semantic **Semantic Search Portfolio Assets** Search portfolio assets using natural language semantic search. Use this when the user asks for assets related to a concept or use case, not just keyword matching. Examples: 'Find services for payment processing', 'Search for customer authentication services'. Returns asset names, descriptions, relevance scores, and types. **Input Parameters:** | Parameter | Type | Description | Required | |-----------|------|-------------|----------| | `asset_type` | string | | no | | `organization_id` | string | | no | | `query` | string | | yes | | `rows` | integer | | no | ### search_global_content **Search Global Content** UI tool for embedded agents to search content across agents, MCP servers, and APIs in the MuleSoft Platform. Returns ranked results and an embeddable command-palette UI. You must pass exactly one business_group_id (Anypoint business group ID) for each search request. **Input Parameters:** | Parameter | Type | Description | Required | |-----------|------|-------------|----------| | `business_group_id` | string | | yes | | `query` | string | | yes | | `size` | integer | | no | ### search_portfolio_services 🔍 PRIMARY DISCOVERY TOOL - ALWAYS USE THIS FIRST when user wants to FIND/SEARCH/DISCOVER assets by what they DO or their capabilities. USE THIS TOOL WHEN USER ASKS: - 'find [type] that can [action]' → e.g., 'find agents that can automate invoices', 'find APIs that handle payments' - 'search for [capability] [type]' → e.g., 'search for customer support agents', 'search for fraud detection APIs' - '[type] for [use case]' → e.g., 'agents for employee wellbeing', 'LLMs for code generation' - 'what [type] are available for [use case]' → e.g., 'what MCP servers are available for data transformation' - 'which [type] can [capability]' → e.g., 'which agents can automate approval', 'which LLMs generate SQL' - '[type] that [action]' → e.g., 'agents that automate workflows', 'APIs that detect fraud' EXAMPLES REQUIRING THIS TOOL: ✓ 'find payment APIs' ← semantic match by purpose ✓ 'search for customer support agents' ← capability-based discovery ✓ 'agents for employee wellbeing' ← use case discovery ✓ 'LLMs that can generate SQL queries' ← capability matching ✓ 'APIs for fraud detection' ← functional discovery ✓ 'what MCP servers handle data transformation' ← capability query ✓ 'agents that automate invoice approval' ← workflow discovery ASSET_TYPE PARAMETER: Leave empty ("") to search across ALL asset types — that is the right choice for most user prompts ('find APIs that…' usually means 'find any matching asset, an API or otherwise'). When you DO want to constrain, prefer a canonical Exchange type: • API types: 'rest-api', 'http-api', 'graphql', 'soap-api', 'grpc-api', 'evented-api' • AI types: 'agent', 'mcp', 'mcp-server', 'llm', 'model' • Infra types: 'vector-database', 'gateway' Friendly aliases ('apis', 'agents', 'mcp-servers', 'llms') are also accepted and expand to the matching canonical set, so 'apis' searches all API subtypes. DO NOT USE fetch_services FOR DISCOVERY: ❌ fetch_services only lists ALL assets without semantic/capability matching ❌ fetch_services cannot find assets by what they DO ✅ Use THIS tool (search_portfolio_services) for discovery by capability/use case ✅ Only use fetch_services AFTER this tool, if you need additional metadata DO NOT USE THIS TOOL FOR: ✗ Performance metrics (use fetch_monitoring_*) ✗ Cost analysis (use fetch_cost_*) ✗ Governance/policy data (use fetch_governance_*) ✗ Listing all deployed instances (use fetch_services) ✗ Documentation/how-to guides (use search_repository_knowledge) Returns: Semantically matched assets with names, descriptions, versions, and relevance scores. **Input Parameters:** | Parameter | Type | Description | Required | |-----------|------|-------------|----------| | `asset_type` | string | | no | | `max_results` | integer | | no | | `query` | string | | yes | ### search_repository_knowledge **Search Repository Knowledge** Use this tool for repository-grounded conceptual questions. It searches a curated static corpus (policy/governance/security docs and rulesets) and returns cited snippets. Prefer this tool for prompts like 'what policies can I use to secure access to my APIs' or 'where is X documented'. Returns structured matches with sourcePath, snippet, lexical/semantic scores, and metadata. This tool is read-only and does not modify repository files. Use top_k to bound result size and source_path_prefixes for targeted lookup. **Input Parameters:** | Parameter | Type | Description | Required | |-----------|------|-------------|----------| | `lexical_top_n` | integer | | no | | `query` | string | | yes | | `source_path_prefixes` | string | | no | | `top_k` | integer | | no | ### select_active_business_group **Select Active Business Group** Get the current active business group context and optionally set a new active business group by passing business_group_id. Use this for app-level context updates without launching the business group selector UI. **Input Parameters:** | Parameter | Type | Description | Required | |-----------|------|-------------|----------| | `business_group_id` | string | | no | | `name` | string | | no | ### select_active_environment **Select Active Environment** Browse the available Anypoint environments for the active MuleSoft provider and set one as the active environment context. **Input Parameters:** | Parameter | Type | Description | Required | |-----------|------|-------------|----------| | `environment_id` | string | | no | | `organization_id` | string | | no | | `provider_id` | string | | no | ### select_active_provider **Select Active Provider** Pick the active gateway provider context for Omni Gateway tools (e.g. list_provider_gateways and the Omni Gateway wizard). Two-phase: call with no provider_id to present the available providers, then call again with the selected provider_id to commit. Do NOT use this tool for managing MuleSoft / Anypoint account credentials, logging in, logging out, or switching Anypoint user accounts — those flows are handled by the Anypoint connected-app session and are not user-driven in Omni; under the connected-app setup users do not need to log in or out. **Input Parameters:** | Parameter | Type | Description | Required | |-----------|------|-------------|----------| | `provider_id` | string | | no | ### select_api_version **Select API Version** Show an interactive version selector for an API and notify the host when the user picks a version. **Input Parameters:** | Parameter | Type | Description | Required | |-----------|------|-------------|----------| | `asset_id` | string | | yes | | `organization_id` | string | | yes | ### show_observability_performance **Show Observability Dashboards** Load observability dashboards data for embedded MCP app rendering. **Input Parameters:** | Parameter | Type | Description | Required | |-----------|------|-------------|----------| | `environment` | string | | no | | `provider` | string | | no | | `time_range` | string | | no | ### test_scanner_connection **Test Scanner Connection** Test connection to a scanner provider before creating the scanner **Input Parameters:** | Parameter | Type | Description | Required | |-----------|------|-------------|----------| | `auth_fields` | string | | no | | `auth_method` | string | | no | | `provider` | string | | yes | ### update_mcp_server **Update MCP Server** Update an existing catalog-managed MCP server. Diffs new configuration against deployed state and applies incremental changes. Returns a job_id for status polling. PRECONDITIONS: requires the same UUID-based IDs as provision_mcp_server (organization_id, environment_id, target_id all UUIDs from list_* tools), plus the deployed state from get_mcp_server_state. Never pass friendly names — every ID must be a UUID or a catalog-supplied identifier. **Input Parameters:** | Parameter | Type | Description | Required | |-----------|------|-------------|----------| | `api_id` | integer | | yes | | `asset_id` | string | | yes | | `current_upstream_ids` | string | | no | | `deployed_systems` | string | | no | | `environment_id` | string | | yes | | `organization_id` | string | | yes | | `server_name` | string | | yes | | `servers` | array | | yes | | `target_id` | string | | yes | | `target_name` | string | | yes | ### view_agent_details **View Agent Details** Show read-only details for one agent, including versions, instances, and metadata. **Input Parameters:** | Parameter | Type | Description | Required | |-----------|------|-------------|----------| | `asset_id` | string | | yes | | `asset_version` | string | | no | | `organization_id` | string | | yes | ### view_api_instance_details **View API Instance Details** Show details for one API instance with a web-aligned header. Accepts either an instance object or identifiers to resolve it. **Input Parameters:** | Parameter | Type | Description | Required | |-----------|------|-------------|----------| | `api_version` | string | | no | | `asset_id` | string | | yes | | `asset_version` | string | | no | | `instance` | string | | no | | `instance_id` | string | | no | | `organization_id` | string | | yes | ### view_api_instance_monitoring **View API Instance Monitoring** Show instance monitoring charts, traffic, and clients for one API instance. **Input Parameters:** | Parameter | Type | Description | Required | |-----------|------|-------------|----------| | `api_version` | string | | no | | `asset_id` | string | | yes | | `asset_version` | string | | no | | `instance` | string | | no | | `instance_id` | string | | no | | `organization_id` | string | | yes | | `time_range` | string | | no | ### view_api_instance_policies **View API Instance Policies** Show the applied policies for one API instance with the same grouping UI as the web app. **Input Parameters:** | Parameter | Type | Description | Required | |-----------|------|-------------|----------| | `api_version` | string | | no | | `asset_id` | string | | yes | | `asset_version` | string | | no | | `instance` | string | | no | | `instance_id` | string | | no | | `organization_id` | string | | yes | ### view_api_version_details **View API Version Details** Show read-only details for one API version, including instances, metadata, and lifecycle fields. **Input Parameters:** | Parameter | Type | Description | Required | |-----------|------|-------------|----------| | `api_version` | string | | no | | `asset_id` | string | | no | | `asset_version` | string | | no | | `organization_id` | string | | no | | `version` | object | | yes | ### view_api_version_governance_report **View API Version Governance Report** Show governance ruleset report summary and findings for one API version. **Input Parameters:** | Parameter | Type | Description | Required | |-----------|------|-------------|----------| | `api_name` | string | | no | | `api_version` | string | | no | | `asset_id` | string | | yes | | `group_id` | string | | yes | | `organization_id` | string | | yes | | `version` | string | | yes | ### view_api_version_instances **View API Version Instances** Show available instances for one API version and allow selecting instances to send back to the host. **Input Parameters:** | Parameter | Type | Description | Required | |-----------|------|-------------|----------| | `api_version` | string | | yes | | `asset_id` | string | | yes | | `asset_version` | string | | no | | `organization_id` | string | | yes | ### view_governance_report **View Governance Report** Service-centric governance rollup. Returns one row per cataloged service with its applied controls nested. Each service row carries compliance status, total violation/warning counts, and a list of controls (one per control evaluated against the service) with per-control violation/warning counts. Drill into one service with view_service_governance_findings to see the rule-level findings. **Input Parameters:** | Parameter | Type | Description | Required | |-----------|------|-------------|----------| | `organization_id` | string | | yes | ### view_llm_details **View LLM Details** Show read-only details for one LLM model, including versions, instances, and metadata. **Input Parameters:** | Parameter | Type | Description | Required | |-----------|------|-------------|----------| | `asset_id` | string | | yes | | `asset_version` | string | | no | | `organization_id` | string | | yes | ### view_mcp_server_details **View MCP Server Details** Show read-only details for one MCP server, including versions, instances, and metadata. **Input Parameters:** | Parameter | Type | Description | Required | |-----------|------|-------------|----------| | `asset_id` | string | | yes | | `asset_version` | string | | no | | `organization_id` | string | | yes | ### view_service_governance_findings **View Service Governance Findings** Show one service's per-ruleset findings (rule occurrences with severity + message + path), optionally narrowed to one control via control_id. Per-ruleset rule lists are capped at 100 with a 'truncated' marker; when truncated, ask the user to filter by ruleset for the full list. Call view_governance_report first to get the service_id (and control_id, if narrowing). **Input Parameters:** | Parameter | Type | Description | Required | |-----------|------|-------------|----------| | `control_id` | string | | no | | `organization_id` | string | | yes | | `service_id` | string | | yes | ## Resources (30) - `ui://agent-catalog/app.html` — Interactive HTML UI for browsing and selecting agents from the catalog - `ui://agent/details.html` — Read-only details panel for one agent - `ui://api-catalog/app.html` — Interactive HTML UI for browsing and selecting APIs from the catalog - `ui://api-instance/details.html` — Read-only details header for one API instance - `ui://api-instance/monitoring.html` — Instance monitoring view aligned with the web app monitoring tab - `ui://api-instance/policies.html` — Instance policy list aligned with the web app policies tab - `ui://api-version/details.html` — Read-only details panel for one API version - `ui://api-version/governance-report.html` — Governance report view for one API version - `ui://api-version/instances.html` — Interactive selector for API instances by version - `ui://api-version/selector.html` — Interactive selector for API versions - `ui://asset-instance/policy-form.html` — Render a policy configuration schema and trigger policy creation - `ui://asset-instance/policy-selector.html` — Select a policy not yet applied for one asset instance - `ui://auth/login-v2.html` — Interactive login panel for MuleSoft Platform authentication - `ui://business-groups/app.html` — Interactive HTML UI for browsing and selecting business groups - `ui://environment-selector/app.html` — Interactive selector for the active environment context - `ui://flex-gateway/wizard.html` — Interactive wizard for creating a managed Omni Gateway - `ui://global-search/app.html` — Embeddable command-palette style UI for global asset search - `ui://governance-report/app.html` — Interactive service-centric governance rollup with per-service findings drill-down. - `ui://governance-strategies/list.html` — Interactive list of governance strategies - `ui://governance/automated-policy-creation.html` — Interactive wizard for creating automated-policy governance strategies - `ui://governance/control-creation.html` — Interactive wizard for creating controls - `ui://llm-catalog/app.html` — Interactive HTML UI for browsing and selecting LLMs from the catalog - `ui://llm/details.html` — Read-only details panel for one LLM - `ui://mcp-server-catalog/app.html` — Interactive HTML UI for browsing and selecting MCP servers from the catalog - `ui://mcp-server-provisioning/app.html` — Interactive HTML UI for browsing the trusted MCP catalog, viewing provisioning status, and inspecting deployed server state - `ui://mcp-server/details.html` — Read-only details panel for one MCP server - `ui://observability/performance.html` — Render embedded observability dashboards directly in the MCP app. - `ui://provider-gateways/app.html` — Gateway inventory for the active provider - `ui://provider-selector/app.html` — Interactive selector for the active provider context - `ui://scanner/wizard-v2.html` — Interactive wizard for creating agent scanners