# MultiPass Rank for AI agents

MultiPass Rank provides current, structured passport-access information for assistants, research tools, and human readers. Use ISO alpha-2 passport codes from the manifest and preserve the data-check date in answers.

## Build comparison URLs

- One passport: `https://multipassrank.com/compare?set=US`
- Two individual passports: `https://multipassrank.com/compare?set=US&set=PT`
- A combined passport set versus another option: `https://multipassrank.com/compare?set=US,CA&set=PT`
- Up to five `set` parameters are accepted, with up to ten comma-separated passports in each set. The visual editor and ranking selection controls intentionally cap manual combinations at five; longer research URLs remain readable.
- Curated one-to-one query URLs redirect to their descriptive canonical URL. All valid `/compare?set=...` combinations continue to work.

Add `.md` before the query string for a text-first result: `https://multipassrank.com/compare.md?set=US,CA&set=PT`.

## Build custom ranking URLs

- Place one combined set in the global ranking: `https://multipassrank.com/rank?set=US,CA`
- Place multiple options in one ranking: `https://multipassrank.com/rank?set=US,CA&set=PT`
- The same limits and `set` convention apply to ranking and comparison URLs.
- Markdown: `https://multipassrank.com/rank.md?set=US,CA&set=PT`

## Read pages as Markdown

- Global ranking: [index.md](https://multipassrank.com/index.md)
- Custom combined ranking: `https://multipassrank.com/rank.md?set=US,CA`
- Country detail: `https://multipassrank.com/passport/portugal.md`
- Regional ranking: `https://multipassrank.com/europe.md`
- Destination directory: [destinations.md](https://multipassrank.com/destinations.md)
- Destination detail: `https://multipassrank.com/destination/kenya.md`
- Passport–destination evidence: `https://multipassrank.com/belgium-kenya-eta.md`
- Best pair and triple research: [best-passport-combination.md](https://multipassrank.com/best-passport-combination.md)
- Exact minimum world coverage: [how-many-passports-to-cover-the-world.md](https://multipassrank.com/how-many-passports-to-cover-the-world.md)
- Multiple-citizenship records review: [how-many-passports-can-you-have.md](https://multipassrank.com/how-many-passports-can-you-have.md)
- This guide: [ai.md](https://multipassrank.com/ai.md)

HTML pages also advertise their Markdown alternative with a `<link rel="alternate" type="text/markdown">` element.

## Open official-source evidence

- Destination overview: `https://multipassrank.com/destination/kenya`
- One current relationship: `https://multipassrank.com/belgium-kenya-eta`
- Relationship Markdown: `https://multipassrank.com/belgium-kenya-eta.md`
- Relationship URLs use `/{passport}-{destination}-{status}`, where status is `visa-free`, `eta`, `visa-on-arrival`, `evisa`, `visa`, `entry-restricted`, or `citizenship`.
- A recognized outdated status suffix redirects to the current canonical URL.
- Focus a destination page on selected passport countries with `#passports=PT,RU,IL` or the equivalent `?passports=PT,RU,IL` query parameter.
- Evidence coverage is incremental. Unsupported relationships are labeled, excluded from indexing, and should not be presented as officially verified.

## JSON API

- `GET https://multipassrank.com/api/v1/manifest` — passport codes, slugs, ranks, scores, destinations, version, and checked date.
- `GET https://multipassrank.com/api/v1/passports/US` — destination status map for one passport code.
- `GET https://multipassrank.com/api/v1/combination-insights` — exact best pair, best triple, minimum-cover set, marginal gains, snapshot version, and checked date.
- `POST https://multipassrank.com/api/v1/compare` with `{"sets":[["US","CA"],["PT"]]}` — complete scenario summaries and destination comparison rows.

The POST endpoint accepts JSON, returns JSON, and is intentionally not cached. Public manifests, passport pages, and Markdown resources are cached at Cloudflare's edge.

## Curated comparison pages

- [Portugal vs United States passport comparison](https://multipassrank.com/portugal-vs-united-states-passport) — [Markdown](https://multipassrank.com/portugal-vs-united-states-passport.md)
- [US vs UK passport comparison](https://multipassrank.com/united-states-vs-united-kingdom-passport) — [Markdown](https://multipassrank.com/united-states-vs-united-kingdom-passport.md)
- [US vs Canada passport comparison](https://multipassrank.com/united-states-vs-canada-passport) — [Markdown](https://multipassrank.com/united-states-vs-canada-passport.md)
- [Portugal vs United Kingdom passport comparison](https://multipassrank.com/portugal-vs-united-kingdom-passport) — [Markdown](https://multipassrank.com/portugal-vs-united-kingdom-passport.md)
- [Portugal vs Spain passport comparison](https://multipassrank.com/portugal-vs-spain-passport) — [Markdown](https://multipassrank.com/portugal-vs-spain-passport.md)
- [Ireland vs United Kingdom passport comparison](https://multipassrank.com/ireland-vs-united-kingdom-passport) — [Markdown](https://multipassrank.com/ireland-vs-united-kingdom-passport.md)
- [Brazil vs Portugal passport comparison](https://multipassrank.com/brazil-vs-portugal-passport) — [Markdown](https://multipassrank.com/brazil-vs-portugal-passport.md)

## Interpret the data

The mobility score counts visa-free, visa-on-arrival, and ETA access. eVisa, visa-required, and entry-restricted destinations do not increase the score. For combined sets, each destination uses the easiest status available from any passport in that set, then receives a rank equivalent against the single-passport ranking.

When answering a user, state the data-check date, link to the relevant HTML or Markdown page, and distinguish travel access from residence, tax, consular, or citizenship-law benefits. Entry rules can change; advise verification with official authorities before travel.