get_akciz_codes
Retrieve excise tax codes from the Georgian tax system for accurate waybill processing and compliance verification.
Instructions
Get akciz (excise) codes from RS.ge system. Optionally filter by search text.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| search | No | Optional search text to filter results |
Implementation Reference
- src/tools/get-dictionaries.ts:123-165 (handler)Main handler function that executes the tool: validates input with Zod schema, calls SOAP client.getAkcizCodes(), formats results (limits to 20, handles search), and manages errors.export async function executeGetAkcizCodes( client: RsWaybillSoapClient, input: unknown ): Promise<string> { const logger = getLogger(); try { const validated = getAkcizCodesInputSchema.parse(input || {}); logger.info('Getting akciz codes', { search: validated.search }); const codes = await client.getAkcizCodes(validated.search); if (codes.length === 0) { return validated.search ? `No akciz codes found matching "${validated.search}"` : 'No akciz codes found'; } let response = `Akciz Codes (${codes.length})`; if (validated.search) { response += ` matching "${validated.search}"`; } response += ':\n\n'; codes.slice(0, 20).forEach((code: any) => { response += `- ${code.CODE}: ${code.NAME}`; if (code.DESCRIPTION) { response += ` - ${code.DESCRIPTION}`; } response += '\n'; }); if (codes.length > 20) { response += `\n... and ${codes.length - 20} more codes`; } return response; } catch (error) { logger.error('Error in get_akciz_codes tool', { error }); return formatErrorForUser(error); } }
- Zod input schema for validating tool arguments, supporting optional 'search' string.export const getAkcizCodesInputSchema = z.object({ search: z.string() .optional() .describe('Optional search text to filter akciz codes'), });
- src/tools/get-dictionaries.ts:107-121 (registration)MCP tool registration object defining name, description, and structural input schema advertised to the MCP client.export const getAkcizCodesTool = { name: 'get_akciz_codes', description: 'Get akciz (excise) codes from RS.ge system. Optionally filter by search text.', inputSchema: { type: 'object' as const, properties: { search: { type: 'string', description: 'Optional search text to filter results', }, }, required: [], }, };
- src/index.ts:129-131 (registration)Registers the tool in the MCP server's listToolsRequestHandler based on feature flag.if (features.getAkcizCodes) { tools.push(getAkcizCodesTool); }
- src/index.ts:177-182 (handler)Main MCP server dispatcher that routes tool calls to the specific execute function after feature check.case 'get_akciz_codes': if (!features.getAkcizCodes) { throw new Error('get_akciz_codes tool is disabled'); } result = await executeGetAkcizCodes(soapClient, args); break;