JFrog MCP Server

Instructions

Implementation Reference

• tools/permissions.ts:181-191 (registration)

  Tool registration object defining the 'jfrog_get_permission_target' tool, including name, description, input schema, and handler function that delegates to getPermissionTarget.

  const getPermissionTargetTool = {
    name: "jfrog_get_permission_target",
    description: "Get detailed information about a specific permission target",
    inputSchema: zodToJsonSchema(z.object({
      name: z.string().describe("The name of the permission target to retrieve")
    })),
    //outputSchema: zodToJsonSchema(PermissionTargetSchema),
    handler: async (args: any) => {
      return await getPermissionTarget(args.name);
    }
  };

• tools/permissions.ts:188-190 (handler)

  The tool's handler function which executes the logic by calling getPermissionTarget with the provided name argument.

  handler: async (args: any) => {
    return await getPermissionTarget(args.name);
  }

• tools/permissions.ts:76-81 (helper)

  Core helper function that makes the HTTP GET request to the JFrog API to fetch the permission target details and parses the response using PermissionTargetSchema.

  export async function getPermissionTarget(name: string) {
    const response = await jfrogRequest(`/access/api/v2/permissions/${name}`, {
      method: "GET",
    });
    return PermissionTargetSchema.parse(response);
  }

• tools/permissions.ts:45-54 (schema)

  Zod schema for validating the structure of a PermissionTarget object, used to parse the API response in getPermissionTarget.

  const PermissionTargetSchema = z.object({
    name: z.string(),
    resources: z.object({
      artifact: ArtifactResourceSchema.optional(),
      release_bundle: ReleaseBundleResourceSchema.optional(),
      build: BuildResourceSchema.optional()
    }),
    created_by: z.string().optional(),
    modified_by: z.string().optional()
  });

• tools/permissions.ts:184-186 (schema)

  Input schema for the tool, defining the required 'name' parameter converted to JSON schema for MCP.

  inputSchema: zodToJsonSchema(z.object({
    name: z.string().describe("The name of the permission target to retrieve")
  })),

• tools/permissions.ts:288-298 (registration)

  Local array registering multiple permission-related tools, including getPermissionTargetTool, exported for inclusion in main tools list.

  export const PermissionsTools = [
    listPermissionTargetsTool,
    getPermissionTargetTool,
    createPermissionTargetTool,
    updatePermissionTargetTool,
    deletePermissionTargetTool,
    getPermissionResourceTool,
    updatePermissionResourceTool,
    replacePermissionResourceTool,
    deletePermissionResourceTool
  ]; 

• tools/index.ts:13-23 (registration)

  Main tools export array that spreads PermissionsTools, thereby registering jfrog_get_permission_target among all available tools.

  export const tools =[
    ...RepositoryTools,
    ...BuildsTools,
    ...RuntimeTools,
    ...AccessTools,
    ...AQLTools,
    ...CatalogTools,
    ...CurationTools,
    ...PermissionsTools,
    ...ArtifactSecurityTools,
  ];