compare_specifications
Compare 3GPP specifications across architecture, procedures, evolution, and implementation differences to identify variations and analyze changes between standards.
Instructions
Compare multiple 3GPP specifications across various criteria including architecture, procedures, evolution, and implementation differences.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| specification_ids | Yes | Array of specification IDs to compare (e.g., ["TS 32.251", "TS 32.290"]) | |
| comparison_criteria | No | Specific criteria to compare (e.g., ["architecture", "procedures", "interfaces", "evolution"]) | |
| include_evolution_analysis | No | Include analysis of specification evolution across releases (default: true) | |
| format | No | Response format - agent_ready provides structured JSON for AI agents | agent_ready |
Implementation Reference
- The main handler function that executes the tool logic: validates input, calls the API manager to compare specifications, and formats the response based on the requested format (agent_ready, summary, or detailed).
async execute(args: CompareSpecificationsArgs) { try { if (args.specification_ids.length < 2) { throw new Error('At least 2 specifications are required for comparison'); } const comparison = await this.apiManager.compareSpecifications(args.specification_ids); const format = args.format || 'agent_ready'; switch (format) { case 'agent_ready': return { content: [ { type: 'text', text: JSON.stringify(this.formatForAgent(comparison, args), null, 2) } ] }; case 'summary': return { content: [ { type: 'text', text: this.formatSummary(comparison, args) } ] }; case 'detailed': default: return { content: [ { type: 'text', text: this.formatDetailed(comparison, args) } ] }; } } catch (error) { return { content: [ { type: 'text', text: `Error comparing specifications: ${error instanceof Error ? error.message : 'Unknown error'}` } ], isError: true }; } } - TypeScript interface defining the input arguments for the compare_specifications tool.
export interface CompareSpecificationsArgs { specification_ids: string[]; comparison_criteria?: string[]; include_evolution_analysis?: boolean; format?: 'detailed' | 'summary' | 'agent_ready'; } - The getDefinition method that provides the tool's metadata including name 'compare_specifications', description, and detailed inputSchema for MCP protocol.
getDefinition() { return { name: 'compare_specifications', description: 'Compare multiple 3GPP specifications across various criteria including architecture, procedures, evolution, and implementation differences.', inputSchema: { type: 'object', properties: { specification_ids: { type: 'array', items: { type: 'string' }, description: 'Array of specification IDs to compare (e.g., ["TS 32.251", "TS 32.290"])', minItems: 2, maxItems: 5 }, comparison_criteria: { type: 'array', items: { type: 'string' }, description: 'Specific criteria to compare (e.g., ["architecture", "procedures", "interfaces", "evolution"])' }, include_evolution_analysis: { type: 'boolean', description: 'Include analysis of specification evolution across releases (default: true)', default: true }, format: { type: 'string', enum: ['detailed', 'summary', 'agent_ready'], description: 'Response format - agent_ready provides structured JSON for AI agents', default: 'agent_ready' } }, required: ['specification_ids'] } }; } - src/index.ts:107-108 (registration)Registration in the main server request handler: dispatches calls to the compare_specifications tool to the appropriate tool instance's execute method.
case 'compare_specifications': return await this.compareTool.execute(args as unknown as CompareSpecificationsArgs); - src/index.ts:80-80 (registration)Instantiation of the CompareSpecificationsTool instance in the server's initializeComponents method.
this.compareTool = new CompareSpecificationsTool(this.apiManager);