NDC Clearance

Live Version: ndc-clearance.netlify.app

NDC Clearance is the comprehensive reference for IATA NDC (New Distribution Capability) Schemas and a live MCP Server for AI Agents. Browse hierarchies, search definitions, and validate messages.

Why this project?

This project was created to address several challenges with standard NDC distributions:

1. Live Validation for AI Agents: Connect your favorite AI tools (Claude, Cursor, etc.) directly to our live Model Context Protocol (MCP) backend to verify NDC messages against any schema version instantly.
2. LLM-Friendly Schemas: Standard NDC messages are typically split into a small message file and a massive common file containing thousands of types, the majority of which are unused by any single message. This makes them difficult for Large Language Models (LLMs) to process effectively. Our tools flatten these schemas, including ONLY the types actually used by a specific message, making them compact and context-window friendly.
3. Improved UI/UX: Browsing and searching complex XSD structures in a standard text editor is cumbersome. NDC Clearance provides a modern, interactive interface to visualize the hierarchical structure and perform deep searches with XPath awareness.
4. Open Source Accessibility: Providing a community-driven tool to navigate the industry standards more efficiently.

Project Structure

• site/: The web application built with Astro and Svelte.
• flatten_ndc_schemas.py: A Python script for merging and selectively including types from referenced NDC XSD schemas to create self-contained files.
• batch_flatten.py: A helper script for batch processing multiple NDC messages through the flattener.
• iata_ndc_messages.json: Metadata and configuration detailing the NDC messages and versions supported.

Features

• Interactive Schema Explorer: Visualize the hierarchical structure of NDC messages.
• Deep Search: Locate elements and attributes with XPath awareness.
• LLM-Friendly Schemas: Tools to flatten complex schemas into smaller, self-contained files suitable for context windows.
• Multi-Version Support: Support for various IATA NDC releases (e.g., 25.1, 25.3, 25.4).

Getting Started

Web Interface

1. Navigate to the site/ directory:

   cd site

2. Install dependencies:

   npm install

3. Start the development server:

   npm run dev

Schema Flattening Tools

The Python scripts in the root directory can be used to process raw NDC schemas.

python3 flatten_ndc_schemas.py --help

Disclaimer

This project is an independent open-source tool and is not affiliated with, endorsed by, or sponsored by IATA (International Air Transport Association).

Testing Locally

You can run the full stack (Site + Backend) locally without Unikraft using Docker Compose.

1. Start the stack:

   docker-compose up --build

2. Access the application:
   • Site: http://localhost:4321
   • Backend API: http://localhost:8080

Using the MCP Server

The backend exposes a Model Context Protocol (MCP) server that provides tools for validating NDC messages.

Supported Tools

• validate_ndc_xml: Validates raw XML against a specific NDC schema version.

Public Server

URL: https://mcp-ndc.sunrisehikers.io/mcp/sse

1. Claude Code

Run the following command:

claude mcp add --transport sse ndc-validator https://mcp-ndc.sunrisehikers.io/mcp/sse

2. Claude.ai

1. Open Claude.ai
2. Go to Settings > Connectors
3. Click Add Custom Connector
4. Enter URL: https://mcp-ndc.sunrisehikers.io/mcp/sse

3. VS Code (GitHub Copilot)

Add to your MCP server configuration file (e.g., ~/.config/Code/User/globalStorage/mcp-servers.json):

{
  "servers": {
    "ndc-validator": {
      "type": "sse",
      "url": "https://mcp-ndc.sunrisehikers.io/mcp/sse"
    }
  }
}

4. Gemini CLI

Run the following command:

gemini mcp add --transport sse ndc-validator https://mcp-ndc.sunrisehikers.io/mcp/sse

5. OpenCode

Add to your opencode.json:

{
  "mcp": {
    "ndc-validator": {
      "type": "remote",
      "url": "https://mcp-ndc.sunrisehikers.io/mcp/sse",
      "enabled": true
    }
  }
}

Local Development Server

Base URL: http://localhost:8080/mcp/sse

To use the local server, replace the https://mcp-ndc.sunrisehikers.io/mcp/sse URL in the instructions above with http://localhost:8080/mcp/sse.

License

AGPL