Connect

8 clients · secrets stay placeholders

JSON (mcpServers)Claude CodeCodexOpenCodeCursorVS CodeGemini CLIGoose

{
  "mcpServers": {
    "nomads": {
      "type": "http",
      "url": "https://nomads.com/mcp",
      "headers": {
        "Authorization": "Bearer ${NOMADS_TOKEN}"
      }
    }
  }
}

claude mcp add --transport http nomads https://nomads.com/mcp --header "Authorization: Bearer ${NOMADS_TOKEN}"

[mcp_servers.nomads]
url = "https://nomads.com/mcp"
bearer_token_env_var = "NOMADS_TOKEN"

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "nomads": {
      "type": "remote",
      "url": "https://nomads.com/mcp",
      "enabled": true,
      "headers": {
        "Authorization": "Bearer {env:NOMADS_TOKEN}"
      }
    }
  }
}

{
  "mcpServers": {
    "nomads": {
      "type": "http",
      "url": "https://nomads.com/mcp",
      "headers": {
        "Authorization": "Bearer ${NOMADS_TOKEN}"
      }
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=nomads&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vbm9tYWRzLmNvbS9tY3AiLCJoZWFkZXJzIjp7IkF1dGhvcml6YXRpb24iOiJCZWFyZXIgJHtOT01BRFNfVE9LRU59In19"
}

{
  "servers": {
    "nomads": {
      "type": "http",
      "url": "https://nomads.com/mcp",
      "headers": {
        "Authorization": "Bearer ${NOMADS_TOKEN}"
      }
    }
  }
}

{
  "mcpServers": {
    "nomads": {
      "httpUrl": "https://nomads.com/mcp",
      "headers": {
        "Authorization": "Bearer ${NOMADS_TOKEN}"
      }
    }
  }
}

extensions:
  "nomads":
    enabled: true
    name: "nomads"
    type: streamable_http
    uri: "https://nomads.com/mcp"
    headers:
      "Authorization": "Bearer ${NOMADS_TOKEN}"
    timeout: 300

Placeholders to fill from your own secret store: ${NOMADS_TOKEN}. The registry never accepts secret values.

Quality 85 / 100good

protocol75 · weight 25

warn
protocol.modernnewest supported version is 2024-11-05; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
n/a
protocol.statelessonly applies to 2026-07-28 servers
pass
protocol.transportstreamable HTTP
n/a
protocol.list_ttlonly applies to 2026-07-28 servers

authorizationn/a · weight 15

n/a
auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
n/a
auth.secret_in_urlno templated URL

tool hygiene94 · weight 30

pass
tools.descriptionsevery tool has a description
pass
tools.description_lengthdescriptions are concise
pass
tools.schemasevery tool has an object input schema
pass
tools.annotations14 of 14 tools declare readOnlyHint or destructiveHint
warn
tools.directory_hints8 of 14 tools declare all four hints; missing: search_cities (destructiveHint, idempotentHint); get_country (destructiveHint, idempotentHint); get_favorites (destructiveHint, idempotentHint); …
pass
tools.token_costabout 3,693 tokens to load every tool
pass
tools.api_dumptools are not a one-to-one API dump
pass
tools.hidden_textno hidden text in tool names, descriptions, schemas or annotations

stability83 · weight 15

warn
stability.changes10 tool changes in 30 days
pass
stability.rug_pullno tool changed its meaning under the same name
pass
stability.new_linksno tool change named a new site

dependenciesn/a · weight 15

n/a
deps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI package

14 tools, about 3,693 tokens to load them all · tool set eb744eda1020 · tools last changed 2026-10-29 · checked 2026-11-14 07:36 UTC

Tool changes

2026-10-29edit_tripchangeddescription, input schema
before
Change the dates and/or the place of one trip in a Nomads.com member's own history, e.g. a stay that got longer or a wrong city. Authenticated as the member (connector Authorization header, or username + personal key from https://nomads.com/settings). Needs the trip_id (from get_trips); pass only what changes, everything else keeps its value. The trip keeps its trip_id, likes and comments. A new place works like add_trip: city_slug, OR latitude+longitude (snaps to a Nomads.com city within 5km, otherwise pass city and country names).
after · 93% of words in common
Change the dates and/or the place of one trip in a Nomads.com member's own history, e.g. a stay that got longer or a wrong city. Authenticated as the member (signed in through the connector with OAuth or an Authorization header, or username + personal key from https://nomads.com/settings). Needs the trip_id (from get_trips); pass only what changes, everything else keeps its value. The trip keeps its trip_id, likes and comments. A new place works like add_trip: city_slug, OR latitude+longitude (snaps to a Nomads.com city within 5km, otherwise pass city and country names).
2026-10-29remove_tripchangeddescription, input schema
before
Remove one trip from a Nomads.com member's own history, e.g. a duplicate or a superseded entry. Authenticated as the member (connector Authorization header, or username + personal key from https://nomads.com/settings). Needs the trip_id (returned by get_trips). Only the authenticated member's own trips can be removed.
after · 86% of words in common
Remove one trip from a Nomads.com member's own history, e.g. a duplicate or a superseded entry. Authenticated as the member (signed in through the connector with OAuth or an Authorization header, or username + personal key from https://nomads.com/settings). Needs the trip_id (returned by get_trips). Only the authenticated member's own trips can be removed.
2026-10-29add_tripchangeddescription, input schema
before
Add a trip to a Nomads.com member's own history: a stay in one place with a start and end date. Authenticated as the member: by the connector's Authorization header if set up, otherwise pass the member's username and their personal key from https://nomads.com/settings, plus the place, given EITHER as city_slug (from search_cities/get_city) OR as latitude+longitude (e.g. from a places/geocoding lookup). Coordinates within 5km of a Nomads.com city snap to it, same as the profile page's "add a trip" autocomplete; ANY other place also works - pass its city and country names with the coordinates and it is stored as-is, like the site's own trip editor.
after · 93% of words in common
Add a trip to a Nomads.com member's own history: a stay in one place with a start and end date. Authenticated as the member: signed in through the connector (OAuth sign-in or an Authorization header) if set up, otherwise pass the member's username and their personal key from https://nomads.com/settings, plus the place, given EITHER as city_slug (from search_cities/get_city) OR as latitude+longitude (e.g. from a places/geocoding lookup). Coordinates within 5km of a Nomads.com city snap to it, same as the profile page's "add a trip" autocomplete; ANY other place also works - pass its city and country names with the coordinates and it is stored as-is, like the site's own trip editor.
2026-10-29get_tripschangeddescription, input schema
before
Get a Nomads.com member's own trip history (past and upcoming stays: city, country, dates). Authenticated as the member: by the connector's Authorization header if set up, otherwise pass the member's username and their personal key from https://nomads.com/settings - this is private data, not for looking up other people.
after · 72% of words in common
Get a Nomads.com member's own trip history (past and upcoming stays: city, country, dates), newest first, 200 by default; use from_date/to_date for a period and limit for more. Authenticated as the member: signed in through the connector (OAuth sign-in or an Authorization header) if set up, otherwise pass the member's username and their personal key from https://nomads.com/settings - this is private data, not for looking up other people.
2026-10-29remove_favoritechangedinput schema
2026-10-29add_favoritechangedinput schema
2026-10-29get_favoriteschangeddescription, input schema
before
Get a Nomads.com member's own favorite cities and countries (the places they hearted: places they want to go or come back to). Authenticated as the member: by the connector's Authorization header if set up, otherwise pass the member's username and their personal key from https://nomads.com/settings - this is private data, not for looking up other people.
after · 87% of words in common
Get a Nomads.com member's own favorite cities and countries (the places they hearted: places they want to go or come back to). Authenticated as the member: signed in through the connector (OAuth sign-in or an Authorization header) if set up, otherwise pass the member's username and their personal key from https://nomads.com/settings - this is private data, not for looking up other people.
2026-10-29cancel_meetupchangedinput schema
2026-10-29edit_meetupchangedinput schema
2026-10-29create_meetupchangeddescription, input schema
before
Host a Nomads.com meetup as the member: it is posted in the community chat, members in that city then get notified, and at 2 RSVPs it is also shared in the country channel and on X. Authenticated as the member (connector Authorization header, or username + personal key from https://nomads.com/settings). The member needs a profile photo and Telegram connected. Ask the member to confirm the details before calling this, it is posted publicly.
after · 92% of words in common
Host a Nomads.com meetup as the member: it is posted in the community chat, members in that city then get notified, and at 2 RSVPs it is also shared in the country channel and on X. Authenticated as the member (signed in through the connector with OAuth or an Authorization header, or username + personal key from https://nomads.com/settings). The member needs a profile photo and Telegram connected. Ask the member to confirm the details before calling this, it is posted publicly.

Full history: list_changes · trend: quality JSON.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 82 / 100

no-repository

provenance55

liveness98

freshness100

hygiene80

+dns-namespace +website +reachable +uptime-95% +updated-16d-ago -no-repository

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Endpoints

remote	auth	reachable	uptime 30d	p50	protocol	last ok
`https://nomads.com/mcp` streamable-http	none	yes	95%	366 ms	2024-11-05	2026-11-14

Tools (14)

`add_favorite`	Save a city or country to the member's Nomads.com favorites (the heart on the site). Authenticated as the member, like get_favorites.
`add_trip`	Add a trip to a Nomads.com member's own history: a stay in one place with a start and end date. Authenticated as the member: signed in through the connector (OAuth sign-in or an Authorization header) if set up, otherwise pass the member's username and their personal key from https://nomads.com/settings, plus the place, given EITHER as city_slug (from search_cities/get_city) OR as latitude+longitude (e.g. from a places/geocoding lookup). Coordinates within 5km of a Nomads.com city snap to it, same as the profile page's "add a trip" autocomplete; ANY other place also works - pass its city and country names with the coordinates and it is stored as-is, like the site's own trip editor.
`cancel_meetup`destructive	Cancel a Nomads.com meetup the member organized. The cancel is posted in the community chat and everyone who RSVP'd gets a notification. It cannot be undone. Call without meetup_id to get the member's upcoming meetups with their ids. Authenticated as the member, like create_meetup. Ask the member to confirm first.
`create_meetup`	Host a Nomads.com meetup as the member: it is posted in the community chat, members in that city then get notified, and at 2 RSVPs it is also shared in the country channel and on X. Authenticated as the member (signed in through the connector with OAuth or an Authorization header, or username + personal key from https://nomads.com/settings). The member needs a profile photo and Telegram connected. Ask the member to confirm the details before calling this, it is posted publicly.
`edit_meetup`	Change a Nomads.com meetup the member organized: date, time, type, title, description, venue or address. Fields left out keep their current value. The change is posted in the community chat. Once 2+ people RSVP'd, the date and time can no longer change. Call without meetup_id to get the member's upcoming meetups with their ids. Authenticated as the member, like create_meetup. Ask the member to confirm the change first.
`edit_trip`	Change the dates and/or the place of one trip in a Nomads.com member's own history, e.g. a stay that got longer or a wrong city. Authenticated as the member (signed in through the connector with OAuth or an Authorization header, or username + personal key from https://nomads.com/settings). Needs the trip_id (from get_trips); pass only what changes, everything else keeps its value. The trip keeps its trip_id, likes and comments. A new place works like add_trip: city_slug, OR latitude+longitude (snaps to a Nomads.com city within 5km, otherwise pass city and country names).
`get_city`read-only	Get the curated data for one city by its slug (from search_cities), e.g. lisbon-portugal.
`get_country`read-only	Get one country by its slug, e.g. portugal or united-kingdom: its Nomads.com page, its short animated thumbnail video (mp4, when there is one) and its top 10 cities by overall score, each with their own animated thumbnail.
`get_favorites`read-only	Get a Nomads.com member's own favorite cities and countries (the places they hearted: places they want to go or come back to). Authenticated as the member: signed in through the connector (OAuth sign-in or an Authorization header) if set up, otherwise pass the member's username and their personal key from https://nomads.com/settings - this is private data, not for looking up other people.
`get_trips`read-only	Get a Nomads.com member's own trip history (past and upcoming stays: city, country, dates), newest first, 200 by default; use from_date/to_date for a period and limit for more. Authenticated as the member: signed in through the connector (OAuth sign-in or an Authorization header) if set up, otherwise pass the member's username and their personal key from https://nomads.com/settings - this is private data, not for looking up other people.
`list_meetups`read-only	Upcoming Nomads.com meetups: where and when nomads meet in person, and how many people are going. Filter by city slug, country or how far ahead to look. Attendance is a count only; who attends is private.
`remove_favorite`destructive	Remove a city or country from the member's Nomads.com favorites. Authenticated as the member, like get_favorites.
`remove_trip`destructive	Remove one trip from a Nomads.com member's own history, e.g. a duplicate or a superseded entry. Authenticated as the member (signed in through the connector with OAuth or an Authorization header, or username + personal key from https://nomads.com/settings). Needs the trip_id (returned by get_trips). Only the authenticated member's own trips can be removed.
`search_cities`read-only	Search Nomads.com for the best cities to live and work remotely. Filters: budget, region, country, internet speed, safety, temperature. Returns at most 100 cities sorted by overall score. Each city includes costs, internet, weather, air quality, safety/cleanliness/healthcare/fun and other 0-5 scores, air conditioning (share of households, availability 1-5), tax burden (tax revenue as % of GDP) and an animated thumbnail video.

Schemas: list_tools.

Similar MCP servers

Official server.json

{
  "name": "com.nomads/mcp",
  "icons": [
    {
      "src": "https://nomads.com/assets/logo.svg",
      "mimeType": "image/svg+xml"
    }
  ],
  "title": "Nomads.com",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "remotes": [
    {
      "url": "https://nomads.com/mcp",
      "type": "streamable-http",
      "headers": [
        {
          "name": "Authorization",
          "isSecret": true,
          "description": "Optional. Only for the member tools (trips, favorites, meetups): Bearer <username>:<key>, with the personal key from https://nomads.com/settings. City search works without it."
        }
      ]
    }
  ],
  "version": "1.0.0",
  "websiteUrl": "https://nomads.com/mcp",
  "description": "Find the best cities to live and work remotely: cost of living, internet, safety, weather and more."
}