catalog-search

name	catalog-search
description	Catalog Search (Mendix Platform Service Registry) — mxcli catalog search for OData/REST/SOAP services registered at catalog.mendix.com
compatibility	opencode

Mendix Catalog CLI user — search and discover externally registered services at catalog.mendix.com.

> Search and discover services registered in Mendix Catalog (catalog.mendix.com) using the mxcli CLI. Covers authentication, search flags, output formats, pagination, and disambiguation from the local MDL CATALOG keyword.

Load when: - User wants to search for services in the Mendix organization catalog - Discovering OData, REST, or SOAP services registered on catalog.mendix.com - Using `mxcli catalog search` command

NOTE: This is the external Mendix Catalog service (CLI: mxcli catalog search), NOT the MDL CATALOG keyword which queries local project metadata tables (SELECT ... FROM CATALOG.entities). See browse-integrations skill for MDL CATALOG queries.

Catalog search requires a Personal Access Token (PAT):

# One-time setup
./mxcli auth login

Create a PAT at: https://user-settings.mendix.com/ (Developer Settings → Personal Access Tokens)

<basic_usage>

# Search for services
./mxcli catalog search "customer"

# Filter by service type
./mxcli catalog search "order" --service-type OData
./mxcli catalog search "api" --service-type REST

# Production endpoints only
./mxcli catalog search "inventory" --production-only

# Services you own
./mxcli catalog search "sales" --owned-only

# JSON output for scripting
./mxcli catalog search "data" --json | jq '.[] | {name, uuid, type}'

</basic_usage>

<output_formats>

Table (default):

NAME                TYPE   VERSION  APPLICATION           ENVIRONMENT   PROD  UUID
CustomerService     OData  1.2.0    CRM Application       Production    Yes   a7f3c2d1-4b5e-6c7f-8d9e-0a1b2c3d4e5f
OrderAPI            REST   2.0.1    E-commerce Platform   Acceptance    No    b8e4d3e2-1a2b-3c4d-5e6f-7a8b9c0d1e2f
InventorySync       SOAP   1.0.0    Warehouse System      Test          No    c9f5e4f3-2b3c-4d5e-6f7a-8b9c0d1e2f3a

Total: 42 results (showing 1-3)

• NAME: Service name (truncated if > 22 chars)
• TYPE: OData, REST, SOAP
• VERSION: Service version
• APPLICATION: Hosting application name
• ENVIRONMENT: Production, Acceptance, Test
• PROD: "Yes" if production, blank otherwise
• UUID: Full UUID (36 chars) - copy this for use with mxcli catalog show <uuid>

JSON mode:

./mxcli catalog search "customer" --json

Returns full endpoint details including complete UUIDs, descriptions, security classification, last updated timestamp, entity and action metadata (for OData).

</output_formats>

# First 10 results
./mxcli catalog search "api" --limit 10

# Next 10 results
./mxcli catalog search "api" --limit 10 --offset 10

# Maximum 100 per request
./mxcli catalog search "service" --limit 100

<common_use_cases>

# Find production OData services
./mxcli catalog search "customer" --service-type OData --production-only

# Get UUIDs for automation
./mxcli catalog search "order" --json | jq -r '.[] | .uuid'

# Generate service inventory report
./mxcli catalog search "api" --json | \
  jq -r '.[] | "\(.name) (\(.serviceType)) - \(.application.name)"'

# Filter by multiple criteria
./mxcli catalog search "data" \
  --service-type OData \
  --production-only \
  --limit 50

</common_use_cases>

Flag	Type	Default	Description
--profile	string	"default"	Auth profile name
--service-type	string	(all)	Filter by OData, REST, or SOAP
--production-only	bool	false	Show only production endpoints
--owned-only	bool	false	Show only owned services
--limit	int	20	Results per page (max 100)
--offset	int	0	Pagination offset
--json	bool	false	Output as JSON array

<error_handling>

No credential:

Error: no credential found. Run: mxcli auth login

Authentication failed:

Error: authentication failed. Run: mxcli auth login

Solution: Log in with a valid PAT. Catalog API requires internet connectivity.

</error_handling>

Mendix Catalog (this skill):

• What: External service registry at catalog.mendix.com
• CLI: mxcli catalog search "customer", mxcli catalog show <uuid>
• Purpose: Discover OData/REST/SOAP services across your organization
• Requires: Platform authentication (PAT token)
• Data source: Mendix cloud service

MDL CATALOG keyword (different concept):

• What: Local project metadata tables in the mxcli SQLite database
• MDL syntax: SELECT ... FROM CATALOG.entities, SHOW CATALOG TABLES
• Purpose: Query project structure (entities, microflows, pages, etc.)
• Requires: REFRESH CATALOG command (no auth needed)
• Data source: Your local .mpr file

<output_rules>Output MDL code only in code blocks. Keep explanations concise.</output_rules>