Tool catalog¶
Every tool the MCP server registers. read tools never change anything. write tools change platform state,
and ⚠️ write marks tools that can replace or remove it. The guard after the access level says how a write
is applied: confirm returns a dry-run preview until called with confirm: true; preview token needs the
single-use token returned by the matching preview_* tool; immediate acts on the first call, so confirm
intent with the user first. Production environments add their own checks; see the safety model.
A ? marks an optional input.
Identity and organization¶
Start here to confirm access and discover environments.
| Tool | Access | Inputs | Summary |
|---|---|---|---|
whoami |
read | — | Returns the currently authenticated Anypoint Platform user, their username, email, organization name, and org ID. |
list_environments |
read | — | Lists all Anypoint environments in the organization (e.g. Development, Sandbox, Production). |
get_entitlements |
read | — | Returns the platform features and capacity licensed for this organization: vCore allocations (production/sandbox/design), Anypoint MQ quotas, Object Store limits, API Manager, monitoring, Runtime Fabric, autoscaling, alerts, and subscription type/expiration. |
Project profile¶
Bind a workspace to a named credential profile.
| Tool | Access | Inputs | Summary |
|---|---|---|---|
get_project_profile |
read | — | Returns the currently active Anypoint profile for this project, how it was resolved (flag, env, project-file, or default), and lists all available profiles. |
set_project_profile |
write · immediate | profile, directory? |
Binds the current project directory to a named Anypoint profile by writing .anypoint-connect.json. |
Applications — read¶
CloudHub 2.0 deployment state, specs, settings and cross-environment comparison.
| Tool | Access | Inputs | Summary |
|---|---|---|---|
list_apps |
read | environment |
Lists all Mule applications deployed in a CloudHub 2.0 environment. |
get_app_status |
read | appName, environment |
Returns detailed deployment information for a specific Mule application: status, artifact version (groupId:artifactId:version), Mule runtime version, resource allocation (CPU, memory, vCores), autoscaling config, JVM args, clustering, each replica's state and deployment location, the public URL, and last update timestamp. |
get_deployment_spec |
read | appName, environment |
Returns the full current deployment spec for a CloudHub 2.0 application — the "look before you leap" view used before a redeploy or rollback. |
get_app_resources |
read | environment |
Returns resource allocation for all apps in an environment: CPU/memory limits and reservations, vCores, replica count, autoscaling config, and JVM args. |
get_app_settings |
read | appName, environment |
Reads the application properties (configuration settings) for a deployed Mule application in CloudHub 2.0. |
compare_app_deployments |
read | env1, env2 |
Produces a side-by-side comparison of all application deployments across two environments. |
Applications — deploy¶
Publish and deploy artifacts. Existing apps only have their artifact reference changed unless you ask otherwise.
| Tool | Access | Inputs | Summary |
|---|---|---|---|
deploy_jar |
⚠️ write · confirm | jarPath, appName, environment, assetId?, assetVersion?, groupId?, runtime?, replicas?, region?, vcores?, properties?, secureProperties?, jvmArgs?, wait?, expectedSha256?, confirm? |
One-call deploy of a locally built Mule application JAR: publishes it to Exchange, then deploys it to CloudHub 2.0 — creating the app if it does not exist, or safely updating just the artifact ref if it does. |
deploy_app |
⚠️ write · confirm | appName, environment, groupId, artifactId, version, runtime?, replicas?, region?, vcores?, properties?, secureProperties?, jvmArgs?, confirm? |
Deploys or redeploys a Mule application to CloudHub 2.0 using Maven coordinates (groupId:artifactId:version) referencing an artifact already published to Exchange. |
update_app_artifact |
⚠️ write · confirm | appName, environment, version, artifactId?, groupId?, packaging?, wait?, confirm? |
Safely redeploys an existing CloudHub 2.0 application to a new artifact version by PATCHing ONLY the application reference. |
rollback_app |
⚠️ write · confirm | appName, environment, toVersion?, wait?, confirm? |
Rolls an existing CloudHub 2.0 application back to a previous artifact by PATCHing only the application reference (runtime, target, replicas, and settings are preserved). |
Applications — lifecycle¶
Restart, scale, stop, start, settings and deletion.
| Tool | Access | Inputs | Summary |
|---|---|---|---|
restart_app |
⚠️ write · immediate | appName, environment |
Initiates a rolling restart of a deployed Mule application by re-applying its desired state. |
scale_app |
⚠️ write · immediate | appName, environment, replicas |
Changes the number of running replicas for a CloudHub 2.0 application. |
stop_app |
⚠️ write · immediate | appName, environment |
Stops a running Mule application in CloudHub 2.0 without deleting the deployment. |
start_app |
write · immediate | appName, environment |
Starts a stopped Mule application in CloudHub 2.0. |
update_app_settings |
⚠️ write · immediate | appName, environment, properties?, secureProperties? |
Updates application properties for a deployed Mule application in CloudHub 2.0. |
delete_app |
⚠️ write · confirm | appName, environment, confirm?, expectedDeploymentId?, confirmProduction? |
Permanently deletes a CloudHub 2.0 application deployment while leaving its Exchange artifact and other Anypoint resources untouched. |
Logs¶
Raw application logs.
| Tool | Access | Inputs | Summary |
|---|---|---|---|
get_logs |
read | appName, environment, lines?, level?, search? |
Fetches the most recent log entries from a running Mule application. |
download_logs |
read | appName, environment, hoursBack, level? |
Downloads the full application log file and filters it to a specific time window. |
Log analysis¶
Clustered errors with context, recurring patterns and health statistics.
| Tool | Access | Inputs | Summary |
|---|---|---|---|
analyze_errors |
read | appName, environment, hoursBack?, limit? |
Analyzes error patterns in a Mule application's logs. |
get_log_patterns |
read | appName, environment, hoursBack?, topN? |
Identifies the most common recurring log message patterns in an application. |
get_log_stats |
read | appName, environment, hoursBack? |
Returns a statistical health summary of an application's logs: level distribution, error rate, error spikes (time windows with elevated errors), noise percentage, and unique transaction count. |
Monitoring¶
Traffic, failures, latency, JVM and host metrics. See Monitoring for how to read them.
| Tool | Access | Inputs | Summary |
|---|---|---|---|
get_metrics |
read | environment?, hoursBack?, appName?, groupBy? |
Traffic, latency and failures from Anypoint Monitoring. |
get_runtime_metrics |
read | environment, hoursBack?, appName? |
JVM and host health per worker/replica: total heap used (avg/peak) and committed; the old-generation pool with its limit and peak-to-limit ratio (the memory-pressure and leak signal); metaspace; old-generation GC collections and GC time inside the window; CPU count and physical RAM; system and process CPU load (avg/max); and average free physical memory. |
get_metrics_timeseries |
read | environment, signal, hoursBack?, granularity?, appName? |
Bucketed metrics for trend and incident analysis. |
raw_amql_query |
read | query, limit?, offset? |
Runs a freeform AMQL query against Anypoint Monitoring when the other metric tools do not answer the question. |
Exchange¶
Search assets, read specs and publish application JARs.
| Tool | Access | Inputs | Summary |
|---|---|---|---|
search_exchange |
read | query?, type?, limit? |
Searches Anypoint Exchange for reusable assets: API specifications (RAML, OAS), connectors, integration templates, examples, and policies. |
get_exchange_asset |
read | groupId, assetId, version? |
Returns detailed information about a specific Exchange asset including all published versions, dependencies, API instances, contact information, and file classifiers. |
download_api_spec |
read | groupId, assetId, version? |
Downloads the API specification file (RAML or OAS/Swagger) for an Exchange asset. |
publish_app_jar |
⚠️ write · confirm | jarPath, assetId?, assetVersion?, groupId?, expectedSha256?, confirm? |
Uploads a locally built Mule application JAR to Anypoint Exchange as a type "app" asset, using the Exchange v2 publication API (multipart, classifier mule-application). |
API Manager¶
API instances, policies and alerts.
| Tool | Access | Inputs | Summary |
|---|---|---|---|
list_api_instances |
read | environment |
Lists all managed API instances registered in API Manager for an environment. |
get_api_policies |
read | apiName, environment |
Returns the full policy chain and SLA tier configuration for a managed API instance. |
get_api_alerts |
read | apiName, environment |
Returns the configured alerts for a managed API instance. |
Design Center¶
Read projects and files; writes and Exchange publication go through single-use preview tokens.
| Tool | Access | Inputs | Summary |
|---|---|---|---|
list_design_center_projects |
read | — | Lists all API specification projects in Anypoint Design Center. |
list_design_center_branches |
read | project |
Lists branches for one exactly identified Design Center project. |
list_design_center_files |
read | project, branch? |
Lists all files and folders in a Design Center project branch. |
read_design_center_file |
read | project, filePath, branch? |
Reads the content of a specific file from a Design Center project. |
preview_create_design_center_project |
read | name, classifier |
Checks exact-name collisions and returns a single-use 10-minute token. |
create_design_center_project |
write · preview token | previewToken |
Consumes a single-use creation preview token and rechecks exact-name collision before creating the project. |
preview_sync_design_center_files |
read | project, files, branch?, commitMessage? |
Computes create, update, and unchanged actions with content hashes. |
sync_design_center_files |
⚠️ write · preview token | previewToken |
Consumes a single-use preview, locks once, aborts atomically on hash conflicts, batch-saves, and verifies every changed file. |
preview_publish_exchange_asset |
read | project, name, apiVersion, version, classifier, main, groupId, assetId, branch? |
Binds exact project, branch, coordinates, classifier, main file, API version, and source hash to a single-use token. |
publish_exchange_asset |
write · preview token | previewToken |
Consumes the publication token, rejects source drift, publishes once, then verifies the downloaded Exchange artifact hash. |
API Governance¶
Governance plans and conformance for API assets.
| Tool | Access | Inputs | Summary |
|---|---|---|---|
explain_api_governance_plan |
read | groupId, assetId, version?, filter? |
Reads the centralized governance rulesets that would apply to planned or published API coordinates. |
get_api_governance_conformance |
read | groupId, assetId, minorVersion, versions |
Reads centralized governance conformance for exact API asset versions, filtered by the caller permissions. |
Audit log¶
Who changed what, and when.
| Tool | Access | Inputs | Summary |
|---|---|---|---|
get_audit_log |
read | hoursBack?, actions?, objectTypes?, limit? |
Queries the Anypoint Platform audit log for recent changes: deployments, policy updates, user actions, configuration changes. |
Anypoint MQ¶
Queues, statistics, dead-letter inspection and publishing.
| Tool | Access | Inputs | Summary |
|---|---|---|---|
list_queues |
read | environment, region |
Lists all Anypoint MQ destinations (queues and exchanges) in an environment and region. |
get_queue_stats |
read | environment, region, queueId |
Fetches current statistics for an Anypoint MQ queue: messages visible (ready to consume), messages in-flight (being processed), and lifetime totals for sent, received, and acknowledged messages. |
get_dlq_messages |
read | environment, region, queueId, batchSize? |
Browses messages from an Anypoint MQ dead-letter queue without consuming them. |
publish_mq_message |
write · immediate | environment, region, queueId, body, headers?, properties? |
Publishes a message to an Anypoint MQ queue. |
Object Store¶
Stores, keys and values.
| Tool | Access | Inputs | Summary |
|---|---|---|---|
list_stores |
read | environment |
Lists all Object Store v2 stores in an environment. |
list_store_keys |
read | environment, storeId, startKey?, limit? |
Lists keys in an Object Store v2 store. |
get_store_value |
read | environment, storeId, key |
Retrieves a single value from an Object Store v2 store by key. |
put_store_value |
⚠️ write · immediate | environment, storeId, key, value, contentType? |
Creates or updates a value in an Object Store v2 store. |
delete_store_value |
⚠️ write · immediate | environment, storeId, key |
Deletes a specific key and its value from an Object Store v2 store. |