{"_id":"@airlabs-co/airlabs-mcp","name":"@airlabs-co/airlabs-mcp","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@airlabs-co/airlabs-mcp","version":"1.0.0","description":"Official AirLabs API MCP server — real-time flight data, schedules, delays, airports, airlines, fleets and routes as tools for AI assistants.","type":"module","bin":{"airlabs-mcp":"build/index.js"},"scripts":{"build":"tsc && chmod +x build/index.js","start":"node build/index.js","prepublishOnly":"npm run build"},"keywords":["mcp","model-context-protocol","airlabs","flight-data","aviation","flight-api","ai-agent","claude","llm"],"author":{"name":"AirLabs","url":"Data Products Ltd"},"license":"MIT","homepage":"https://airlabs.co","repository":{"type":"git","url":"git+https://github.com/airlabs-co/airlabs-mcp.git"},"bugs":{"url":"https://github.com/airlabs-co/airlabs-mcp/issues"},"engines":{"node":">=18.0.0"},"dependencies":{"@modelcontextprotocol/sdk":"^1.29.0"},"devDependencies":{"typescript":"^5.4.0","@types/node":"^20.0.0"},"_id":"@airlabs-co/airlabs-mcp@1.0.0","gitHead":"8867967e9944b517d923391743b2d7e13c6782b8","_nodeVersion":"20.11.0","_npmVersion":"10.2.4","dist":{"integrity":"sha512-EYXvX9icWxkScH4cQGv/NoSeqf3MaouJBO6wBg0WVU7fYDqRYqMPvYGiUdLFGuUBpUR0Xiy2kHD2AI95Htf0Sw==","shasum":"a25678d6d666f877b2c338bf76efc6b4763d9a93","tarball":"https://registry.npmjs.org/@airlabs-co/airlabs-mcp/-/airlabs-mcp-1.0.0.tgz","fileCount":4,"unpackedSize":38184,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIAVSR1SRpJrs1bZgl0g0u23Y8xX9+T99J8Hg2+bFEISRAiEAgCDTuO/hdHxpVYqIL580E22+4KCoaxVM9bMQAOJGwHk="}]},"_npmUser":{"name":"airlabs-co","email":"github@airlabs.co"},"directories":{},"maintainers":[{"name":"airlabs-co","email":"github@airlabs.co"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/airlabs-mcp_1.0.0_1782381201840_0.9248414877719957"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-25T09:53:21.647Z","1.0.0":"2026-06-25T09:53:21.969Z","modified":"2026-06-25T09:53:22.172Z"},"maintainers":[{"name":"airlabs-co","email":"github@airlabs.co"}],"description":"Official AirLabs API MCP server — real-time flight data, schedules, delays, airports, airlines, fleets and routes as tools for AI assistants.","homepage":"https://airlabs.co","keywords":["mcp","model-context-protocol","airlabs","flight-data","aviation","flight-api","ai-agent","claude","llm"],"repository":{"type":"git","url":"git+https://github.com/airlabs-co/airlabs-mcp.git"},"author":{"name":"AirLabs","url":"Data Products Ltd"},"bugs":{"url":"https://github.com/airlabs-co/airlabs-mcp/issues"},"license":"MIT","readme":"# AirLabs MCP Server\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\nThis [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server provides access to the [AirLabs](https://airlabs.co) aviation data API. It lets AI assistants such as Claude Desktop and Cursor access real-time flight data, airport schedules, delays, and reference databases for airlines, airports, aircraft fleets and routes — directly through natural-language questions.\n\nThe entire server lives in a single file (`index.ts`): tool definitions, the AirLabs HTTP client, request handling and the stdio transport.\n\n## Features\n\n- **Live flight status** — look up any flight by number and get status, gate, terminal and delay.\n- **Airport schedules** — departures and arrivals boards for any airport.\n- **Delay monitoring** — find flights delayed beyond a threshold at an airport or airline.\n- **Real-time positions** — live aircraft coordinates, altitude, speed and heading by area, airline or registration.\n- **Nearest airport** — closest airports to any coordinate.\n- **Reference databases** — airlines, airports, aircraft fleets (by tail number or ICAO24 hex) and route networks.\n- **Code resolution** — turn a place or airline name into its IATA/ICAO code.\n\n## Prerequisites\n\n1. **Node.js** 18.0.0 or higher.\n2. **AirLabs API key** — get a free key at <https://airlabs.co/signup>.\n\n## Installation\n\n### Via npm\n\n```bash\nnpm install -g @airlabs-co/airlabs-mcp\n```\n\n## Configuration\n\n### Claude Desktop Integration\n\nAdd this to your `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"airlabs\": {\n      \"command\": \"npx\",\n      \"args\": [\"@airlabs-co/airlabs-mcp@latest\"],\n      \"env\": {\n        \"AIRLABS_API_KEY\": \"your_api_key_here\"\n      }\n    }\n  }\n}\n```\n\n**Notes:**\n\n- Replace `your_api_key_here` with your actual AirLabs API key.\n- Restart Claude Desktop after editing the config.\n- If you build from source locally, use `\"command\": \"node\", \"args\": [\"/path/to/build/index.js\"]`.\n\n### Other MCP Clients\n\nRun the server directly over stdio:\n\n```bash\nAIRLABS_API_KEY=your_api_key_here npx @airlabs/airlabs-mcp\n```\n\n## Available Tools\n\n| Tool | AirLabs endpoint | Purpose |\n| --- | --- | --- |\n| `get_flight_status` | `/flight` | Live status of one flight by IATA/ICAO number |\n| `get_airport_schedule` | `/schedules` | Departures / arrivals board for an airport |\n| `monitor_delays` | `/delays` | Flights delayed beyond a threshold |\n| `track_live_flights` | `/flights` | Live aircraft positions by area, airline or registration |\n| `find_nearest_airport` | `/nearby` | Closest airports to a coordinate |\n| `search_airport_code` | `/suggest` | Resolve a name to an IATA/ICAO code |\n| `get_airline_info` | `/airlines` | Airline details by code |\n| `get_airport_info` | `/airports` | Airport details by code |\n| `lookup_aircraft` | `/fleets` | Aircraft by registration or ICAO24 hex |\n| `find_routes` | `/routes` | Which airlines fly a given route |\n\nAll tools accept an optional `_fields` parameter (where the endpoint supports it) to return only selected fields and keep responses compact.\n\n## Usage Examples\n\nOnce configured, just ask your assistant:\n\n- *\"Is flight BA117 on time?\"* → `get_flight_status`\n- *\"What flights are leaving JFK today?\"* → `get_airport_schedule`\n- *\"Are arrivals delayed at LAX by more than 30 minutes?\"* → `monitor_delays`\n- *\"Show me planes flying over New York.\"* → `track_live_flights`\n- *\"What aircraft is registration N790AN?\"* → `lookup_aircraft`\n- *\"Which airlines fly from London to Tokyo?\"* → `find_routes`\n\n## Development\n\n### Building from source\n\n```bash\ngit clone https://github.com/airlabs-co/airlabs-mcp.git\ncd airlabs-mcp\nnpm install\nnpm run build\n```\n\n### Contributing\n\n1. Fork the repository.\n2. Create a feature branch.\n3. Make your changes.\n4. Submit a pull request.\n\n## Support\n\n- **Documentation**: <https://airlabs.co/docs>\n- **Issues**: [GitHub Issues](https://github.com/airlabs-co/airlabs-mcp/issues)\n- **API support**: <https://airlabs.co/faq#Contact>\n\n## License\n\nMIT License — see [LICENSE](LICENSE).\n","readmeFilename":"README.md","_rev":"1-219d6daa2f764ed379a463e120961a8a"}