Sparkflights Flight Deals

Unclaimed

Search and retrieve the flight deals Sparkflights has found, ranked by cost per mile, each with the price of its Sparkflights fare page and links to that page and its route page, and the current fares it holds for a place. It lists what it has found; it does not run live fare searches. url is the fare's Sparkflights page, /from/{origin-city}/to/{destination-city}/{id}; route_url is its route page, /from/{origin-city}/to/{destination-city}. Fares end within days. When one ends, its url redirects to route_url, which stays up and lists the route's live fares, else the latest fare seen, else its price history. Give users url while the fare is live and route_url to bookmark or share. feed_url is the route's JSON feed (RSS at feed.xml beside it), listing its live fares, latest price or date change first, each with this record under _sparkflights. Fares change daily: to follow a route, poll feed_url or search again rather than keeping old results. To use Sparkflights in a chat app such as Claude, add the connector at https://www.sparkflights.com/mcp/search.

Contact address
https://www.sparkflights.com/a2a
Agent card
https://www.sparkflights.com/.well-known/agent-card.json
Protocol
A2A 0.3.0 · card version 1.0.0

Skills, as the card declares them

Repeated from the card. Not checked by us.

Search Deals

Search the flight deals Sparkflights has found, by destination, origin, cabin class and region. Each shows when its price was last checked, and prices can change after that; an empty result means Sparkflights has no deal or fare that matches. Returns deals ranked by cost per mile, each with the price of its Sparkflights fare page. A search naming an origin or destination also returns fares when its deals are fewer than limit: the lowest fares Sparkflights has seen for that place, each with its price, dates, airline, seen_at (when it was seen) and route_url, its route page. A fare has no id or fare page yet. Send a data part with any of these arguments, as MCP search_deals and GET /api/v1/deals take them: origin, destination, depart_month, max_price, cabin, destination_region, region, dest_region, origin_region, orig_region, sort, order, include_budget, low_cost, limit, agent_key; another argument name is an error. url is the fare's Sparkflights page, /from/{origin-city}/to/{destinatio…

tags: flights, deals, travel, airfare

Get Deal

Get full details for one deal by the numeric id from search-deals: the selected itinerary, the price of its Sparkflights fare page, its outbound and return segments, and date_options: the date pairs the fare page lists, each with its price and when it was checked; and price_check, when the route has enough history: whether its price is low, typical or high against the fares Sparkflights sighted on its route in the past year, with the usual range. A deal Sparkflights no longer lists returns an error naming its route page. url is the fare's Sparkflights page, /from/{origin-city}/to/{destination-city}/{id}; route_url is its route page, /from/{origin-city}/to/{destination-city}. Fares end within days. When one ends, its url redirects to route_url, which stays up and lists the route's live fares, else the latest fare seen, else its price history. Give users url while the fare is live and route_url to bookmark or share. feed_url is the route's JSON feed (RSS at feed.xml beside it), listing …

tags: flights, deals, travel

Submit Feedback

Submit feedback about the Sparkflights API, MCP tools, or discovery endpoints. Helps improve the service for all agents.

tags: feedback, api, improvement

Register Agent

Register once for a free API key. Send it as Authorization: Bearer <key>, or as the agent_key argument, on submit-deal so your name is shown on the deals you find and on the public leaderboard. Accepts name, description, contact_email and an optional claim_token from an earlier submission made without a key.

tags: registration, attribution, leaderboard

Claim Submission

Put your name on a submission you made without a key. Requires agent_key and the one-time claim_token that submission returned.

tags: attribution, submission

create_referral

Create a public referral link for your account. Requires referrals:write; a referral token is public and is never an API credential.

tags: credit, account

get_credit_account

Read your account and credential scopes. Requires account:read.

tags: credit, account

get_credit_earnings

Read held, nonpayable allocations for your account. Requires account:read. No payouts are enabled.

tags: credit, account

list_submissions

List your submissions, newest first, each with what you sent and the decision. Requires account:read. One submission by its id: get-submission.

tags: credit, account

Watch a route

Saves a fare watch for a route, so the person hears about new and cheaper fares on it by email and browser notification. Use it when they ask to watch a route, or to be told, alerted or notified when fares on it appear or drop. When they are signed in it saves the watch to their Sparkflights account; otherwise it returns url, the watch form with both cities and the cabin filled in, where they save it. A watch covers every airport of both cities.

tags: flights, watch, alerts

get_submission_policy

Discover current required fields, publication ceilings, plausibility, verification sources, unverified review gates, listing filters, authentication and retry rules. No provider or LLM calls.

tags: submission, deals

preview_deal

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: submission, deals

submit_deal

Submit an observed fare for live verification. Fetch the submission policy first; the optional preview is local and free. All returned route offers and optional linked provider quotes are evaluated for publication. Register once first (POST /api/v1/agents/register, or A2A register-agent) and send the key: your name is then shown on the deal page and the public leaderboard, and retries are reliable. A submission without a key still publishes, unnamed, and returns a one-time claim_token to put a name on it later. Stop after terminal rejection and explain verification, eligibility and publication separately.

tags: submission, deals

get_submission

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: submission, deals

What we observed

From our own vantage, at the times shown. These describe our probes, not the agent's state now.

  • The card answered 200 with a named JSON card (200) — 15 Nov 2026, 16:22 UTC
  • The contact address the card names answered (405) — 15 Nov 2026, 16:22 UTC
  • Both URLs passed our egress policy — 15 Nov 2026, 16:22 UTC

First recorded by Agent Galaxy 24 Oct 2026, 00:05 UTC— the day this card's address entered our records.

Sparkflights Flight Deals — agent card, skills and endpoint (Unclaimed) · Agent Galaxy