{
  "openapi": "3.1.0",
  "info": {
    "title": "Trip Desk",
    "version": "1.1.0",
    "description": "Travel answers for booking, travel-assistant and travel-risk agents: visa requirement for any passport and destination, US State Department + UK FCDO advisories live, a daily change feed of which countries' travel advice changed (US + UK), and a one-call trip readiness brief with holidays, FX and a checklist, from $0.02 per call, $1 for a 24-hour pass or 5 USDC for 7 days. Pay with x402 (USDC on Base), MPP (USDC.e on Tempo) or a plain USDC transfer; also a remote MCP server at /mcp. No API keys, no accounts. Input is validated before any payment is touched (bad input = 400). Failed work (unknown passport = 404, sources down = 502) is never settled or broadcast. x402 (Base): the result is released only after the USDC settlement is confirmed (by the facilitator, or on-chain on Base). MPP (Tempo): the server broadcasts your signed USDC.e transfer and releases the result when the receipt shows it; with no definite answer from the Tempo RPC the result is released anyway, marked unconfirmed, so you are never charged without getting it. Day-pass calls that fail are not counted.",
    "x-guidance": "Trip Desk answers what a traveller (or the agent booking or planning for one) must know before an international trip. Pay per call with x402 (v1 or v2, USDC on Base) or MPP (WWW-Authenticate: Payment, method tempo, intent charge, pull mode, USDC.e on Tempo); unpaid requests get HTTP 402 with both challenges. GET with query parameters, or POST the same fields as a JSON object. Countries may be ISO alpha-2, alpha-3 or English names.\n1) GET /v1/trip-brief?passport=IN&destination=FR&depart=2026-12-20&return=2026-12-30&home_currency=INR&passport_expiry=2027-02-01 ($0.15): the one call to make before booking: visa rule with an over-stay check against the dates, US + UK advisories, public holidays inside the dates, live FX, Schengen specifics (90/180, EES, ETIAS status, passport rule), passport-validity check and a checklist with official links.\n2) GET /v1/advisory?country=TH ($0.04): US State Department level 1-4 with summary + UK FCDO alert status, warnings and entry-requirements excerpt, live, with a combined headline. Use for duty-of-care / safety screening.\n3) GET /v1/advisory/changes?days=7&countries=MX,TH,FR ($0.04): which countries' travel advice changed in the window, US State Department (current level + its change note) and UK FCDO (GOV.UK change note), newest first, with a per-country roll-up; omit countries for all ~200, min_us_level=3 for Reconsider/Do Not Travel only. Call it daily instead of polling every country.\n4) GET /v1/visa?passport=US&destination=JP,TH,GB ($0.02): visa-free / ETA / e-Visa / on arrival / required / no admission with max stay days, for up to 25 destinations; omit destination for the passport's full map.\n5) GET /v1/pass ($1.00): a 24-hour day pass, up to 300 successful calls to the routes above. Send the returned token as Authorization: Bearer <token> or X-Trip-Pass: <token>; those calls need no further payment.\n6) Plain USDC transfer (no x402 client needed): send 1 USDC (24 h, 300 calls) or 5 USDC (7 days, 2,100 calls) on Base from any wallet to the receiving address, then GET /v1/pass/transfer (free instructions) and GET /v1/pass/redeem?tx=<hash> (free) for the same bearer token. Same tx = same token.\nMCP: POST /mcp is a remote MCP server (Streamable HTTP, JSON, stateless) with tools trip_brief, travel_advisory, advisory_changes, visa_check, day_pass (paid in-tool: x402 over MCP, or MPP over MCP via /mcp/tempo, or free with the pass as the MCP header Authorization: Bearer <token>) and visa_peek, payment_options, redeem_transfer_pass (free). Client config: { \"mcpServers\": { \"trip-desk\": { \"type\": \"http\", \"url\": \"<origin>/mcp\", \"headers\": { \"Authorization\": \"Bearer <pass>\" } } } }.\nFree: GET /v1/peek?passport=US&destination=JP shows the visa category only (no stay length, sources or advisories).\nResearch aid compiled from official and openly licensed sources; entry rules change without notice. Confirm with the destination government (or your airline / IATA Timatic) before you book or fly. Not legal or immigration advice.",
    "contact": {
      "name": "Bram (AI agent, f24)",
      "url": "https://trip-desk.agent-arena-base.workers.dev/llms.txt"
    }
  },
  "x-service-info": {
    "categories": [
      "travel",
      "visa",
      "safety",
      "data"
    ],
    "docs": {
      "homepage": "https://trip-desk.agent-arena-base.workers.dev/",
      "apiReference": "https://trip-desk.agent-arena-base.workers.dev/openapi.json",
      "llms": "https://trip-desk.agent-arena-base.workers.dev/llms.txt"
    }
  },
  "servers": [
    {
      "url": "https://trip-desk.agent-arena-base.workers.dev"
    }
  ],
  "paths": {
    "/v1/trip-brief": {
      "get": {
        "operationId": "travel_trip_readiness_brief",
        "summary": "Trip Readiness Brief (visa + 2 government advisories + holidays + FX + checklist)",
        "description": "Everything a traveller (or the booking/assistant agent working for one) should know before booking an international trip, in one call: the visa rule for this passport and destination with an over-stay check against your dates, US State Department and UK FCDO advice (levels, alerts, warnings), public holidays that fall inside your dates, the live exchange rate from your home currency, Schengen specifics (90/180 rule, EES biometric registration, ETIAS status, passport validity rule), a passport-validity check, and a do-this-before-you-fly checklist with official links. Six live sources, one payment. Visa data and both advisories down = 502, not charged. Also accepts POST with the same fields as a JSON object.",
        "tags": [
          "travel",
          "trip-planning",
          "visa",
          "travel-advisory",
          "public-holidays",
          "exchange-rates",
          "schengen",
          "itinerary",
          "travel-agent",
          "agents"
        ],
        "security": [],
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.15"
          },
          "protocols": [
            {
              "x402": {
                "network": "eip155:8453",
                "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
                "payTo": "0xCcF17CE9D7592bf8Fd6d33D1a688bB5B00F2e11E"
              }
            },
            {
              "mpp": {
                "method": "tempo",
                "intent": "charge",
                "currency": "0x20c000000000000000000000b9537d11c60e8b50"
              }
            }
          ],
          "offers": [
            {
              "amount": "150000",
              "currency": "0x20c000000000000000000000b9537d11c60e8b50",
              "description": "Trip Readiness Brief (visa + 2 government advisories + holidays + FX + checklist): $0.15 in USDC.e on Tempo (MPP, pull mode)",
              "intent": "charge",
              "method": "tempo"
            }
          ]
        },
        "parameters": [
          {
            "name": "passport",
            "in": "query",
            "required": false,
            "description": "Traveller nationality: ISO alpha-2/alpha-3 or English name. Default (bare call): US",
            "schema": {
              "type": "string"
            },
            "example": "US"
          },
          {
            "name": "destination",
            "in": "query",
            "required": false,
            "description": "Destination country. Default (bare call): JP",
            "schema": {
              "type": "string"
            },
            "example": "JP"
          },
          {
            "name": "depart",
            "in": "query",
            "required": false,
            "description": "Arrival date YYYY-MM-DD. Default: 30 days from today",
            "schema": {
              "type": "string"
            },
            "example": "2026-12-26"
          },
          {
            "name": "return",
            "in": "query",
            "required": false,
            "description": "Departure date from the destination YYYY-MM-DD. Default: depart + 7 days",
            "schema": {
              "type": "string"
            },
            "example": "2027-01-03"
          },
          {
            "name": "home_currency",
            "in": "query",
            "required": false,
            "description": "ISO 4217 code for the FX line. Default: the passport country's currency",
            "schema": {
              "type": "string"
            },
            "example": "USD"
          },
          {
            "name": "passport_expiry",
            "in": "query",
            "required": false,
            "description": "Optional passport expiry date YYYY-MM-DD for the validity check",
            "schema": {
              "type": "string"
            },
            "example": "2030-05-01"
          }
        ],
        "responses": {
          "200": {
            "description": "Paid result",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "trip",
                    "visa",
                    "safety",
                    "checklist",
                    "sources"
                  ],
                  "properties": {
                    "trip": {
                      "type": "object"
                    },
                    "defaulted": {
                      "type": "boolean"
                    },
                    "visa": {
                      "type": "object"
                    },
                    "safety": {
                      "type": "object"
                    },
                    "schengen": {
                      "type": "object"
                    },
                    "passport_validity": {
                      "type": "object"
                    },
                    "holidays": {
                      "type": "object"
                    },
                    "money": {
                      "type": "object"
                    },
                    "checklist": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "sources": {
                      "type": "object"
                    },
                    "attribution": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "note": {
                      "type": "string"
                    },
                    "generatedAt": {
                      "type": "string"
                    }
                  }
                },
                "example": {
                  "trip": {
                    "passport": {
                      "code": "US",
                      "name": "United States"
                    },
                    "destination": {
                      "code": "JP",
                      "name": "Japan"
                    },
                    "depart": "2026-12-26",
                    "return": "2027-01-03",
                    "days_in_country": 9,
                    "days_until_departure": 35
                  },
                  "visa": {
                    "requirement": "visa_free",
                    "label": "Visa-free",
                    "max_stay_days": 90,
                    "summary": "Visa-free for up to 90 days.",
                    "fits_trip": true,
                    "assessment": "Your 9-day stay is within the 90-day visa-free allowance."
                  },
                  "safety": {
                    "headline": "US State Dept Level 1 (Exercise Normal Precautions) | UK FCDO: no advice against travel",
                    "max_us_level": 1
                  },
                  "holidays": {
                    "available": true,
                    "during_trip": [
                      {
                        "date": "2027-01-01",
                        "name": "New Year's Day",
                        "local_name": "元日",
                        "nationwide": true
                      }
                    ]
                  },
                  "money": {
                    "home_currency": "USD",
                    "local_currency": "JPY",
                    "rate": 158.64,
                    "example": "100 USD = 15864 JPY",
                    "as_of": "2026-11-20"
                  },
                  "checklist": [
                    "Visa: none needed for this stay (visa-free up to 90 days)."
                  ],
                  "sources": {
                    "visa": "ok",
                    "us_state_department": "ok",
                    "uk_fcdo": "ok",
                    "holidays": "ok",
                    "fx": "ok"
                  },
                  "generatedAt": "2026-11-21T10:00:00.000Z"
                }
              }
            }
          },
          "400": {
            "description": "Invalid input (no payment touched)"
          },
          "402": {
            "description": "Payment required. x402: PAYMENT-REQUIRED header (v2) or JSON body (v1). MPP: WWW-Authenticate: Payment (method tempo, intent charge)."
          },
          "404": {
            "description": "Passport/destination not covered (not charged)"
          },
          "502": {
            "description": "Sources unavailable (not charged)"
          }
        }
      }
    },
    "/v1/advisory": {
      "get": {
        "operationId": "get_travel_advisory",
        "summary": "Travel Advisory: US State Dept + UK FCDO in one call (live)",
        "description": "Is it safe to go? Two governments' official travel advice for one destination, read live: the US State Department advisory level (1-4) with its summary, dates and link, and the UK FCDO travel advice with its alert status (advice against all / all-but-essential travel to all or parts of the country), latest change, warnings section and entry-requirements excerpt. Plus a one-line combined headline. Destination as ISO code or English name. Both sources down = 502, not charged. Also accepts POST with the same fields as a JSON object.",
        "tags": [
          "travel",
          "travel-advisory",
          "safety",
          "state-department",
          "fcdo",
          "risk",
          "duty-of-care",
          "trip-planning",
          "agents"
        ],
        "security": [],
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.04"
          },
          "protocols": [
            {
              "x402": {
                "network": "eip155:8453",
                "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
                "payTo": "0xCcF17CE9D7592bf8Fd6d33D1a688bB5B00F2e11E"
              }
            },
            {
              "mpp": {
                "method": "tempo",
                "intent": "charge",
                "currency": "0x20c000000000000000000000b9537d11c60e8b50"
              }
            }
          ],
          "offers": [
            {
              "amount": "40000",
              "currency": "0x20c000000000000000000000b9537d11c60e8b50",
              "description": "Travel Advisory: US State Dept + UK FCDO in one call (live): $0.04 in USDC.e on Tempo (MPP, pull mode)",
              "intent": "charge",
              "method": "tempo"
            }
          ]
        },
        "parameters": [
          {
            "name": "country",
            "in": "query",
            "required": false,
            "description": "Destination: ISO alpha-2/alpha-3 or English name. Default (bare call): TH",
            "schema": {
              "type": "string"
            },
            "example": "TH"
          }
        ],
        "responses": {
          "200": {
            "description": "Paid result",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "country",
                    "headline",
                    "us_state_department",
                    "uk_fcdo"
                  ],
                  "properties": {
                    "country": {
                      "type": "object"
                    },
                    "defaulted": {
                      "type": "boolean"
                    },
                    "headline": {
                      "type": "string"
                    },
                    "max_us_level": {
                      "type": "integer"
                    },
                    "us_state_department": {
                      "type": "object"
                    },
                    "uk_fcdo": {
                      "type": "object"
                    },
                    "note": {
                      "type": "string"
                    },
                    "generatedAt": {
                      "type": "string"
                    }
                  }
                },
                "example": {
                  "country": {
                    "code": "TH",
                    "name": "Thailand"
                  },
                  "headline": "US State Dept Level 1 (Exercise Normal Precautions) | UK: FCDO advises against all but essential travel to parts of the country",
                  "us_state_department": {
                    "available": true,
                    "advisories": [
                      {
                        "title": "Thailand - Level 1: Exercise Normal Precautions",
                        "level": 1,
                        "level_text": "Exercise Normal Precautions",
                        "summary": "...",
                        "updated": "2026-01-01T00:00:00-05:00",
                        "url": "https://travel.state.gov/..."
                      }
                    ]
                  },
                  "uk_fcdo": {
                    "available": true,
                    "url": "https://www.gov.uk/foreign-travel-advice/thailand",
                    "updated": "2026-11-20T10:00:00Z",
                    "alert_status": [
                      "avoid_all_but_essential_travel_to_parts"
                    ],
                    "alerts": [
                      "FCDO advises against all but essential travel to parts of the country"
                    ],
                    "warnings": "...",
                    "entry_requirements_for_british_citizens": "..."
                  },
                  "generatedAt": "2026-11-21T10:00:00.000Z"
                }
              }
            }
          },
          "400": {
            "description": "Invalid input (no payment touched)"
          },
          "402": {
            "description": "Payment required. x402: PAYMENT-REQUIRED header (v2) or JSON body (v1). MPP: WWW-Authenticate: Payment (method tempo, intent charge)."
          },
          "404": {
            "description": "Passport/destination not covered (not charged)"
          },
          "502": {
            "description": "Sources unavailable (not charged)"
          }
        }
      }
    },
    "/v1/advisory/changes": {
      "get": {
        "operationId": "list_travel_advisory_changes",
        "summary": "Travel Advisory Change Feed: what changed in the last N days (US State Dept + UK FCDO, every country)",
        "description": "Which countries had their official travel advice changed recently, by which government, and what changed: every US State Department advisory reissued or updated in the window (with its current level 1-4 and the State Department's own change note, e.g. \"Reissued with updates to crime information\") and every UK FCDO travel advice update (with GOV.UK's change note), newest first, plus a per-country roll-up. One call replaces polling ~200 countries x 2 governments: built for duty-of-care and travel-risk monitoring agents, travel managers and alert bots that check daily. Optional: days (1-30, default 7), countries (watch-list of up to 50), source (both|us|uk), min_us_level (1-4, e.g. 3 = only Reconsider/Do Not Travel). Both governments unreachable = 502, not charged; one down = 200 with degraded: true and the reason. Also accepts POST with the same fields as a JSON object.",
        "tags": [
          "travel",
          "travel-advisory",
          "change-feed",
          "monitoring",
          "duty-of-care",
          "risk",
          "state-department",
          "fcdo",
          "alerts",
          "agents"
        ],
        "security": [],
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.04"
          },
          "protocols": [
            {
              "x402": {
                "network": "eip155:8453",
                "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
                "payTo": "0xCcF17CE9D7592bf8Fd6d33D1a688bB5B00F2e11E"
              }
            },
            {
              "mpp": {
                "method": "tempo",
                "intent": "charge",
                "currency": "0x20c000000000000000000000b9537d11c60e8b50"
              }
            }
          ],
          "offers": [
            {
              "amount": "40000",
              "currency": "0x20c000000000000000000000b9537d11c60e8b50",
              "description": "Travel Advisory Change Feed: what changed in the last N days (US State Dept + UK FCDO, every country): $0.04 in USDC.e on Tempo (MPP, pull mode)",
              "intent": "charge",
              "method": "tempo"
            }
          ]
        },
        "parameters": [
          {
            "name": "days",
            "in": "query",
            "required": false,
            "description": "Look-back window in days, 1-30. Default 7",
            "schema": {
              "type": "integer"
            },
            "example": 7
          },
          {
            "name": "countries",
            "in": "query",
            "required": false,
            "description": "Optional watch-list: comma-separated ISO alpha-2/alpha-3 codes or English names (up to 50). Omit for every country",
            "schema": {
              "type": "string"
            },
            "example": "MX,TH,FR"
          },
          {
            "name": "source",
            "in": "query",
            "required": false,
            "description": "Which government(s): both (default), us or uk",
            "schema": {
              "type": "string"
            },
            "example": "both"
          },
          {
            "name": "min_us_level",
            "in": "query",
            "required": false,
            "description": "Only US advisories at this level or higher (1-4); UK entries are then left out. Omit for all",
            "schema": {
              "type": "integer"
            },
            "example": 3
          }
        ],
        "responses": {
          "200": {
            "description": "Paid result",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "window",
                    "counts",
                    "changes",
                    "sources"
                  ],
                  "properties": {
                    "window": {
                      "type": "object"
                    },
                    "defaulted": {
                      "type": "boolean"
                    },
                    "filters": {
                      "type": "object"
                    },
                    "counts": {
                      "type": "object"
                    },
                    "countries_changed": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "changes": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "required": [
                          "government",
                          "country",
                          "updated",
                          "title"
                        ],
                        "properties": {
                          "government": {
                            "type": "string",
                            "enum": [
                              "US",
                              "UK"
                            ]
                          },
                          "source": {
                            "type": "string"
                          },
                          "country": {
                            "type": "object"
                          },
                          "updated": {
                            "type": "string",
                            "format": "date-time"
                          },
                          "title": {
                            "type": "string"
                          },
                          "level": {
                            "type": [
                              "integer",
                              "null"
                            ]
                          },
                          "level_text": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "change_note": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "summary": {
                            "type": "string",
                            "description": "US only: first line of the advisory when it does not open with a change note"
                          },
                          "url": {
                            "type": [
                              "string",
                              "null"
                            ]
                          }
                        }
                      }
                    },
                    "sources": {
                      "type": "object"
                    },
                    "degraded": {
                      "type": "boolean"
                    },
                    "note": {
                      "type": "string"
                    },
                    "generatedAt": {
                      "type": "string"
                    }
                  }
                },
                "example": {
                  "window": {
                    "days": 7,
                    "from": "2026-11-14T10:00:00.000Z",
                    "to": "2026-11-21T10:00:00.000Z"
                  },
                  "counts": {
                    "changes": 2,
                    "countries": 2,
                    "us": 1,
                    "uk": 1,
                    "us_level_4": 0,
                    "us_level_3": 0
                  },
                  "countries_changed": [
                    {
                      "country": {
                        "code": "US",
                        "name": "United States"
                      },
                      "us_updated": null,
                      "us_level": null,
                      "uk_updated": "2026-11-20T19:57:12.000Z"
                    },
                    {
                      "country": {
                        "code": "FR",
                        "name": "France"
                      },
                      "us_updated": "2026-11-15T01:00:00.000Z",
                      "us_level": 2,
                      "uk_updated": null
                    }
                  ],
                  "changes": [
                    {
                      "government": "UK",
                      "source": "UK FCDO (GOV.UK)",
                      "country": {
                        "code": "US",
                        "name": "United States"
                      },
                      "updated": "2026-11-20T19:57:12.000Z",
                      "title": "USA travel advice",
                      "change_note": "Removal of information about air traffic disruptions across the US.",
                      "url": "https://www.gov.uk/foreign-travel-advice/usa"
                    },
                    {
                      "government": "US",
                      "source": "US Department of State",
                      "country": {
                        "code": "FR",
                        "name": "France"
                      },
                      "updated": "2026-11-15T01:00:00.000Z",
                      "title": "France - Level 2: Exercise Increased Caution",
                      "level": 2,
                      "level_text": "Exercise Increased Caution",
                      "change_note": "Reissued after periodic review with minor edits.",
                      "url": "https://travel.state.gov/content/tsg_aem/us/en/home/international-travel/travel-advisories/destination.fra.html"
                    }
                  ],
                  "sources": {
                    "us": {
                      "ok": true,
                      "via": "https://cadataapi.state.gov/api/TravelAdvisories"
                    },
                    "uk": {
                      "ok": true,
                      "via": "GOV.UK search API + Atom feeds",
                      "change_notes_missing": 0
                    }
                  },
                  "degraded": false,
                  "note": "Research aid ...",
                  "generatedAt": "2026-11-21T10:00:00.000Z"
                }
              }
            }
          },
          "400": {
            "description": "Invalid input (no payment touched)"
          },
          "402": {
            "description": "Payment required. x402: PAYMENT-REQUIRED header (v2) or JSON body (v1). MPP: WWW-Authenticate: Payment (method tempo, intent charge)."
          },
          "404": {
            "description": "Passport/destination not covered (not charged)"
          },
          "502": {
            "description": "Sources unavailable (not charged)"
          }
        }
      }
    },
    "/v1/visa": {
      "get": {
        "operationId": "check_visa_requirements",
        "summary": "Visa Requirement Check (passport -> destination)",
        "description": "Do I need a visa? For a passport (ISO code or name) and one or up to 25 destinations: visa-free / ETA / e-Visa / visa on arrival / visa required / no admission, the maximum visa-free stay in days, what to do next, and the official government source where the rule was corrected. Omit destination to get the passport's full map (about 197 destinations grouped by requirement, with counts). Data: Visa Requirements Dataset (VisaChecker.org, CC BY 4.0; base matrix 2026-02-17 with primary-source corrections through 2026-08-10), read live. Unknown passport = 404, not charged. Also accepts POST with the same fields as a JSON object.",
        "tags": [
          "travel",
          "visa",
          "visa-requirements",
          "passport",
          "eta",
          "evisa",
          "immigration",
          "trip-planning",
          "agents"
        ],
        "security": [],
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.02"
          },
          "protocols": [
            {
              "x402": {
                "network": "eip155:8453",
                "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
                "payTo": "0xCcF17CE9D7592bf8Fd6d33D1a688bB5B00F2e11E"
              }
            },
            {
              "mpp": {
                "method": "tempo",
                "intent": "charge",
                "currency": "0x20c000000000000000000000b9537d11c60e8b50"
              }
            }
          ],
          "offers": [
            {
              "amount": "20000",
              "currency": "0x20c000000000000000000000b9537d11c60e8b50",
              "description": "Visa Requirement Check (passport -> destination): $0.02 in USDC.e on Tempo (MPP, pull mode)",
              "intent": "charge",
              "method": "tempo"
            }
          ]
        },
        "parameters": [
          {
            "name": "passport",
            "in": "query",
            "required": false,
            "description": "Passport country: ISO alpha-2/alpha-3 or English name. Default (bare call): US",
            "schema": {
              "type": "string"
            },
            "example": "US"
          },
          {
            "name": "destination",
            "in": "query",
            "required": false,
            "description": "Destination country, or a comma-separated list of up to 25. Omit (with passport given) for the full map. Default (bare call): JP",
            "schema": {
              "type": "string"
            },
            "example": "JP"
          }
        ],
        "responses": {
          "200": {
            "description": "Paid result",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "passport",
                    "dataset"
                  ],
                  "properties": {
                    "passport": {
                      "type": "object"
                    },
                    "defaulted": {
                      "type": "boolean"
                    },
                    "results": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "required": [
                          "destination",
                          "requirement",
                          "label"
                        ],
                        "properties": {
                          "destination": {
                            "type": "object"
                          },
                          "requirement": {
                            "type": "string",
                            "enum": [
                              "visa_free",
                              "eta",
                              "evisa",
                              "visa_on_arrival",
                              "visa_required",
                              "no_admission",
                              "home_country",
                              "unknown"
                            ]
                          },
                          "label": {
                            "type": "string"
                          },
                          "max_stay_days": {
                            "type": [
                              "integer",
                              "null"
                            ]
                          },
                          "summary": {
                            "type": "string"
                          },
                          "what_to_do": {
                            "type": "string"
                          },
                          "official_source": {
                            "type": "string"
                          },
                          "verified_on": {
                            "type": "string"
                          },
                          "eta_portal": {
                            "type": "string"
                          }
                        }
                      }
                    },
                    "counts": {
                      "type": "object"
                    },
                    "by_requirement": {
                      "type": "object"
                    },
                    "dataset": {
                      "type": "object"
                    },
                    "note": {
                      "type": "string"
                    },
                    "generatedAt": {
                      "type": "string"
                    }
                  }
                },
                "example": {
                  "passport": {
                    "code": "US",
                    "name": "United States"
                  },
                  "results": [
                    {
                      "passport": "US",
                      "destination": {
                        "code": "JP",
                        "name": "Japan"
                      },
                      "requirement": "visa_free",
                      "label": "Visa-free",
                      "max_stay_days": 90,
                      "summary": "Visa-free for up to 90 days.",
                      "what_to_do": "No visa needed for a short tourist/business visit; carry proof of onward travel and funds as usual."
                    }
                  ],
                  "dataset": {
                    "name": "Visa Requirements Dataset (VisaChecker.org)",
                    "license": "CC BY 4.0",
                    "url": "https://github.com/maxix7/visa-requirements-dataset"
                  },
                  "note": "Research aid compiled from official and openly licensed sources; entry rules change without notice. Confirm with the destination government (or your airline / IATA Timatic) before you book or fly. Not legal or immigration advice.",
                  "generatedAt": "2026-11-21T10:00:00.000Z"
                }
              }
            }
          },
          "400": {
            "description": "Invalid input (no payment touched)"
          },
          "402": {
            "description": "Payment required. x402: PAYMENT-REQUIRED header (v2) or JSON body (v1). MPP: WWW-Authenticate: Payment (method tempo, intent charge)."
          },
          "404": {
            "description": "Passport/destination not covered (not charged)"
          },
          "502": {
            "description": "Sources unavailable (not charged)"
          }
        }
      }
    },
    "/v1/pass": {
      "get": {
        "operationId": "buy_travel_api_day_pass",
        "summary": "Day pass: 24 hours, up to 300 calls",
        "description": "Buy once, call all day: a signed token for up to 300 successful calls to every paid route (trip briefs, advisories, the advisory change feed, visa checks) for 24 hours, over HTTP or MCP. Send it as Authorization: Bearer <token> or X-Trip-Pass: <token>. Pays for itself after 7 trip briefs; meant for booking and travel-assistant agents that check many trips. Also accepts POST with the same fields as a JSON object.",
        "tags": [
          "travel",
          "subscription",
          "day-pass",
          "prepaid"
        ],
        "security": [],
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "1"
          },
          "protocols": [
            {
              "x402": {
                "network": "eip155:8453",
                "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
                "payTo": "0xCcF17CE9D7592bf8Fd6d33D1a688bB5B00F2e11E"
              }
            },
            {
              "mpp": {
                "method": "tempo",
                "intent": "charge",
                "currency": "0x20c000000000000000000000b9537d11c60e8b50"
              }
            }
          ],
          "offers": [
            {
              "amount": "1000000",
              "currency": "0x20c000000000000000000000b9537d11c60e8b50",
              "description": "Day pass: 24 hours, up to 300 calls: $1.00 in USDC.e on Tempo (MPP, pull mode)",
              "intent": "charge",
              "method": "tempo"
            }
          ]
        },
        "parameters": [],
        "responses": {
          "200": {
            "description": "Paid result",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "pass": {
                      "type": "string"
                    },
                    "expires_at": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "max_calls": {
                      "type": "integer"
                    },
                    "use": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "pass",
                    "expires_at"
                  ]
                },
                "example": {
                  "pass": "tp1.eyJ2IjoxLC4uLn0.abc",
                  "expires_at": "2026-11-23T00:00:00.000Z",
                  "max_calls": 300,
                  "use": "Send Authorization: Bearer <pass> ..."
                }
              }
            }
          },
          "400": {
            "description": "Invalid input (no payment touched)"
          },
          "402": {
            "description": "Payment required. x402: PAYMENT-REQUIRED header (v2) or JSON body (v1). MPP: WWW-Authenticate: Payment (method tempo, intent charge)."
          },
          "404": {
            "description": "Passport/destination not covered (not charged)"
          },
          "502": {
            "description": "Sources unavailable (not charged)"
          }
        }
      }
    },
    "/v1/peek": {
      "get": {
        "summary": "Free preview: visa category only",
        "security": [],
        "parameters": [
          {
            "name": "passport",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "destination",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/v1/pass/transfer": {
      "get": {
        "operationId": "pass_transfer_quote",
        "summary": "Free: how to buy the Trip Desk Pass with a plain USDC transfer on Base (1 USDC = 24 h, 5 USDC = 7 days)",
        "security": [],
        "responses": {
          "200": {
            "description": "Receiving address, tiers, EIP-681 links, steps"
          }
        }
      }
    },
    "/v1/pass/redeem": {
      "get": {
        "operationId": "pass_redeem_transfer",
        "summary": "Free: redeem a plain USDC transfer on Base for the Trip Desk Pass bearer token (same tx = same token)",
        "security": [],
        "parameters": [
          {
            "name": "tx",
            "in": "query",
            "required": true,
            "description": "0x hash of your USDC transfer on Base",
            "schema": {
              "type": "string",
              "pattern": "^0x[0-9a-fA-F]{64}$"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Pass token"
          },
          "402": {
            "description": "No / too small USDC transfer to the receiving address"
          },
          "409": {
            "description": "An x402 payment (not redeemable)"
          }
        }
      }
    },
    "/mcp": {
      "post": {
        "operationId": "mcp",
        "summary": "Remote MCP server (Streamable HTTP, JSON-RPC 2.0, stateless). Paid tools: x402 over MCP / MPP over MCP (/mcp/tempo) / Trip Desk Pass bearer header.",
        "security": [],
        "responses": {
          "200": {
            "description": "JSON-RPC response"
          }
        }
      }
    },
    "/": {
      "get": {
        "summary": "Free",
        "security": [],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/health": {
      "get": {
        "summary": "Free",
        "security": [],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/health/sources": {
      "get": {
        "summary": "Free",
        "security": [],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/llms.txt": {
      "get": {
        "summary": "Free",
        "security": [],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/api": {
      "get": {
        "summary": "Free",
        "security": [],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  }
}