# sky-access/skyaccess-mcp architecture

> Architecture diagram of the GitHub repository sky-access/skyaccess-mcp, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sky-access/skyaccess-mcp
- Repository: https://github.com/sky-access/skyaccess-mcp
- Video tour (about a minute): https://gitdiagram.com/sky-access/skyaccess-mcp/video

## Overview

SkyAccess MCP exposes live empty-leg search, flight lookup, booking links and charter estimates through a hosted MCP endpoint; the README also documents route listings and booking requests. This repository mainly supplies client-side access: a CLI installer/health check, a stdio-to-HTTP bridge, and a Dify integration. The hosted server’s implementation is not in the tree, so its capabilities are shown as documented external behavior rather than repository modules.

Main entry points: [`integrations/dify/utils/skyaccess_mcp.py`](https://github.com/sky-access/skyaccess-mcp/blob/main/integrations/dify/utils/skyaccess_mcp.py) (Dify MCP client), [`src/cli.mjs`](https://github.com/sky-access/skyaccess-mcp/blob/main/src/cli.mjs) (CLI dispatcher), [`src/http-transport.mjs`](https://github.com/sky-access/skyaccess-mcp/blob/main/src/http-transport.mjs) (HTTP transport), [`src/bridge.mjs`](https://github.com/sky-access/skyaccess-mcp/blob/main/src/bridge.mjs) (STDIO bridge)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client_access["Client access"]
  node_cli["CLI dispatcher<br/>[cli.mjs]"]
  node_installer["Client installer<br/>[install.mjs]"]
  node_client_configs["Client config rules<br/>[clients.mjs]"]
  node_doctor["Endpoint doctor<br/>[doctor.mjs]"]
end

subgraph group_bridge_transport["Bridge transport"]
  node_bridge["STDIO bridge<br/>[bridge.mjs]"]
  node_http_transport["HTTP transport<br/>[http-transport.mjs]"]
  node_sse_parser["SSE parser<br/>[sse.mjs]"]
end

subgraph group_dify_integration["Dify integration"]
  node_dify_tools["Dify tool adapters"]
  node_dify_search["Empty-leg search"]
  node_dify_flight["Flight lookup<br/>[get_flight.py]"]
  node_dify_handoff["Booking handoff<br/>[booking_handoff.py]"]
  node_dify_estimate["Charter estimate"]
  node_dify_client["Dify MCP client<br/>[skyaccess_mcp.py]"]
end

node_traveler(("Traveler / AI client"))
node_stdio_client(("STDIO-only client"))
node_hosted_server{{"SkyAccess MCP endpoint"}}
node_empty_legs["Live empty legs"]
node_flight_details["Flight details"]
node_booking_link["Booking link"]
node_charter_estimate["Charter estimate"]
node_route_catalogue["Popular routes"]
node_booking_request["Booking enquiry"]

node_traveler -->|"runs commands"| node_cli
node_cli -->|"dispatches install"| node_installer
node_cli -->|"dispatches check"| node_doctor
node_cli -->|"dispatches bridge"| node_bridge
node_installer -->|"plans client entries"| node_client_configs
node_stdio_client -->|"starts bridge"| node_bridge
node_bridge -->|"posts messages"| node_http_transport
node_http_transport -->|"parses event stream"| node_sse_parser
node_http_transport -->|"posts MCP requests"| node_hosted_server
node_doctor -->|"probes endpoint"| node_http_transport
node_traveler -->|"uses hosted endpoint"| node_hosted_server
node_hosted_server -->|"searches live inventory"| node_empty_legs
node_hosted_server -->|"returns flight lookup"| node_flight_details
node_hosted_server -->|"returns booking link"| node_booking_link
node_hosted_server -->|"estimates charter"| node_charter_estimate
node_hosted_server -->|"lists popular routes"| node_route_catalogue
node_hosted_server -->|"accepts enquiry"| node_booking_request
node_dify_search -->|"calls tool"| node_dify_client
node_dify_flight -->|"calls tool"| node_dify_client
node_dify_handoff -->|"calls tool"| node_dify_client
node_dify_estimate -->|"calls tool"| node_dify_client
node_dify_client -->|"sends MCP requests"| node_hosted_server
node_dify_tools -.->|"implements search"| node_dify_search

click node_cli "https://github.com/sky-access/skyaccess-mcp/blob/main/src/cli.mjs"
click node_installer "https://github.com/sky-access/skyaccess-mcp/blob/main/src/install.mjs"
click node_client_configs "https://github.com/sky-access/skyaccess-mcp/blob/main/src/clients.mjs"
click node_doctor "https://github.com/sky-access/skyaccess-mcp/blob/main/src/doctor.mjs"
click node_bridge "https://github.com/sky-access/skyaccess-mcp/blob/main/src/bridge.mjs"
click node_http_transport "https://github.com/sky-access/skyaccess-mcp/blob/main/src/http-transport.mjs"
click node_sse_parser "https://github.com/sky-access/skyaccess-mcp/blob/main/src/sse.mjs"
click node_dify_tools "https://github.com/sky-access/skyaccess-mcp/tree/main/integrations/dify/tools"
click node_dify_search "https://github.com/sky-access/skyaccess-mcp/blob/main/integrations/dify/tools/search_empty_legs.py"
click node_dify_flight "https://github.com/sky-access/skyaccess-mcp/blob/main/integrations/dify/tools/get_flight.py"
click node_dify_handoff "https://github.com/sky-access/skyaccess-mcp/blob/main/integrations/dify/tools/booking_handoff.py"
click node_dify_estimate "https://github.com/sky-access/skyaccess-mcp/blob/main/integrations/dify/tools/get_charter_estimate.py"
click node_dify_client "https://github.com/sky-access/skyaccess-mcp/blob/main/integrations/dify/utils/skyaccess_mcp.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_cli,node_installer,node_client_configs,node_doctor,node_traveler,node_stdio_client toneBlue
class node_bridge,node_http_transport,node_sse_parser toneAmber
class node_dify_tools,node_dify_search,node_dify_flight,node_dify_handoff,node_dify_estimate,node_dify_client,node_route_catalogue toneMint
class node_hosted_server,node_empty_legs,node_flight_details,node_booking_link,node_charter_estimate,node_booking_request toneIndigo
```

## Components

### Client access

- [CLI dispatcher](https://github.com/sky-access/skyaccess-mcp/blob/main/src/cli.mjs): `src/cli.mjs`
- [Client installer](https://github.com/sky-access/skyaccess-mcp/blob/main/src/install.mjs): `src/install.mjs`
- [Client config rules](https://github.com/sky-access/skyaccess-mcp/blob/main/src/clients.mjs): `src/clients.mjs`
- [Endpoint doctor](https://github.com/sky-access/skyaccess-mcp/blob/main/src/doctor.mjs): `src/doctor.mjs`

### Bridge transport

- [STDIO bridge](https://github.com/sky-access/skyaccess-mcp/blob/main/src/bridge.mjs): `src/bridge.mjs`
- [HTTP transport](https://github.com/sky-access/skyaccess-mcp/blob/main/src/http-transport.mjs): `src/http-transport.mjs`
- [SSE parser](https://github.com/sky-access/skyaccess-mcp/blob/main/src/sse.mjs): `src/sse.mjs`

### Dify integration

- [Dify tool adapters](https://github.com/sky-access/skyaccess-mcp/tree/main/integrations/dify/tools): `integrations/dify/tools`
- [Empty-leg search](https://github.com/sky-access/skyaccess-mcp/blob/main/integrations/dify/tools/search_empty_legs.py): `integrations/dify/tools/search_empty_legs.py`
- [Flight lookup](https://github.com/sky-access/skyaccess-mcp/blob/main/integrations/dify/tools/get_flight.py): `integrations/dify/tools/get_flight.py`
- [Booking handoff](https://github.com/sky-access/skyaccess-mcp/blob/main/integrations/dify/tools/booking_handoff.py): `integrations/dify/tools/booking_handoff.py`
- [Charter estimate](https://github.com/sky-access/skyaccess-mcp/blob/main/integrations/dify/tools/get_charter_estimate.py): `integrations/dify/tools/get_charter_estimate.py`
- [Dify MCP client](https://github.com/sky-access/skyaccess-mcp/blob/main/integrations/dify/utils/skyaccess_mcp.py): `integrations/dify/utils/skyaccess_mcp.py`

### Other components

- **Traveler / AI client**
- **STDIO-only client**
- **SkyAccess MCP endpoint**
- **Live empty legs**
- **Flight details**
- **Booking link**
- **Charter estimate**
- **Popular routes**
- **Booking enquiry**

## Connections

- Traveler / AI client → CLI dispatcher: runs commands (evidence: `README.md`)
- CLI dispatcher → Client installer: dispatches install (evidence: `src/cli.mjs`)
- CLI dispatcher → Endpoint doctor: dispatches check (evidence: `src/cli.mjs`)
- CLI dispatcher → STDIO bridge: dispatches bridge (evidence: `src/cli.mjs`)
- Client installer → Client config rules: plans client entries (evidence: `src/install.mjs`)
- STDIO-only client → STDIO bridge: starts bridge (evidence: `README.md`)
- STDIO bridge → HTTP transport: posts messages (evidence: `src/bridge.mjs`)
- HTTP transport → SSE parser: parses event stream (evidence: `src/http-transport.mjs`)
- HTTP transport → SkyAccess MCP endpoint: posts MCP requests (evidence: `src/http-transport.mjs`)
- Endpoint doctor → HTTP transport: probes endpoint (evidence: `src/doctor.mjs`)
- Traveler / AI client → SkyAccess MCP endpoint: uses hosted endpoint (evidence: `README.md`)
- SkyAccess MCP endpoint → Live empty legs: searches live inventory (evidence: `README.md`)
- SkyAccess MCP endpoint → Flight details: returns flight lookup (evidence: `README.md`)
- SkyAccess MCP endpoint → Booking link: returns booking link (evidence: `README.md`)
- SkyAccess MCP endpoint → Charter estimate: estimates charter (evidence: `README.md`)
- SkyAccess MCP endpoint → Popular routes: lists popular routes (evidence: `README.md`)
- SkyAccess MCP endpoint → Booking enquiry: accepts enquiry (evidence: `README.md`)
- Empty-leg search → Dify MCP client: calls tool (evidence: `integrations/dify/tools/search_empty_legs.py`)
- Flight lookup → Dify MCP client: calls tool (evidence: `integrations/dify/tools/get_flight.py`)
- Booking handoff → Dify MCP client: calls tool (evidence: `integrations/dify/tools/booking_handoff.py`)
- Charter estimate → Dify MCP client: calls tool (evidence: `integrations/dify/tools/get_charter_estimate.py`)
- Dify MCP client → SkyAccess MCP endpoint: sends MCP requests (evidence: `integrations/dify/utils/skyaccess_mcp.py`)
- Dify tool adapters → Empty-leg search: implements search
