check_vat_test_service

Test integration with the official EU VIES service using predefined VAT numbers to verify validation workflows.

Instructions

Test VIES service integration with test VAT numbers / Testovať integráciu so službou VIES

Input Schema

TableJSON Schema

Name	Required	Description	Default
`countryCode`	Yes	EU member state code / Kód členského štátu EÚ
`vatNumber`	Yes	Test VAT number: 100 (valid), 200 (invalid) / Testové IČ DPH: 100 (platné), 200 (neplatné)

Implementation Reference

src/index.ts:118-132 (handler)

MCP tool handler for 'check_vat_test_service': parses input with schema, calls ViesApiClient method, formats response as text

case 'check_vat_test_service': {
  const params = checkVatTestSchema.parse(args);
  const result = await this.viesClient.checkVatTestService(params);
  
  const responseText = this.formatVatValidationResult(result, true);
  
  return {
    content: [
      {
        type: 'text',
        text: responseText,
      },
    ],
  };
}

src/index.ts:57-75 (registration)

Registration of 'check_vat_test_service' tool in the ListTools response, including input schema definition

  name: 'check_vat_test_service',
  description: 'Test VIES service integration with test VAT numbers / Testovať integráciu so službou VIES',
  inputSchema: {
    type: 'object',
    properties: {
      countryCode: {
        type: 'string',
        enum: [...EU_MEMBER_STATES],
        description: 'EU member state code / Kód členského štátu EÚ',
      },
      vatNumber: {
        type: 'string',
        enum: ['100', '200'],
        description: 'Test VAT number: 100 (valid), 200 (invalid) / Testové IČ DPH: 100 (platné), 200 (neplatné)',
      },
    },
    required: ['countryCode', 'vatNumber'],
  },
},

src/schemas.ts:18-23 (schema)

Zod input validation schema used for parsing tool arguments: checkVatTestSchema

export const checkVatTestSchema = z.object({
  countryCode: z.enum(EU_MEMBER_STATES),
  vatNumber: z.enum(['100', '200'], {
    errorMap: () => ({ message: 'Test VAT number must be 100 (valid) or 200 (invalid)' })
  }),
});

src/client.ts:91-120 (helper)

ViesApiClient method implementing the HTTP POST to VIES '/check-vat-test-service' endpoint, parses response and maps to VatNumberInfo

async checkVatTestService(params: CheckVatTestParams): Promise<VatNumberInfo> {
  try {
    const response = await this.client.post('/check-vat-test-service', {
      countryCode: params.countryCode,
      vatNumber: params.vatNumber,
    });

    const validatedData = vatValidationResponseSchema.parse(response.data);

    return {
      countryCode: validatedData.countryCode || params.countryCode,
      vatNumber: validatedData.vatNumber || params.vatNumber,
      isValid: validatedData.valid,
      companyName: validatedData.name,
      companyAddress: validatedData.address,
      requestDate: validatedData.requestDate,
      wasPreprocessed: false, // Test service doesn't preprocess
    };
  } catch (error) {
    if (error instanceof ViesApiError) {
      try {
        const errorData = errorResponseSchema.parse(error.response);
        throw new Error(`VIES test service failed: ${errorData.error}${errorData.message ? ` - ${errorData.message}` : ''}`);
      } catch {
        throw error;
      }
    }
    throw error;
  }
}

VAT Validation MCP Server