jfrog_get_specific_build
Retrieve detailed information for a specific build by name, with optional project scoping, using the JFrog MCP Server’s API capabilities.
Instructions
Get details for a specific build by name, optionally scoped to a project
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| buildName | Yes | Name of the build to retrieve | |
| project | No | Optional project key to scope the build search |
Implementation Reference
- tools/builds.ts:16-26 (handler)Core function implementing the tool logic: constructs the JFrog API URL for the specific build, makes a GET request using jfrogRequest, and parses the response with the output schema.
export async function getSpecificBuild(buildName: string, project?: string) { const url = project ? `/artifactory/api/build/${buildName}?project=${project}` : `/artifactory/api/build/${buildName}`; const response = await jfrogRequest(url, { method: "GET", }); return buildsSchemas.JFrogBuildDetailsSchema.parse(response); } - schemas/builds.ts:3-6 (schema)Zod input schema for the tool, defining buildName (required) and project (optional).
export const GetSpecificBuildSchema = z.object({ buildName: z.string().describe("Name of the build to retrieve"), project: z.string().optional().describe("Optional project key to scope the build search") }); - tools/builds.ts:32-41 (registration)Local registration of the tool: defines name, description, input schema, and handler wrapper that parses args and delegates to getSpecificBuild.
const getSpecificBuildTool = { name: "jfrog_get_specific_build", description: "Get details for a specific build by name, optionally scoped to a project", inputSchema: zodToJsonSchema(buildsSchemas.GetSpecificBuildSchema), //outputSchema: zodToJsonSchema(buildsSchemas.JFrogBuildDetailsSchema), handler: async (args: any) => { const parsedArgs = buildsSchemas.GetSpecificBuildSchema.parse(args); return await getSpecificBuild(parsedArgs.buildName, parsedArgs.project); } }; - tools/index.ts:13-23 (registration)Global registration: imports BuildsTools (containing jfrog_get_specific_build) and spreads it into the main tools array exported for use.
export const tools =[ ...RepositoryTools, ...BuildsTools, ...RuntimeTools, ...AccessTools, ...AQLTools, ...CatalogTools, ...CurationTools, ...PermissionsTools, ...ArtifactSecurityTools, ]; - schemas/builds.ts:8-14 (schema)Output schema used to parse the JFrog API response for build details.
export const JFrogBuildDetailsSchema = z.object({ uri: z.string(), buildsNumbers: z.array(z.object({ uri: z.string(), started: z.string().describe("Build start timestamp in ISO8601 format") })) });