get_bill_detail
Retrieve detailed billing information for a specific month on Sakura Cloud. Input the year and month to generate accurate and structured billing data for your infrastructure.
Instructions
Get detailed billing information for a specific month
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| month | Yes | The month (MM) of the billing period | |
| year | Yes | The year (YYYY) of the billing period |
Implementation Reference
- src/server.ts:2146-2170 (handler)Handler for the 'get_bill_detail' tool. Extracts year and month parameters, calls Sakura Cloud API at `/bill/${year}${month}/detail` using the shared fetchFromSakuraCloud helper, and returns the detailed billing information as JSON text.} else if (request.params.name === 'get_bill_detail') { try { validateCredentials(); const year = request.params.arguments?.year as string; const month = request.params.arguments?.month as string; if (!year || !month) { throw new Error('Year and month are required for billing details'); } const billDetailInfo = await fetchFromSakuraCloud(`/bill/${year}${month}/detail`); return { content: [ { type: 'text', text: JSON.stringify(billDetailInfo, null, 2) } ] }; } catch (error) { console.error('Error calling tool:', error); throw error; }
- src/server.ts:1172-1188 (registration)Registration of the 'get_bill_detail' tool in the ListToolsRequestSchema handler, providing the tool's name, description, and input schema.name: 'get_bill_detail', description: 'Get detailed billing information for a specific month', inputSchema: { type: 'object', properties: { year: { type: 'string', description: 'The year (YYYY) of the billing period' }, month: { type: 'string', description: 'The month (MM) of the billing period' } }, required: ['year', 'month'] } },
- src/server.ts:1174-1186 (schema)Input schema for the 'get_bill_detail' tool, defining required 'year' and 'month' string parameters.inputSchema: { type: 'object', properties: { year: { type: 'string', description: 'The year (YYYY) of the billing period' }, month: { type: 'string', description: 'The month (MM) of the billing period' } }, required: ['year', 'month']
- src/server.ts:20-72 (helper)Shared helper function fetchFromSakuraCloud used by the get_bill_detail handler to make authenticated HTTPS requests to the Sakura Cloud API.async function fetchFromSakuraCloud(path: string, isPublicAPI: boolean = false, zone: string = DEFAULT_ZONE, method: string = 'GET', bodyData?: any): Promise<any> { return new Promise((resolve, reject) => { const basePath = isPublicAPI ? '/cloud/api/cloud/1.1' : `/cloud/zone/${zone}/api/cloud/1.1`; const options = { hostname: 'secure.sakura.ad.jp', port: 443, path: `${basePath}${path}`, method: method, headers: { 'Accept': 'application/json', 'Authorization': '', 'Content-Type': 'application/json' } }; // Add authorization for non-public APIs if (!isPublicAPI) { options.headers['Authorization'] = `Basic ${Buffer.from(`${SACLOUD_API_TOKEN}:${SACLOUD_API_SECRET}`).toString('base64')}`; } const req = https.request(options, (res) => { let data = ''; res.on('data', (chunk) => { data += chunk; }); res.on('end', () => { try { if (data) { const parsedData = JSON.parse(data); resolve(parsedData); } else { resolve({}); } } catch (err) { reject(new Error(`Failed to parse response: ${err}`)); } }); }); req.on('error', (error) => { reject(error); }); if (bodyData && (method === 'POST' || method === 'PUT')) { req.write(JSON.stringify(bodyData)); } req.end(); }); }