browse-integrations

Browse Integration Services and Contracts

This skill covers discovering external services, browsing cached contracts, and querying integration assets via the MDL CATALOG (local project metadata).

⚠️ NOTE: This covers the MDL CATALOG keyword (SELECT ... FROM CATALOG.entities), NOT the Mendix Catalog CLI (mxcli catalog search). See .claude/skills/mendix/catalog-search for the external service registry.

When to Use This Skill

• User asks what external services are configured in the project
• User wants to see available entities or actions from an OData service
• User wants to browse a business event contract (AsyncAPI)
• User asks about integration catalog tables
• User wants to find entities available in a contract but not yet imported

Discovery: List All Services

-- All OData clients (consumed services)
show odata clients;

-- All published OData services
show odata services;

-- All consumed REST services
show rest clients;

-- All published REST services
show published rest services;

-- All business event services
show business event services;

-- All database connections
show database connections;

-- All external entities (imported from OData)
show external entities;

-- All external actions used in microflows
show external actions;

Contract Browsing: OData $metadata

create odata client auto-fetches and caches the $metadata XML from HTTP(S) URLs or reads it from local files. Browse it without network access:

Note: MetadataUrl supports:

• https://... or http://... — fetches from HTTP endpoint
• file:///abs/path — reads from local absolute path
• ./path or path/file.xml — reads from local relative path (resolved against .mpr directory)

Local metadata files enable offline development, reproducible testing, and version-pinned contracts. create odata client auto-fetches and caches the $metadata XML. Browse it without network access:

-- List all entity types from the contract
show contract entities from MyModule.SalesforceAPI;

-- List actions/functions
show contract actions from MyModule.SalesforceAPI;

-- Inspect a specific entity (properties, keys, navigation)
describe contract entity MyModule.SalesforceAPI.PurchaseOrder;

-- Generate a CREATE EXTERNAL ENTITY statement from the contract
describe contract entity MyModule.SalesforceAPI.PurchaseOrder format mdl;

-- Inspect an action's signature
describe contract action MyModule.SalesforceAPI.CreateOrder;