/**
* Get photo albums from a specific band.
* @see https://developers.band.us/develop/guide/api/get_albums
*/
import { bandApiClient } from '../client.js';
import { Tool } from '@modelcontextprotocol/sdk/types.js';
export const ToolDefinition : Tool = {
name: "get_albums",
description: "Get photo albums from a specific band in BAND.",
inputSchema: {
type: "object",
properties: {
band_key: {
type: "string",
title: "Band ID",
description: "band ID"
}
},
required: ["band_key"]
},
outputSchema: {
type: "object",
properties: {
result_code: {
type: "number",
description: "Result code"
},
result_data: {
type: "object",
description: "Result data",
properties: {
paging: {
type: "object",
description: "Paging information"
},
items: {
type: "array",
description: "List of photo albums",
items: {
type: "object",
properties: {
photo_album_key: {
type: "string",
description: "photo album identifier"
},
name: {
type: "string",
description: "album name"
},
photo_count: {
type: "number",
description: "number of photos in album"
},
cover_photo: {
type: "object",
description: "album cover photo information"
},
created_at: {
type: "number",
description: "album created time"
}
}
}
}
}
}
},
required: ["result_code", "result_data"]
}
};
interface AlbumsResponse {
result_code: number;
result_data: {
paging: any;
items: any[];
};
}
export async function handleToolCall(band_key: string) {
const albumsData = await bandApiClient.get<AlbumsResponse>(
'/v2/band/albums',
{ band_key }
);
return {
content: [{
type: "text",
text: JSON.stringify(albumsData, null, 2)
}]
};
}
