| name | JFrog Mission Control |
| description | Use when working with JFrog Mission Control -- managing JFrog Platform Deployments (JPDs), checking deployment health, auditing licenses, or listing proxies. Triggers on mentions of mission control, JPD, platform deployment, license, proxy, or deployment health. |
API transport: Prefer jf api (JFrog CLI 2.100.0+). See jf-api-patterns.md (path-only URLs; auth from jf config). Examples using curl with $JFROG_URL + bearer token are fallback when the CLI is missing or below 2.100.0.
JFrog Mission Control Skill
Authentication
All requests require an access token via the Authorization header:
Authorization: Bearer $JFROG_ACCESS_TOKEN
Base URL: https://$JFROG_URL/mc/api/v1/...
When authentication is needed, follow the login-flow.md procedure to resolve the active JFrog environment. The jf CLI is required and will be installed automatically if missing. The agent checks saved credentials via jf config show and asks which environment to use if multiple are saved. If none exist, the agent drives the web login flow and saves credentials via jf config add.
Core Concepts
| Concept | Description |
|---|
| JPD | JFrog Platform Deployment — an instance of the JFrog Platform (Artifactory + Xray + services) |
| License | Enterprise license attached to a JPD, with type and expiration |
| Proxy | Network proxy configured for outbound connections |
List All JPD Instances
Returns all JFrog Platform Deployment instances associated with the current platform.
curl -s -X GET "$JFROG_URL/mc/api/v1/jpds" \
-H "Authorization: Bearer $JFROG_ACCESS_TOKEN" | jq .
Returns an array of JPD objects, each with id, name, url, status, location, licenses, services, and tags.
Get JPD by ID
Returns details for a specific JPD instance.
curl -s -X GET "$JFROG_URL/mc/api/v1/jpds/${JPD_ID}" \
-H "Authorization: Bearer $JFROG_ACCESS_TOKEN" | jq .
Response includes full JPD details: status, location, license info, and service health.
Attach License to JPD
curl -s -X POST "$JFROG_URL/mc/api/v1/jpds/${JPD_ID}/attach_license" \
-H "Authorization: Bearer $JFROG_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"license_key": "your-license-key-here"}'
List Proxies
curl -s -X GET "$JFROG_URL/mc/api/v1/proxies" \
-H "Authorization: Bearer $JFROG_ACCESS_TOKEN" | jq .
Common Workflows
Monitor Platform Health Across Deployments
- List all JPDs to get an overview of all deployments
- Check each JPD's
status.code for HEALTHY, DEGRADED, or UNHEALTHY
- Inspect individual JPD services for detailed health information
Audit Licenses
- List all JPDs
- Review the
licenses array on each JPD for expiration dates (valid_through) and expired status
- Attach new licenses to JPDs as needed
Official Documentation
