npm install @reaatech/mcp-contract-validators
# or
yarn add @reaatech/mcp-contract-validators
# or
pnpm add @reaatech/mcp-contract-validators

import {
  getProtocolValidators,
  getRegistryValidators,
  getRoutingValidators,
  getSecurityValidators,
  getPerformanceValidators,
} from '@reaatech/mcp-contract-validators';
import { createMCPClient } from '@reaatech/mcp-contract-client';
 
const client = createMCPClient({ endpoint: 'http://localhost:8080' });
await client.connect();
 
// Run a single suite
for (const validator of getProtocolValidators()) {
  const result = await validator.validate({
    client,
    endpoint: 'http://localhost:8080',
    options: { timeout: 30000, retries: 2 },
    requestId: crypto.randomUUID(),
  });
  console.log(`${result.validator}: ${result.passed ? 'PASS' : 'FAIL'} — ${result.message}`);
}
 
await client.disconnect();

import {
  jsonrpcValidator,
  toolDiscoveryValidator,
  ssrfValidator,
  latencyValidator,
} from '@reaatech/mcp-contract-validators';
 
const result = await jsonrpcValidator.validate(context);

import {
  getProtocolValidators,    // → [jsonrpcValidator, toolDiscoveryValidator, toolExecutionValidator, sessionValidator]
  getRegistryValidators,    // → [schemaValidator, invariantValidator, envExpansionValidator]
  getRoutingValidators,     // → [requestContractValidator, responseContractValidator, compatibilityValidator]
  getSecurityValidators,    // → [ssrfValidator, authValidator, inputSanitizationValidator]
  getPerformanceValidators, // → [latencyValidator, concurrencyValidator, rateLimitValidator]
} from '@reaatech/mcp-contract-validators';

import {
  protocolValidators,
  registryValidators,
  routingValidators,
  securityValidators,
  performanceValidators,
} from '@reaatech/mcp-contract-validators';

// Protocol
export { jsonrpcValidator } from '@reaatech/mcp-contract-validators';
export { toolDiscoveryValidator } from '@reaatech/mcp-contract-validators';
export { toolExecutionValidator } from '@reaatech/mcp-contract-validators';
export { sessionValidator } from '@reaatech/mcp-contract-validators';
 
// Registry
export { schemaValidator } from '@reaatech/mcp-contract-validators';
export { invariantValidator } from '@reaatech/mcp-contract-validators';
export { envExpansionValidator } from '@reaatech/mcp-contract-validators';
 
// Routing
export { requestContractValidator } from '@reaatech/mcp-contract-validators';
export { responseContractValidator } from '@reaatech/mcp-contract-validators';
export { compatibilityValidator } from '@reaatech/mcp-contract-validators';
 
// Security
export { ssrfValidator } from '@reaatech/mcp-contract-validators';
export { authValidator } from '@reaatech/mcp-contract-validators';
export { inputSanitizationValidator } from '@reaatech/mcp-contract-validators';
 
// Performance
export { latencyValidator } from '@reaatech/mcp-contract-validators';
export { concurrencyValidator } from '@reaatech/mcp-contract-validators';
export { rateLimitValidator } from '@reaatech/mcp-contract-validators';

import {
  validateAgentYAML,    // (yamlPath: string, options?: { strict?: boolean }) => SchemaValidationResult
  validateInvariants,   // (agents: AgentConfig[]) => InvariantValidationResult
  validateEnvExpansion, // (content: string) => EnvExpansionResult
  extractEnvVars,       // (str: string) => string[]
} from '@reaatech/mcp-contract-validators';

import type { Validator, TestResult, ValidationContext } from '@reaatech/mcp-contract-core';
import { Severity, TestCategory, now } from '@reaatech/mcp-contract-core';
 
export const myValidator: Validator = {
  name: 'my-custom-validator',
  category: TestCategory.PROTOCOL,
  severity: Severity.WARNING,
 
  async validate(context: ValidationContext): Promise<TestResult> {
    const start = performance.now();
    const errors: string[] = [];
 
    try {
      const tools = await context.client.listTools();
      if (tools.length < 3) {
        errors.push('Expected at least 3 tools for production readiness');
      }
    } catch (error) {
      errors.push(`Validation failed: ${(error as Error).message}`);
    }
 
    if (errors.length === 0) {
      return {
        validator: this.name,
        category: this.category,
        passed: true,
        severity: Severity.INFO,
        message: 'Custom validation passed',
        durationMs: Math.round(performance.now() - start),
        timestamp: now(),
      };
    }
 
    return {
      validator: this.name,
      category: this.category,
      passed: false,
      severity: this.severity,
      message: `Custom validation failed with ${errors.length} error(s)`,
      remediation: 'Ensure the server exposes at least 3 tools for production',
      details: { errors },
      durationMs: Math.round(performance.now() - start),
      timestamp: now(),
    };
  },
};