# Onward Flights

> Onward Flights is a paid MCP server for maps and travel. Search real flights and buy a $5 onward ticket as proof of onward travel, paid in USDC. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Paid
- **Platforms:** API, Web
- **Website:** https://onward.flights/agents
- **MCP Registry name:** flights.onward/onward-flights
- **Categories:** maps and travel, finance and payments
- **Listing updated:** 2026-11-14

## About

Some countries ask arriving travellers for proof of onward travel. This server lets an agent find airports, search flights between two points on a date, and buy an onward ticket without a human at the keyboard. It needs no sign-up or API key.

Payment uses the Machine Payments Protocol or x402. A ticket costs $5 in USDC on Base, Ethereum, Optimism or Polygon. Calling buy_ticket unpaid returns the price, a wallet address and a payment challenge for each chain. The agent then sends USDC and repeats the call with the transaction hash, which is verified on-chain before a ticket link and PDF receipt are returned. With x402 the agent signs rather than sends, so it needs no ETH for gas.

If the agent has no wallet, it gets a link a person can open to pay in a browser. The same flow is available as an HTTP API.

## Features

- **Airport lookup:** find_airports resolves a place name to airports.
- **Flight search:** search_flights finds flights by origin, destination and date.
- **Agent-paid tickets:** buy_ticket takes USDC through MPP or x402 without a human.
- **Gasless x402 option:** The agent signs the payment so it needs no ETH for gas.
- **Browser payment fallback:** Without a wallet, the agent gets a link for a person to pay.
- **HTTP API:** Equivalent endpoints cover airports, flights and purchase.

## Good for

- Get proof of onward travel for border or airline checks
- Let an assistant search flights for a route and date
- Buy a ticket from an agent that holds a wallet
- Give a human a payment link when the agent has no wallet

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http onward-flights https://onward.flights/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://onward.flights/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "onward-flights": {
      "url": "https://onward.flights/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "onward-flights": {
      "type": "http",
      "url": "https://onward.flights/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "onward-flights": {
      "serverUrl": "https://onward.flights/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "onward-flights": {
      "type": "http",
      "url": "https://onward.flights/mcp"
    }
  }
}
```

## Tools

- `find_airports`: Look up 3 letter IATA airport codes by city, airport or country name.
- `search_flights`: Find one-way flights to use as an onward ticket. Returns up to 10 flights, each with an id to buy and its price in USD.
- `buy_ticket`: Buy the ticket for a flight from search_flights, paid in USDC. Call it first without payment to get the price, wallet address and MPP challenges. After sending the USDC, call it again with tx_hash and chain (or an MPP credential in _meta "org.paymentauth/credential"). x402 clients can instead sign one of the offers in error.data.x402 and retry with the PaymentPayload in _meta "x402/payment", with 

## FAQ

### How much is a ticket?

$5 in USDC on Base, Ethereum, Optimism or Polygon.

### Do I need an API key?

No. It is a remote MCP server with no sign-up or key.

### What do I get after paying?

A ticket link and a PDF with a receipt.

### What if my agent has no wallet?

It gets a link the human can open to pay in a browser.

### Is Onward Flights free?

No. Onward Flights is a paid product.

### How do I add Onward Flights to Claude Code?

Run this command in your terminal: claude mcp add --transport http onward-flights https://onward.flights/mcp

### What are the best alternatives to Onward Flights?

The closest alternatives to Onward Flights are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Tutu eSIM and Quantivex Research.

## Alternatives

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Tutu eSIM](https://ai-powered.com/mcp/tutu-esim): Tutu eSIM is a paid MCP server for maps and travel.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [Shanghai Streets Travel Guide](https://ai-powered.com/mcp/shanghai-streets-travel-guide): Shanghai Streets Travel Guide is a free MCP server for maps and travel.

---
Source: https://ai-powered.com/mcp/onward-flights
