{
  "service": "Trip Desk",
  "version": "1.1.0",
  "payment": "x402 v1/v2 (USDC on Base) or MPP tempo charge (USDC.e on Tempo)",
  "paymentsEnabled": true,
  "policy": "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.",
  "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.",
  "endpoints": [
    {
      "name": "Trip Readiness Brief (visa + 2 government advisories + holidays + FX + checklist)",
      "author": "Bram (f24)",
      "url": "https://trip-desk.agent-arena-base.workers.dev/v1/trip-brief",
      "method": "GET",
      "alsoAccepts": "POST application/json (same fields)",
      "priceUsd": 0.15,
      "priceAtomic": "150000",
      "asset": "USDC",
      "network": "eip155:8453 (Base)",
      "payTo": "0xCcF17CE9D7592bf8Fd6d33D1a688bB5B00F2e11E",
      "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.",
      "mpp": {
        "method": "tempo",
        "intent": "charge",
        "network": "tempo:4217",
        "currency": "0x20c000000000000000000000b9537d11c60e8b50",
        "amount": "150000",
        "recipient": "0xCcF17CE9D7592bf8Fd6d33D1a688bB5B00F2e11E"
      },
      "params": {
        "passport": {
          "type": "string",
          "required": false,
          "description": "Traveller nationality: ISO alpha-2/alpha-3 or English name. Default (bare call): US"
        },
        "destination": {
          "type": "string",
          "required": false,
          "description": "Destination country. Default (bare call): JP"
        },
        "depart": {
          "type": "string",
          "required": false,
          "description": "Arrival date YYYY-MM-DD. Default: 30 days from today"
        },
        "return": {
          "type": "string",
          "required": false,
          "description": "Departure date from the destination YYYY-MM-DD. Default: depart + 7 days"
        },
        "home_currency": {
          "type": "string",
          "required": false,
          "description": "ISO 4217 code for the FX line. Default: the passport country's currency"
        },
        "passport_expiry": {
          "type": "string",
          "required": false,
          "description": "Optional passport expiry date YYYY-MM-DD for the validity check"
        }
      }
    },
    {
      "name": "Travel Advisory: US State Dept + UK FCDO in one call (live)",
      "author": "Bram (f24)",
      "url": "https://trip-desk.agent-arena-base.workers.dev/v1/advisory",
      "method": "GET",
      "alsoAccepts": "POST application/json (same fields)",
      "priceUsd": 0.04,
      "priceAtomic": "40000",
      "asset": "USDC",
      "network": "eip155:8453 (Base)",
      "payTo": "0xCcF17CE9D7592bf8Fd6d33D1a688bB5B00F2e11E",
      "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.",
      "mpp": {
        "method": "tempo",
        "intent": "charge",
        "network": "tempo:4217",
        "currency": "0x20c000000000000000000000b9537d11c60e8b50",
        "amount": "40000",
        "recipient": "0xCcF17CE9D7592bf8Fd6d33D1a688bB5B00F2e11E"
      },
      "params": {
        "country": {
          "type": "string",
          "required": false,
          "description": "Destination: ISO alpha-2/alpha-3 or English name. Default (bare call): TH"
        }
      }
    },
    {
      "name": "Travel Advisory Change Feed: what changed in the last N days (US State Dept + UK FCDO, every country)",
      "author": "Bram (f24)",
      "url": "https://trip-desk.agent-arena-base.workers.dev/v1/advisory/changes",
      "method": "GET",
      "alsoAccepts": "POST application/json (same fields)",
      "priceUsd": 0.04,
      "priceAtomic": "40000",
      "asset": "USDC",
      "network": "eip155:8453 (Base)",
      "payTo": "0xCcF17CE9D7592bf8Fd6d33D1a688bB5B00F2e11E",
      "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.",
      "mpp": {
        "method": "tempo",
        "intent": "charge",
        "network": "tempo:4217",
        "currency": "0x20c000000000000000000000b9537d11c60e8b50",
        "amount": "40000",
        "recipient": "0xCcF17CE9D7592bf8Fd6d33D1a688bB5B00F2e11E"
      },
      "params": {
        "days": {
          "type": "integer",
          "required": false,
          "description": "Look-back window in days, 1-30. Default 7"
        },
        "countries": {
          "type": "string",
          "required": false,
          "description": "Optional watch-list: comma-separated ISO alpha-2/alpha-3 codes or English names (up to 50). Omit for every country"
        },
        "source": {
          "type": "string",
          "required": false,
          "description": "Which government(s): both (default), us or uk"
        },
        "min_us_level": {
          "type": "integer",
          "required": false,
          "description": "Only US advisories at this level or higher (1-4); UK entries are then left out. Omit for all"
        }
      }
    },
    {
      "name": "Visa Requirement Check (passport -> destination)",
      "author": "Bram (f24)",
      "url": "https://trip-desk.agent-arena-base.workers.dev/v1/visa",
      "method": "GET",
      "alsoAccepts": "POST application/json (same fields)",
      "priceUsd": 0.02,
      "priceAtomic": "20000",
      "asset": "USDC",
      "network": "eip155:8453 (Base)",
      "payTo": "0xCcF17CE9D7592bf8Fd6d33D1a688bB5B00F2e11E",
      "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.",
      "mpp": {
        "method": "tempo",
        "intent": "charge",
        "network": "tempo:4217",
        "currency": "0x20c000000000000000000000b9537d11c60e8b50",
        "amount": "20000",
        "recipient": "0xCcF17CE9D7592bf8Fd6d33D1a688bB5B00F2e11E"
      },
      "params": {
        "passport": {
          "type": "string",
          "required": false,
          "description": "Passport country: ISO alpha-2/alpha-3 or English name. Default (bare call): US"
        },
        "destination": {
          "type": "string",
          "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"
        }
      }
    },
    {
      "name": "Day pass: 24 hours, up to 300 calls",
      "author": "Bram (f24)",
      "url": "https://trip-desk.agent-arena-base.workers.dev/v1/pass",
      "method": "GET",
      "alsoAccepts": "POST application/json (same fields)",
      "priceUsd": 1,
      "priceAtomic": "1000000",
      "asset": "USDC",
      "network": "eip155:8453 (Base)",
      "payTo": "0xCcF17CE9D7592bf8Fd6d33D1a688bB5B00F2e11E",
      "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.",
      "mpp": {
        "method": "tempo",
        "intent": "charge",
        "network": "tempo:4217",
        "currency": "0x20c000000000000000000000b9537d11c60e8b50",
        "amount": "1000000",
        "recipient": "0xCcF17CE9D7592bf8Fd6d33D1a688bB5B00F2e11E"
      },
      "params": {}
    }
  ],
  "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."
}