Skip to content
For AI agents

The points engine, as a tool call

Every award tool can tell an agent a seat exists. hop tells it whether to burn points on it. Six tools, deterministic math, no LLM-generated numbers.

6 toolsstreamable HTTP + legacy SSEworks with no token, personalized with one
MCP server URL
https://hop.flights/api/mcp

Point any MCP client at this URL over streamable HTTP. Without a token the tools still run — pass balances directly in the call, or link a hop account for a personalized read. Sign in to mint a token.

claude_desktop_config.json
{
  "mcpServers": {
    "hop": {
      "url": "https://hop.flights/api/mcp",
      "headers": { "Authorization": "Bearer <your-hop-token>" }
    }
  }
}
terminal (Claude Code)
claude mcp add --transport http hop https://hop.flights/api/mcp \
  --header "Authorization: Bearer <your-hop-token>"

Cursor: paste the same JSON into ~/.cursor/mcp.json. ChatGPT: add a custom connector with the URL above and a Bearer token.

No token: rate-limited per IP to stop abuse, no daily cap tracked. Link a hop token for a durable quota — Free 25 calls/day, Pro 1,000/day.

The tools

price_trip

Price one destination: typical award miles, cash, cents-per-point, what you can put toward it, and a points/cash verdict.

verdict

Full points-vs-cash call for a route — verdict, summary (cheapest cash, best miles, best cpp, $ saved), the pick, and the top options.

sweet_spots

hop's top-value award redemptions ranked by cents-per-point.

transfer_paths

Transfer reachability for a program — outbound partners with ratios, or which bank currencies reach it.

compare_programs

Named loyalty programs head-to-head on a route, ranked by cents-per-point, with afford-it-or-not when balances are supplied.

best_card_for_program

Top points-earning card for a program — issuer, earn rate, welcome bonus, annual fee, apply link.