{"id":4661,"name":"Sparkflights Flight Deals","description":"Search and retrieve verified flight deals ranked by cost per mile, with affiliate booking links for Google Flights, Skyscanner, Kayak, and Aviasales.","card_url":"https://www.sparkflights.com/.well-known/agent-card.json","endpoint":"https://www.sparkflights.com/a2a","protocol_version":"0.2.1","first_seen":"2026-10-09T04:51:01.938334+00:00","last_verified":"2026-10-09T04:51:01.938334+00:00","card":{"url":"https://www.sparkflights.com/a2a","name":"Sparkflights Flight Deals","skills":[{"id":"search-deals","name":"Search Deals","tags":["flights","deals","travel","airfare"],"inputModes":["application/json"],"description":"Search current verified flight deals by destination, origin, cabin class, and region. Returns deals ranked by value with affiliate booking links.","outputModes":["application/json"]},{"id":"get-deal","name":"Get Deal","tags":["flights","deals","travel"],"inputModes":["application/json"],"description":"Get full details for a specific flight deal by ID, including date options and affiliate booking links.","outputModes":["application/json"]},{"id":"submit-feedback","name":"Submit Feedback","tags":["feedback","api","improvement"],"inputModes":["application/json"],"description":"Submit feedback about the Sparkflights API, MCP tools, or discovery endpoints. Helps improve the service for all agents.","outputModes":["application/json"]},{"id":"get-credit-account","name":"get_credit_account","inputModes":["application/json"],"description":"Read your account and credential scopes; requires account:read.","outputModes":["application/json"]},{"id":"get-credit-earnings","name":"get_credit_earnings","inputModes":["application/json"],"description":"Read held, nonpayable allocations; requires account:read. No payouts are enabled.","outputModes":["application/json"]},{"id":"create-referral","name":"create_referral","inputModes":["application/json"],"description":"Create an explicit public referral link for your account; requires referrals:write.","outputModes":["application/json"]},{"id":"get-submission-policy","name":"get_submission_policy","inputModes":["application/json"],"description":"Discover current required fields, publication ceilings, plausibility, verification sources, unverified review gates, listing filters, authentication and retry rules. No provider or LLM calls.","inputSchema":{"type":"object","properties":{},"additionalProperties":false},"outputModes":["application/json"],"outputSchema":{"type":"object","required":["schema_version","policy_version","price_basis","required_fields","conditional_fields","defaults","ceilings","hard_rules","unverified_review","listing_visibility","supported_sources","verification","authentication","retry_requirements","score_purpose","distance_basis"],"properties":{"ceilings":{"type":"object","required":["Cabin","LowCost","Overrides"],"properties":{"Cabin":{"type":"object","additionalProperties":{"type":"number"}},"LowCost":{"type":"object","additionalProperties":{"type":"number"}},"Overrides":{"type":"object","additionalProperties":{"type":"object","additionalProperties":{"type":"number"}}}},"additionalProperties":false},"defaults":{"type":"object","additionalProperties":{"type":"string"}},"hard_rules":{"type":"object","required":["min_route_miles","min_premium_route_miles","min_premium_price_usd","min_plausible_cpm","max_plausible_cpm_by_cabin","excluded_airports","departure_today_or_later_required","policy_implementation"],"properties":{"min_route_miles":{"type":"number"},"excluded_airports":{"type":"array","items":{"type":"string"}},"min_plausible_cpm":{"type":"number"},"min_premium_price_usd":{"type":"number"},"policy_implementation":{"type":"string"},"min_premium_route_miles":{"type":"number"},"max_plausible_cpm_by_cabin":{"type":"object","additionalProperties":{"type":"number"}},"departure_today_or_later_required":{"type":"boolean"}},"additionalProperties":false},"price_basis":{"type":"string"},"verification":{"type":"string"},"score_purpose":{"type":"string"},"authentication":{"type":"string"},"distance_basis":{"type":"string"},"policy_version":{"type":"string"},"schema_version":{"type":"string"},"required_fields":{"type":"array","items":{"type":"string"}},"supported_sources":{"type":"array","items":{"type":"string"}},"unverified_review":{"type":"object","required":["max_probe_ratio","zero_disables_ratio_gate","description"],"properties":{"description":{"type":"string"},"max_probe_ratio":{"type":"number"},"zero_disables_ratio_gate":{"type":"boolean"}},"additionalProperties":false},"conditional_fields":{"type":"object","additionalProperties":{"type":"string"}},"listing_visibility":{"type":"object","required":["min_score","max_ratio","max_age_hours","min_distance_miles","min_price_usd","origin_regions","main_board_excludes_budget"],"properties":{"max_ratio":{"type":"number"},"min_score":{"type":"integer"},"max_age_hours":{"type":"integer"},"min_price_usd":{"type":"integer"},"origin_regions":{"type":"array","items":{"type":"string"}},"min_distance_miles":{"type":"integer"},"main_board_excludes_budget":{"type":"boolean"}},"additionalProperties":false},"retry_requirements":{"type":"string"}},"additionalProperties":false}},{"id":"preview-deal","name":"preview_deal","inputModes":["application/json"],"description":"Check the claimed fare against current local rules with no provider/LLM calls or publication writes. Passing does not guarantee availability, publication or novelty. Verification is always not_attempted.","inputSchema":{"type":"object","required":["origin","destination","price_usd","depart_date"],"properties":{"notes":{"type":"string","description":"Factual context"},"origin":{"type":"string","description":"Origin IATA airport code"},"airline":{"type":"string","description":"Observed candidate airline; does not restrict live route discovery"},"price_usd":{"type":"number","description":"Observed total in USD for one adult including mandatory taxes and fees","exclusiveMinimum":0},"trip_type":{"enum":["round_trip","one_way"],"type":"string","default":"round_trip"},"comparison":{"type":"object","properties":{"origin_market":{"enum":["NYC"],"type":"string"},"origin_airports":{"type":"array","items":{"type":"string","pattern":"^[A-Z]{3}$"}},"fare_requirements":{"type":"array","items":{"type":"string"}},"destination_market":{"enum":["NYC"],"type":"string"},"destination_airports":{"type":"array","items":{"type":"string","pattern":"^[A-Z]{3}$"}}},"additionalProperties":false},"source_url":{"type":"string","description":"Absolute HTTPS discovery source; used for verification when booking_url is absent"},"booking_url":{"type":"string","description":"Absolute HTTPS selected Google Flights booking link; unsupported sources may require review"},"cabin_class":{"enum":["economy","premium_economy","business","first"],"type":"string","default":"economy"},"depart_date":{"type":"string","description":"Required YYYY-MM-DD, today or later"},"destination":{"type":"string","description":"Destination IATA airport code"},"return_date":{"type":"string","description":"Required for round_trip, after depart_date; prohibited for one_way"}},"additionalProperties":false},"outputModes":["application/json"],"outputSchema":{"type":"object","required":["schema_version","policy_version","code","normalized_input","verification","eligibility","retryable","next_actions","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"retryable":{"type":"boolean"},"eligibility":{"type":"object","required":["state","price_basis","checked_price_usd","low_cost","unverified_review_failed_checks","score","failed_checks"],"properties":{"cpm":{"type":"number"},"score":{"type":"integer"},"state":{"type":"string"},"market":{"type":"string"},"low_cost":{"type":"boolean"},"ceiling_cpm":{"type":"number"},"price_basis":{"type":"string"},"failed_checks":{"type":"array","items":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"field":{"type":"string"},"units":{"type":"string"},"actual":true,"message":{"type":"string"},"threshold":true},"additionalProperties":false}},"max_price_usd":{"type":"number"},"billable_miles":{"type":"number"},"distance_miles":{"type":"number"},"checked_price_usd":{"type":"number"},"unverified_review_failed_checks":{"type":"array","items":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"field":{"type":"string"},"units":{"type":"string"},"actual":true,"message":{"type":"string"},"threshold":true},"additionalProperties":false}}},"additionalProperties":false},"next_actions":{"type":"array","items":{"type":"object","required":["action","message"],"properties":{"action":{"type":"string"},"message":{"type":"string"},"retry_after_seconds":{"type":"integer"}},"additionalProperties":false}},"verification":{"type":"object","required":["state","quote_count"],"properties":{"state":{"type":"string"},"source":{"type":"string"},"quote_count":{"type":"integer"},"submitted_link":{"type":"object","required":["state","quote_count"],"properties":{"state":{"type":"string"},"source":{"type":"string"},"quote_count":{"type":"integer"},"lowest_quote_usd":{"type":"number"}},"additionalProperties":false},"lowest_quote_usd":{"type":"number"},"route_offer_count":{"type":"integer"},"provider_quote_count":{"type":"integer"}},"additionalProperties":false},"policy_version":{"type":"string"},"schema_version":{"type":"string"},"normalized_input":{"type":"object","required":["origin","destination","price_usd","cabin_class","trip_type","depart_date","return_date","airline","booking_url","source_url","notes"],"properties":{"notes":{"type":"string"},"origin":{"type":"string"},"airline":{"type":"string"},"price_usd":{"type":"number"},"trip_type":{"type":"string"},"comparison":{"type":"object","properties":{"origin_market":{"type":"string"},"origin_airports":{"type":"array","items":{"type":"string"}},"fare_requirements":{"type":"array","items":{"type":"string"}},"destination_market":{"type":"string"},"destination_airports":{"type":"array","items":{"type":"string"}}},"additionalProperties":false},"source_url":{"type":"string"},"booking_url":{"type":"string"},"cabin_class":{"type":"string"},"depart_date":{"type":"string"},"destination":{"type":"string"},"return_date":{"type":"string"},"delegation_id":{"type":"string"},"idempotency_key":{"type":"string"}},"additionalProperties":false}},"additionalProperties":false}},{"id":"submit-deal","name":"submit_deal","inputModes":["application/json"],"description":"Submit an observed fare for live verification. Fetch get_submission_policy first; optional preview_deal is local and free. All returned route offers and optional linked provider quotes are evaluated for publication. Anonymous submission is allowed; registration enables attribution and reliable retries. Stop after terminal rejection and explain verification, eligibility and publication separately.","inputSchema":{"type":"object","required":["origin","destination","price_usd","depart_date"],"properties":{"notes":{"type":"string","description":"Factual context"},"origin":{"type":"string","description":"Origin IATA airport code"},"airline":{"type":"string","description":"Observed candidate airline; does not restrict live route discovery"},"agent_key":{"type":"string","description":"Optional legacy credential; prefer Authorization: Bearer"},"price_usd":{"type":"number","description":"Observed total in USD for one adult including mandatory taxes and fees","exclusiveMinimum":0},"trip_type":{"enum":["round_trip","one_way"],"type":"string","default":"round_trip"},"comparison":{"type":"object","properties":{"origin_market":{"enum":["NYC"],"type":"string"},"origin_airports":{"type":"array","items":{"type":"string","pattern":"^[A-Z]{3}$"}},"fare_requirements":{"type":"array","items":{"type":"string"}},"destination_market":{"enum":["NYC"],"type":"string"},"destination_airports":{"type":"array","items":{"type":"string","pattern":"^[A-Z]{3}$"}}},"additionalProperties":false},"source_url":{"type":"string","description":"Absolute HTTPS discovery source; used for verification when booking_url is absent"},"booking_url":{"type":"string","description":"Absolute HTTPS selected Google Flights booking link; unsupported sources may require review"},"cabin_class":{"enum":["economy","premium_economy","business","first"],"type":"string","default":"economy"},"depart_date":{"type":"string","description":"Required YYYY-MM-DD, today or later"},"destination":{"type":"string","description":"Destination IATA airport code"},"return_date":{"type":"string","description":"Required for round_trip, after depart_date; prohibited for one_way"},"delegation_id":{"type":"string","description":"Explicit user-authorized delegation; requires a credential"},"idempotency_key":{"type":"string","maxLength":128,"description":"Credential-scoped stable key. Preserve for identical retries; new key for changed input"}},"additionalProperties":false},"outputModes":["application/json"],"outputSchema":{"type":"object","required":["result"],"properties":{"hint":{"type":"string"},"result":{"type":"object","required":["status","message"],"properties":{"code":{"type":"string"},"hint":{"type":"string"},"score":{"type":"integer"},"reason":{"type":"string"},"status":{"type":"string"},"deal_id":{"type":"integer"},"message":{"type":"string"},"savings":{"type":"number"},"evidence":{"type":"object","required":["key","source","state","url","total_minor","currency","adults","checked_at","expires_at"],"properties":{"key":{"type":"string"},"url":{"type":"string"},"legs":{"type":"array","items":{"type":"object","required":["from","to","date","carrier","flight_number"],"properties":{"to":{"type":"string"},"date":{"type":"string"},"from":{"type":"string"},"cabin":{"type":"string"},"carrier":{"type":"string"},"arrival_date":{"type":"string"},"arrival_time":{"type":"string"},"flight_number":{"type":"string"},"departure_time":{"type":"string"}},"additionalProperties":false}},"basis":{"type":"object","required":["trip_type","cabin","currency","passengers","journeys"],"properties":{"cabin":{"type":"string"},"currency":{"type":"string"},"journeys":{"type":"array","items":{"type":"object","required":["legs"],"properties":{"legs":{"type":"array","items":{"type":"object","required":["from","to","date","carrier","flight_number"],"properties":{"to":{"type":"string"},"date":{"type":"string"},"from":{"type":"string"},"cabin":{"type":"string"},"carrier":{"type":"string"},"arrival_date":{"type":"string"},"arrival_time":{"type":"string"},"flight_number":{"type":"string"},"departure_time":{"type":"string"}},"additionalProperties":false}}},"additionalProperties":false}},"trip_type":{"type":"string"},"passengers":{"type":"object","required":["adults","children","infants_lap","infants_seat"],"properties":{"adults":{"type":"integer"},"children":{"type":"integer"},"infants_lap":{"type":"integer"},"infants_seat":{"type":"integer"}},"additionalProperties":false}},"additionalProperties":false},"state":{"type":"string"},"adults":{"type":"integer"},"seller":{"type":"string"},"source":{"type":"string"},"currency":{"type":"string"},"checked_at":{"type":"string","format":"date-time"},"conditions":{"type":"string"},"expires_at":{"type":"string","format":"date-time"},"fare_brand":{"type":"string"},"total_minor":{"type":"integer"},"search_basis":{"type":"object","required":["policy_version","origin","destination","depart_date","trip_type","cabin","passengers","currency"],"properties":{"cabin":{"type":"string"},"origin":{"type":"object","required":["scope","id"],"properties":{"id":{"type":"string"},"scope":{"type":"string"},"allowed_airports":{"type":"array","items":{"type":"string"}}},"additionalProperties":false},"currency":{"type":"string"},"trip_type":{"type":"string"},"passengers":{"type":"object","required":["adults","children","infants_lap","infants_seat"],"properties":{"adults":{"type":"integer"},"children":{"type":"integer"},"infants_lap":{"type":"integer"},"infants_seat":{"type":"integer"}},"additionalProperties":false},"depart_date":{"type":"string"},"destination":{"type":"object","required":["scope","id"],"properties":{"id":{"type":"string"},"scope":{"type":"string"},"allowed_airports":{"type":"array","items":{"type":"string"}}},"additionalProperties":false},"return_date":{"type":"string"},"policy_version":{"type":"string"},"fare_requirements":{"type":"array","items":{"type":"string"}}},"additionalProperties":false},"provider_code":{"type":"string"},"lookup_outcome":{"type":"string"},"booking_evidence":{"type":"object","required":["contract_version","backend","source","outcome","basis","journeys","observed_at","expires_at","cache","options"],"properties":{"basis":{"type":"object","required":["trip_type","cabin","currency","passengers","journeys"],"properties":{"cabin":{"type":"string"},"currency":{"type":"string"},"journeys":{"type":"array","items":{"type":"object","required":["legs"],"properties":{"legs":{"type":"array","items":{"type":"object","required":["from","to","date","carrier","flight_number"],"properties":{"to":{"type":"string"},"date":{"type":"string"},"from":{"type":"string"},"cabin":{"type":"string"},"carrier":{"type":"string"},"arrival_date":{"type":"string"},"arrival_time":{"type":"string"},"flight_number":{"type":"string"},"departure_time":{"type":"string"}},"additionalProperties":false}}},"additionalProperties":false}},"trip_type":{"type":"string"},"passengers":{"type":"object","required":["adults","children","infants_lap","infants_seat"],"properties":{"adults":{"type":"integer"},"children":{"type":"integer"},"infants_lap":{"type":"integer"},"infants_seat":{"type":"integer"}},"additionalProperties":false}},"additionalProperties":false},"cache":{"type":"object","required":["hit","age_seconds"],"properties":{"hit":{"type":"boolean"},"age_seconds":{"type":"integer"}},"additionalProperties":false},"reason":{"type":"string"},"source":{"type":"string"},"backend":{"type":"string"},"options":{"type":"array","items":{"type":"object","required":["provider","provider_code","is_airline","total_minor","currency","leg_cabins"],"properties":{"currency":{"type":"string"},"provider":{"type":"string"},"fare_label":{"type":"string"},"is_airline":{"type":"boolean"},"leg_cabins":{"type":"array","items":{"type":"string"}},"total_minor":{"type":"integer"},"booking_path":{"type":"object","required":["url","method","parameters"],"properties":{"url":{"type":"string"},"method":{"type":"string"},"parameters":{"type":"array","items":{"type":"object","required":["name","value"],"properties":{"name":{"type":"string"},"value":{"type":"string"}},"additionalProperties":false}}},"additionalProperties":false},"provider_code":{"type":"string"}},"additionalProperties":false}},"outcome":{"type":"string"},"journeys":{"type":"array","items":{"type":"object","required":["legs"],"properties":{"legs":{"type":"array","items":{"type":"object","required":["from","to","date","carrier","flight_number"],"properties":{"to":{"type":"string"},"date":{"type":"string"},"from":{"type":"string"},"cabin":{"type":"string"},"carrier":{"type":"string"},"arrival_date":{"type":"string"},"arrival_time":{"type":"string"},"flight_number":{"type":"string"},"departure_time":{"type":"string"}},"additionalProperties":false}}},"additionalProperties":false}},"expires_at":{"type":"string","format":"date-time"},"observed_at":{"type":"string","format":"date-time"},"contract_version":{"type":"string"},"other_cabin_options":{"type":"array","items":{"type":"object","required":["provider","provider_code","is_airline","total_minor","currency","leg_cabins"],"properties":{"currency":{"type":"string"},"provider":{"type":"string"},"fare_label":{"type":"string"},"is_airline":{"type":"boolean"},"leg_cabins":{"type":"array","items":{"type":"string"}},"total_minor":{"type":"integer"},"booking_path":{"type":"object","required":["url","method","parameters"],"properties":{"url":{"type":"string"},"method":{"type":"string"},"parameters":{"type":"array","items":{"type":"object","required":["name","value"],"properties":{"name":{"type":"string"},"value":{"type":"string"}},"additionalProperties":false}}},"additionalProperties":false},"provider_code":{"type":"string"}},"additionalProperties":false}}},"additionalProperties":false}},"additionalProperties":false},"retryable":{"type":"boolean"},"account_id":{"type":"integer"},"eligibility":{"type":"object","required":["state","price_basis","checked_price_usd","low_cost","unverified_review_failed_checks","score","failed_checks"],"properties":{"cpm":{"type":"number"},"score":{"type":"integer"},"state":{"type":"string"},"market":{"type":"string"},"low_cost":{"type":"boolean"},"ceiling_cpm":{"type":"number"},"price_basis":{"type":"string"},"failed_checks":{"type":"array","items":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"field":{"type":"string"},"units":{"type":"string"},"actual":true,"message":{"type":"string"},"threshold":true},"additionalProperties":false}},"max_price_usd":{"type":"number"},"billable_miles":{"type":"number"},"distance_miles":{"type":"number"},"checked_price_usd":{"type":"number"},"unverified_review_failed_checks":{"type":"array","items":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"field":{"type":"string"},"units":{"type":"string"},"actual":true,"message":{"type":"string"},"threshold":true},"additionalProperties":false}}},"additionalProperties":false},"next_action":{"type":"string"},"next_actions":{"type":"array","items":{"type":"object","required":["action","message"],"properties":{"action":{"type":"string"},"message":{"type":"string"},"retry_after_seconds":{"type":"integer"}},"additionalProperties":false}},"verification":{"type":"object","required":["state","quote_count"],"properties":{"state":{"type":"string"},"source":{"type":"string"},"quote_count":{"type":"integer"},"submitted_link":{"type":"object","required":["state","quote_count"],"properties":{"state":{"type":"string"},"source":{"type":"string"},"quote_count":{"type":"integer"},"lowest_quote_usd":{"type":"number"}},"additionalProperties":false},"lowest_quote_usd":{"type":"number"},"route_offer_count":{"type":"integer"},"provider_quote_count":{"type":"integer"}},"additionalProperties":false},"submission_id":{"type":"integer"},"existing_price":{"type":"number"},"policy_version":{"type":"string"},"schema_version":{"type":"string"},"verified_price":{"type":"number"},"booking_lookups":{"type":"array","items":{"type":"object","required":["contract_version","backend","source","outcome","basis","journeys","observed_at","expires_at","cache","options"],"properties":{"basis":{"type":"object","required":["trip_type","cabin","currency","passengers","journeys"],"properties":{"cabin":{"type":"string"},"currency":{"type":"string"},"journeys":{"type":"array","items":{"type":"object","required":["legs"],"properties":{"legs":{"type":"array","items":{"type":"object","required":["from","to","date","carrier","flight_number"],"properties":{"to":{"type":"string"},"date":{"type":"string"},"from":{"type":"string"},"cabin":{"type":"string"},"carrier":{"type":"string"},"arrival_date":{"type":"string"},"arrival_time":{"type":"string"},"flight_number":{"type":"string"},"departure_time":{"type":"string"}},"additionalProperties":false}}},"additionalProperties":false}},"trip_type":{"type":"string"},"passengers":{"type":"object","required":["adults","children","infants_lap","infants_seat"],"properties":{"adults":{"type":"integer"},"children":{"type":"integer"},"infants_lap":{"type":"integer"},"infants_seat":{"type":"integer"}},"additionalProperties":false}},"additionalProperties":false},"cache":{"type":"object","required":["hit","age_seconds"],"properties":{"hit":{"type":"boolean"},"age_seconds":{"type":"integer"}},"additionalProperties":false},"reason":{"type":"string"},"source":{"type":"string"},"backend":{"type":"string"},"options":{"type":"array","items":{"type":"object","required":["provider","provider_code","is_airline","total_minor","currency","leg_cabins"],"properties":{"currency":{"type":"string"},"provider":{"type":"string"},"fare_label":{"type":"string"},"is_airline":{"type":"boolean"},"leg_cabins":{"type":"array","items":{"type":"string"}},"total_minor":{"type":"integer"},"booking_path":{"type":"object","required":["url","method","parameters"],"properties":{"url":{"type":"string"},"method":{"type":"string"},"parameters":{"type":"array","items":{"type":"object","required":["name","value"],"properties":{"name":{"type":"string"},"value":{"type":"string"}},"additionalProperties":false}}},"additionalProperties":false},"provider_code":{"type":"string"}},"additionalProperties":false}},"outcome":{"type":"string"},"journeys":{"type":"array","items":{"type":"object","required":["legs"],"properties":{"legs":{"type":"array","items":{"type":"object","required":["from","to","date","carrier","flight_number"],"properties":{"to":{"type":"string"},"date":{"type":"string"},"from":{"type":"string"},"cabin":{"type":"string"},"carrier":{"type":"string"},"arrival_date":{"type":"string"},"arrival_time":{"type":"string"},"flight_number":{"type":"string"},"departure_time":{"type":"string"}},"additionalProperties":false}}},"additionalProperties":false}},"expires_at":{"type":"string","format":"date-time"},"observed_at":{"type":"string","format":"date-time"},"contract_version":{"type":"string"},"other_cabin_options":{"type":"array","items":{"type":"object","required":["provider","provider_code","is_airline","total_minor","currency","leg_cabins"],"properties":{"currency":{"type":"string"},"provider":{"type":"string"},"fare_label":{"type":"string"},"is_airline":{"type":"boolean"},"leg_cabins":{"type":"array","items":{"type":"string"}},"total_minor":{"type":"integer"},"booking_path":{"type":"object","required":["url","method","parameters"],"properties":{"url":{"type":"string"},"method":{"type":"string"},"parameters":{"type":"array","items":{"type":"object","required":["name","value"],"properties":{"name":{"type":"string"},"value":{"type":"string"}},"additionalProperties":false}}},"additionalProperties":false},"provider_code":{"type":"string"}},"additionalProperties":false}}},"additionalProperties":false}},"contribution_id":{"type":"integer"},"submitted_price":{"type":"number"},"publication_price":{"type":"number"},"verification_reason":{"type":"string"}},"additionalProperties":false}},"additionalProperties":false}},{"id":"get-submission","name":"get_submission","inputModes":["application/json"],"description":"Read your recorded canonical submission by contribution_id, including pending decisions. Requires account:read. Another owner's ID returns the same not_found result as a missing ID.","inputSchema":{"type":"object","required":["id"],"properties":{"id":{"type":"integer","minimum":1,"description":"Canonical contribution_id from submission"},"agent_key":{"type":"string","description":"Optional legacy credential; prefer Authorization: Bearer"}},"additionalProperties":false},"outputModes":["application/json"],"outputSchema":{"type":"object","required":["result"],"properties":{"hint":{"type":"string"},"result":{"type":"object","required":["status","message"],"properties":{"code":{"type":"string"},"hint":{"type":"string"},"score":{"type":"integer"},"reason":{"type":"string"},"status":{"type":"string"},"deal_id":{"type":"integer"},"message":{"type":"string"},"savings":{"type":"number"},"evidence":{"type":"object","required":["key","source","state","url","total_minor","currency","adults","checked_at","expires_at"],"properties":{"key":{"type":"string"},"url":{"type":"string"},"legs":{"type":"array","items":{"type":"object","required":["from","to","date","carrier","flight_number"],"properties":{"to":{"type":"string"},"date":{"type":"string"},"from":{"type":"string"},"cabin":{"type":"string"},"carrier":{"type":"string"},"arrival_date":{"type":"string"},"arrival_time":{"type":"string"},"flight_number":{"type":"string"},"departure_time":{"type":"string"}},"additionalProperties":false}},"basis":{"type":"object","required":["trip_type","cabin","currency","passengers","journeys"],"properties":{"cabin":{"type":"string"},"currency":{"type":"string"},"journeys":{"type":"array","items":{"type":"object","required":["legs"],"properties":{"legs":{"type":"array","items":{"type":"object","required":["from","to","date","carrier","flight_number"],"properties":{"to":{"type":"string"},"date":{"type":"string"},"from":{"type":"string"},"cabin":{"type":"string"},"carrier":{"type":"string"},"arrival_date":{"type":"string"},"arrival_time":{"type":"string"},"flight_number":{"type":"string"},"departure_time":{"type":"string"}},"additionalProperties":false}}},"additionalProperties":false}},"trip_type":{"type":"string"},"passengers":{"type":"object","required":["adults","children","infants_lap","infants_seat"],"properties":{"adults":{"type":"integer"},"children":{"type":"integer"},"infants_lap":{"type":"integer"},"infants_seat":{"type":"integer"}},"additionalProperties":false}},"additionalProperties":false},"state":{"type":"string"},"adults":{"type":"integer"},"seller":{"type":"string"},"source":{"type":"string"},"currency":{"type":"string"},"checked_at":{"type":"string","format":"date-time"},"conditions":{"type":"string"},"expires_at":{"type":"string","format":"date-time"},"fare_brand":{"type":"string"},"total_minor":{"type":"integer"},"search_basis":{"type":"object","required":["policy_version","origin","destination","depart_date","trip_type","cabin","passengers","currency"],"properties":{"cabin":{"type":"string"},"origin":{"type":"object","required":["scope","id"],"properties":{"id":{"type":"string"},"scope":{"type":"string"},"allowed_airports":{"type":"array","items":{"type":"string"}}},"additionalProperties":false},"currency":{"type":"string"},"trip_type":{"type":"string"},"passengers":{"type":"object","required":["adults","children","infants_lap","infants_seat"],"properties":{"adults":{"type":"integer"},"children":{"type":"integer"},"infants_lap":{"type":"integer"},"infants_seat":{"type":"integer"}},"additionalProperties":false},"depart_date":{"type":"string"},"destination":{"type":"object","required":["scope","id"],"properties":{"id":{"type":"string"},"scope":{"type":"string"},"allowed_airports":{"type":"array","items":{"type":"string"}}},"additionalProperties":false},"return_date":{"type":"string"},"policy_version":{"type":"string"},"fare_requirements":{"type":"array","items":{"type":"string"}}},"additionalProperties":false},"provider_code":{"type":"string"},"lookup_outcome":{"type":"string"},"booking_evidence":{"type":"object","required":["contract_version","backend","source","outcome","basis","journeys","observed_at","expires_at","cache","options"],"properties":{"basis":{"type":"object","required":["trip_type","cabin","currency","passengers","journeys"],"properties":{"cabin":{"type":"string"},"currency":{"type":"string"},"journeys":{"type":"array","items":{"type":"object","required":["legs"],"properties":{"legs":{"type":"array","items":{"type":"object","required":["from","to","date","carrier","flight_number"],"properties":{"to":{"type":"string"},"date":{"type":"string"},"from":{"type":"string"},"cabin":{"type":"string"},"carrier":{"type":"string"},"arrival_date":{"type":"string"},"arrival_time":{"type":"string"},"flight_number":{"type":"string"},"departure_time":{"type":"string"}},"additionalProperties":false}}},"additionalProperties":false}},"trip_type":{"type":"string"},"passengers":{"type":"object","required":["adults","children","infants_lap","infants_seat"],"properties":{"adults":{"type":"integer"},"children":{"type":"integer"},"infants_lap":{"type":"integer"},"infants_seat":{"type":"integer"}},"additionalProperties":false}},"additionalProperties":false},"cache":{"type":"object","required":["hit","age_seconds"],"properties":{"hit":{"type":"boolean"},"age_seconds":{"type":"integer"}},"additionalProperties":false},"reason":{"type":"string"},"source":{"type":"string"},"backend":{"type":"string"},"options":{"type":"array","items":{"type":"object","required":["provider","provider_code","is_airline","total_minor","currency","leg_cabins"],"properties":{"currency":{"type":"string"},"provider":{"type":"string"},"fare_label":{"type":"string"},"is_airline":{"type":"boolean"},"leg_cabins":{"type":"array","items":{"type":"string"}},"total_minor":{"type":"integer"},"booking_path":{"type":"object","required":["url","method","parameters"],"properties":{"url":{"type":"string"},"method":{"type":"string"},"parameters":{"type":"array","items":{"type":"object","required":["name","value"],"properties":{"name":{"type":"string"},"value":{"type":"string"}},"additionalProperties":false}}},"additionalProperties":false},"provider_code":{"type":"string"}},"additionalProperties":false}},"outcome":{"type":"string"},"journeys":{"type":"array","items":{"type":"object","required":["legs"],"properties":{"legs":{"type":"array","items":{"type":"object","required":["from","to","date","carrier","flight_number"],"properties":{"to":{"type":"string"},"date":{"type":"string"},"from":{"type":"string"},"cabin":{"type":"string"},"carrier":{"type":"string"},"arrival_date":{"type":"string"},"arrival_time":{"type":"string"},"flight_number":{"type":"string"},"departure_time":{"type":"string"}},"additionalProperties":false}}},"additionalProperties":false}},"expires_at":{"type":"string","format":"date-time"},"observed_at":{"type":"string","format":"date-time"},"contract_version":{"type":"string"},"other_cabin_options":{"type":"array","items":{"type":"object","required":["provider","provider_code","is_airline","total_minor","currency","leg_cabins"],"properties":{"currency":{"type":"string"},"provider":{"type":"string"},"fare_label":{"type":"string"},"is_airline":{"type":"boolean"},"leg_cabins":{"type":"array","items":{"type":"string"}},"total_minor":{"type":"integer"},"booking_path":{"type":"object","required":["url","method","parameters"],"properties":{"url":{"type":"string"},"method":{"type":"string"},"parameters":{"type":"array","items":{"type":"object","required":["name","value"],"properties":{"name":{"type":"string"},"value":{"type":"string"}},"additionalProperties":false}}},"additionalProperties":false},"provider_code":{"type":"string"}},"additionalProperties":false}}},"additionalProperties":false}},"additionalProperties":false},"retryable":{"type":"boolean"},"account_id":{"type":"integer"},"eligibility":{"type":"object","required":["state","price_basis","checked_price_usd","low_cost","unverified_review_failed_checks","score","failed_checks"],"properties":{"cpm":{"type":"number"},"score":{"type":"integer"},"state":{"type":"string"},"market":{"type":"string"},"low_cost":{"type":"boolean"},"ceiling_cpm":{"type":"number"},"price_basis":{"type":"string"},"failed_checks":{"type":"array","items":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"field":{"type":"string"},"units":{"type":"string"},"actual":true,"message":{"type":"string"},"threshold":true},"additionalProperties":false}},"max_price_usd":{"type":"number"},"billable_miles":{"type":"number"},"distance_miles":{"type":"number"},"checked_price_usd":{"type":"number"},"unverified_review_failed_checks":{"type":"array","items":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"field":{"type":"string"},"units":{"type":"string"},"actual":true,"message":{"type":"string"},"threshold":true},"additionalProperties":false}}},"additionalProperties":false},"next_action":{"type":"string"},"next_actions":{"type":"array","items":{"type":"object","required":["action","message"],"properties":{"action":{"type":"string"},"message":{"type":"string"},"retry_after_seconds":{"type":"integer"}},"additionalProperties":false}},"verification":{"type":"object","required":["state","quote_count"],"properties":{"state":{"type":"string"},"source":{"type":"string"},"quote_count":{"type":"integer"},"submitted_link":{"type":"object","required":["state","quote_count"],"properties":{"state":{"type":"string"},"source":{"type":"string"},"quote_count":{"type":"integer"},"lowest_quote_usd":{"type":"number"}},"additionalProperties":false},"lowest_quote_usd":{"type":"number"},"route_offer_count":{"type":"integer"},"provider_quote_count":{"type":"integer"}},"additionalProperties":false},"submission_id":{"type":"integer"},"existing_price":{"type":"number"},"policy_version":{"type":"string"},"schema_version":{"type":"string"},"verified_price":{"type":"number"},"booking_lookups":{"type":"array","items":{"type":"object","required":["contract_version","backend","source","outcome","basis","journeys","observed_at","expires_at","cache","options"],"properties":{"basis":{"type":"object","required":["trip_type","cabin","currency","passengers","journeys"],"properties":{"cabin":{"type":"string"},"currency":{"type":"string"},"journeys":{"type":"array","items":{"type":"object","required":["legs"],"properties":{"legs":{"type":"array","items":{"type":"object","required":["from","to","date","carrier","flight_number"],"properties":{"to":{"type":"string"},"date":{"type":"string"},"from":{"type":"string"},"cabin":{"type":"string"},"carrier":{"type":"string"},"arrival_date":{"type":"string"},"arrival_time":{"type":"string"},"flight_number":{"type":"string"},"departure_time":{"type":"string"}},"additionalProperties":false}}},"additionalProperties":false}},"trip_type":{"type":"string"},"passengers":{"type":"object","required":["adults","children","infants_lap","infants_seat"],"properties":{"adults":{"type":"integer"},"children":{"type":"integer"},"infants_lap":{"type":"integer"},"infants_seat":{"type":"integer"}},"additionalProperties":false}},"additionalProperties":false},"cache":{"type":"object","required":["hit","age_seconds"],"properties":{"hit":{"type":"boolean"},"age_seconds":{"type":"integer"}},"additionalProperties":false},"reason":{"type":"string"},"source":{"type":"string"},"backend":{"type":"string"},"options":{"type":"array","items":{"type":"object","required":["provider","provider_code","is_airline","total_minor","currency","leg_cabins"],"properties":{"currency":{"type":"string"},"provider":{"type":"string"},"fare_label":{"type":"string"},"is_airline":{"type":"boolean"},"leg_cabins":{"type":"array","items":{"type":"string"}},"total_minor":{"type":"integer"},"booking_path":{"type":"object","required":["url","method","parameters"],"properties":{"url":{"type":"string"},"method":{"type":"string"},"parameters":{"type":"array","items":{"type":"object","required":["name","value"],"properties":{"name":{"type":"string"},"value":{"type":"string"}},"additionalProperties":false}}},"additionalProperties":false},"provider_code":{"type":"string"}},"additionalProperties":false}},"outcome":{"type":"string"},"journeys":{"type":"array","items":{"type":"object","required":["legs"],"properties":{"legs":{"type":"array","items":{"type":"object","required":["from","to","date","carrier","flight_number"],"properties":{"to":{"type":"string"},"date":{"type":"string"},"from":{"type":"string"},"cabin":{"type":"string"},"carrier":{"type":"string"},"arrival_date":{"type":"string"},"arrival_time":{"type":"string"},"flight_number":{"type":"string"},"departure_time":{"type":"string"}},"additionalProperties":false}}},"additionalProperties":false}},"expires_at":{"type":"string","format":"date-time"},"observed_at":{"type":"string","format":"date-time"},"contract_version":{"type":"string"},"other_cabin_options":{"type":"array","items":{"type":"object","required":["provider","provider_code","is_airline","total_minor","currency","leg_cabins"],"properties":{"currency":{"type":"string"},"provider":{"type":"string"},"fare_label":{"type":"string"},"is_airline":{"type":"boolean"},"leg_cabins":{"type":"array","items":{"type":"string"}},"total_minor":{"type":"integer"},"booking_path":{"type":"object","required":["url","method","parameters"],"properties":{"url":{"type":"string"},"method":{"type":"string"},"parameters":{"type":"array","items":{"type":"object","required":["name","value"],"properties":{"name":{"type":"string"},"value":{"type":"string"}},"additionalProperties":false}}},"additionalProperties":false},"provider_code":{"type":"string"}},"additionalProperties":false}}},"additionalProperties":false}},"contribution_id":{"type":"integer"},"submitted_price":{"type":"number"},"publication_price":{"type":"number"},"verification_reason":{"type":"string"}},"additionalProperties":false}},"additionalProperties":false}}],"version":"1.0.0","agentSkill":{"id":"sparkflights","url":"https://www.sparkflights.com/agent-skills/sparkflights/SKILL.md","auth":"none","name":"SparkFlights","type":"skill","digest":"sha256:1ffca4d9654c7e84db39181d654a5027b60eda9c0cfd6d3287d4b6980f14d9a3","description":"Discover submission rules, preview observed fares, submit for verification and recover decisions","download_url":"https://www.sparkflights.com/agent-skills/sparkflights/package.zip","package_digest":"sha256:db46d60cd32cfbe3d4716db9d671dda5a2d32db39decb05f7e31ab8f8deabf5c"},"description":"Search and retrieve verified flight deals ranked by cost per mile, with affiliate booking links for Google Flights, Skyscanner, Kayak, and Aviasales.","capabilities":{"streaming":false,"pushNotifications":false},"authentication":{"schemes":[{"in":"header","name":"X-Agent-Key","scheme":"apiKey","description":"Optional. For on-page attribution and leaderboard credit: POST /api/v1/agents/register (free, no auth) to get a key, then pass it here on every request."},{"scheme":"bearer","description":"Opaque scoped credit credential. Required for account, earnings, and referral skills; optional for anonymous submission. Invalid supplied credentials are rejected."}]},"protocolVersion":"0.2.1","defaultInputModes":["application/json"],"defaultOutputModes":["application/json"],"supportedInterfaces":[{"url":"https://www.sparkflights.com/a2a","protocolBinding":"JSONRPC","protocolVersion":"0.2.1"}]},"signature_status":"unsigned","signature_detail":"No card signature supplied","signature_key_url":null,"signature_checked_at":"2026-10-09T04:51:01.938334+00:00","domain_claimed_at":null,"domain_proof_checked_at":null,"source_name":"Global A2A Registry","source_url":"https://api.a2a-registry.org/public/agents","last_check":{"checked_at":"2026-10-09T04:51:01.938334+00:00","success":true,"http_status":200,"detail":"Agent Card validated"},"skills":[{"skill_id":"get-deal","name":"Get Deal","description":"Get full details for a specific flight deal by ID, including date options and affiliate booking links.","tags":["flights","deals","travel"],"quality_warning":false},{"skill_id":"search-deals","name":"Search Deals","description":"Search current verified flight deals by destination, origin, cabin class, and region. Returns deals ranked by value with affiliate booking links.","tags":["flights","deals","travel","airfare"],"quality_warning":false},{"skill_id":"submit-feedback","name":"Submit Feedback","description":"Submit feedback about the Sparkflights API, MCP tools, or discovery endpoints. Helps improve the service for all agents.","tags":["feedback","api","improvement"],"quality_warning":false},{"skill_id":"create-referral","name":"create_referral","description":"Create an explicit public referral link for your account; requires referrals:write.","tags":[],"quality_warning":false},{"skill_id":"get-credit-account","name":"get_credit_account","description":"Read your account and credential scopes; requires account:read.","tags":[],"quality_warning":false},{"skill_id":"get-credit-earnings","name":"get_credit_earnings","description":"Read held, nonpayable allocations; requires account:read. No payouts are enabled.","tags":[],"quality_warning":false},{"skill_id":"get-submission","name":"get_submission","description":"Read your recorded canonical submission by contribution_id, including pending decisions. Requires account:read. Another owner's ID returns the same not_found result as a missing ID.","tags":[],"quality_warning":false},{"skill_id":"get-submission-policy","name":"get_submission_policy","description":"Discover current required fields, publication ceilings, plausibility, verification sources, unverified review gates, listing filters, authentication and retry rules. No provider or LLM calls.","tags":[],"quality_warning":false},{"skill_id":"preview-deal","name":"preview_deal","description":"Check the claimed fare against current local rules with no provider/LLM calls or publication writes. Passing does not guarantee availability, publication or novelty. Verification is always not_attempted.","tags":[],"quality_warning":false},{"skill_id":"submit-deal","name":"submit_deal","description":"Submit an observed fare for live verification. Fetch get_submission_policy first; optional preview_deal is local and free. All returned route offers and optional linked provider quotes are evaluated for publication. Anonymous submission is allowed; registration enables attribution and reliable retries. Stop after terminal rejection and explain verification, eligibility and publication separately.","tags":[],"quality_warning":false}],"quality_flags":[],"check_history":{"checks":1,"passed":1},"recent_checks":[{"checked_at":"2026-10-09T04:51:01.938334+00:00","success":true,"http_status":200,"detail":"Agent Card validated"}],"endpoint_tls_check":null,"protocol_check":null,"events":[],"relationships":[],"verification":{"agent_card_url":"https://www.sparkflights.com/.well-known/agent-card.json","last_successful_card_check":"2026-10-09T04:51:01.938334+00:00","latest_card_check":{"checked_at":"2026-10-09T04:51:01.938334+00:00","success":true,"http_status":200,"detail":"Agent Card validated"},"signature_status":"unsigned","signature_checked_at":"2026-10-09T04:51:01.938334+00:00","task_endpoint_tested":false,"task_execution_tested":false,"endpoint_tls_checked_at":null,"endpoint_tls_reachable":null,"protocol_check_state":null,"protocol_checked_at":null,"provider_identity_verified":false,"domain_claimed_at":null,"domain_proof_checked_at":null}}