{"id":"ravinahp-flights-mcp","name":"flights-mcp","homepage":null,"repo_url":"https://github.com/ravinahp/flights-mcp","category":"ai-ml","subcategories":[],"tags":["mcp","flights","travel","duffel","api-integration","python"],"what_it_does":"A Python MCP server that searches for flight offers (one-way, round-trip, multi-city) and retrieves offer details using the Duffel flight search API. It exposes MCP tools like search_flights and get_offer_details and requires a Duffel API key provided via environment variable.","use_cases":["Finding flight options for one-way trips with constraints (dates, cabin class, adults)","Searching and comparing round-trip itineraries","Building and searching multi-city itineraries with multiple segments","Getting detailed pricing and route/slice/connection information for a specific offer ID","Searching across multiple days to find cheaper departures/returns (at reduced speed)"],"not_for":["Booking flights or initiating any purchase","Real-time itinerary changes requiring write operations (tool is read-only)","Use cases that require an official REST/GraphQL/SDK integration instead of MCP"],"best_when":"You want an AI agent to perform structured flight searches and then follow up with detailed offer lookups via MCP tool calls.","avoid_when":"You need broad public automation without running a local MCP server process (e.g., fully managed hosted API access), or you cannot provide/manage Duffel API credentials.","alternatives":["Use Duffel API directly from your own backend","Use an existing flight-search API/SDK that provides REST endpoints and client libraries","Manually search on airline/aggregator sites for simple itineraries"],"af_score":62.0,"security_score":54.8,"reliability_score":21.2,"package_type":"mcp_server","discovery_source":["github"],"priority":"high","status":"evaluated","version_evaluated":null,"last_evaluated":"2026-03-30T13:39:15.480339+00:00","interface":{"has_rest_api":false,"has_graphql":false,"has_grpc":false,"has_mcp_server":true,"mcp_server_url":null,"has_sdk":false,"sdk_languages":[],"openapi_spec_url":null,"webhooks":false},"auth":{"methods":["Duffel API key via environment variable (DUFFEL_API_KEY_LIVE)"],"oauth":false,"scopes":false,"notes":"Auth is handled by Duffel API key. README indicates a test key (duffel_test) can be used for simulated data; live key requires Duffel verification steps."},"pricing":{"model":null,"free_tier_exists":false,"free_tier_limits":null,"paid_tiers":[],"requires_credit_card":false,"estimated_workload_costs":null,"notes":"No pricing details for this MCP server are provided; cost depends on Duffel plan/usage limits mentioned generally in README."},"requirements":{"requires_signup":false,"requires_credit_card":false,"domain_verification":false,"data_residency":[],"compliance":[],"min_contract":null},"agent_readiness":{"af_score":62.0,"security_score":54.8,"reliability_score":21.2,"mcp_server_quality":78.0,"documentation_accuracy":70.0,"error_message_quality":null,"error_message_notes":"Tool-level behaviors and example error outputs are not shown; likely relies on MCP/exception handling and Duffel error responses.","auth_complexity":55.0,"rate_limit_clarity":25.0,"tls_enforcement":70.0,"auth_strength":60.0,"scope_granularity":20.0,"dependency_hygiene":45.0,"secret_handling":75.0,"security_notes":"Uses Duffel API keys passed via environment variable per README. README claims sensitive info stays local, and that the server is read-only (no booking). Specific TLS enforcement, secret redaction/logging, and dependency vulnerability posture are not detailed. Rate limit and quota guidance is not provided with actionable headers/limits.","uptime_documented":0.0,"version_stability":40.0,"breaking_changes_history":0.0,"error_recovery":45.0,"idempotency_support":"true","idempotency_notes":"Flight search and offer details retrieval are read-only operations; repeated calls should be safe, though caching/idempotency semantics are not explicitly documented.","pagination_style":"none","retry_guidance_documented":false,"known_agent_gotchas":["Requires local configuration to run the MCP server process (Claude Desktop config shown); not a hosted endpoint.","Real flight lookups require a Duffel live key; missing/invalid key behavior is only described generally.","Search results are capped (e.g., up to 50 offers for one-way/round-trip, 10 for multi-city); the agent may need follow-up get_offer_details for specific IDs.","Supplier/network timeouts are 15-30 seconds depending on search type; agents may need to handle slower responses."]}}