{
  "$schema": "https://static.modelcontextprotocol.io/schemas/mcp-server-card/v1.json",
  "version": "1.0",
  "protocolVersion": "2025-11-25",
  "serverInfo": {
    "name": "nostr-relays",
    "title": "Nostr Relays",
    "version": "1.0.0",
    "websiteUrl": "https://nostr-relays.com"
  },
  "description": "Live directory of public nostr relays: status, uptime, users, recommendations, profile relay lists and event lookup.",
  "instructions": "Live data about public nostr relays and the profiles and events on them.\nStart with search_relays or recommend_relays to pick relays, get_relay for one relay's status, uptime and NIP-11 info,\nlookup_profile for someone's relay list (accepts a name, npub, nprofile, hex key or NIP-05), and find_event to see which\nrelays hold a note plus its censorship resistance score. build_relay_list turns relay URLs into an unsigned NIP-65 event.\nResources hold the site guide (llms.txt) and plain language guides about relays. Every result includes a \"page\" URL on https://nostr-relays.com you can link the user to. Data refreshes every few minutes.",
  "transport": {
    "type": "streamable-http",
    "endpoint": "https://nostr-relays.com/mcp"
  },
  "remotes": [
    {
      "type": "streamable-http",
      "url": "https://nostr-relays.com/mcp"
    }
  ],
  "authentication": {
    "required": false
  },
  "capabilities": {
    "tools": {
      "listChanged": false
    },
    "resources": {
      "listChanged": false,
      "subscribe": false
    },
    "prompts": {
      "listChanged": false
    }
  },
  "tools": [
    {
      "name": "search_relays",
      "title": "Search the nostr relay directory",
      "description": "List public nostr relays ranked by how many real profiles use them, with live online status, latency, payment/auth flags and supported NIPs. Filter by text, status and minimum users."
    },
    {
      "name": "get_relay",
      "title": "Check one nostr relay",
      "description": "Live status, latency, user count, NIP-11 information document (name, software, supported NIPs, limits, fees) and uptime percentages over 24h, 7d, 30d and 90d for a single relay."
    },
    {
      "name": "get_relay_users",
      "title": "Who uses a relay",
      "description": "Indexed nostr profiles that list a relay in their relay list (NIP-65 or kind 3), most followed first."
    },
    {
      "name": "recommend_relays",
      "title": "Recommend nostr relays",
      "description": "Curated relay picks from live data. Groups: starter (best free general purpose set), fast (lowest latency), paid (low spam), search (NIP-50), features (most NIPs). Each relay has a 0 to 100 score from reach, latency and NIP support."
    },
    {
      "name": "lookup_profile",
      "title": "Look up a nostr profile and its relays",
      "description": "Resolve a nostr identity (display name, npub, nprofile, hex pubkey, nostr: URI or NIP-05 like alice@example.com) and return the profile plus its read/write relay list with live status. A plain name returns matching profiles to choose from."
    },
    {
      "name": "find_event",
      "title": "Find which relays hold a nostr event",
      "description": "Query relays live for one event (note1, nevent1, naddr1, hex id, or a client URL containing one). Reports which relays have it, a signature checked preview, and a censorship resistance score (0 to 100) based on how many independent operators hold a copy. Takes up to about 20 seconds."
    },
    {
      "name": "build_relay_list",
      "title": "Build a NIP-65 relay list event",
      "description": "Normalise relay addresses and return an unsigned kind 10002 (NIP-65) event the user can sign with their own client or signer. Never ask for a private key."
    }
  ],
  "prompts": [
    {
      "name": "choose_relays",
      "title": "Choose nostr relays",
      "description": "Pick a good set of relays for a new or existing nostr user and produce a NIP-65 list."
    },
    {
      "name": "audit_my_relays",
      "title": "Audit a profile's relays",
      "description": "Check a nostr profile's relay list for offline, slow or concentrated relays and suggest fixes."
    },
    {
      "name": "check_note_reach",
      "title": "Check where a note lives",
      "description": "Find which relays hold a nostr event and explain how censorship resistant it is."
    }
  ],
  "resources": [
    {
      "uri": "https://nostr-relays.com/llms.txt",
      "name": "llms.txt",
      "title": "Nostr Relays guide for agents"
    },
    {
      "uri": "https://nostr-relays.com/nostr-relays.md",
      "name": "nostr-relays.md",
      "title": "Nostr relay list"
    },
    {
      "uri": "https://nostr-relays.com/best-nostr-relays.md",
      "name": "best-nostr-relays.md",
      "title": "Best nostr relays"
    },
    {
      "uri": "https://nostr-relays.com/free-nostr-relays.md",
      "name": "free-nostr-relays.md",
      "title": "Free nostr relays"
    },
    {
      "uri": "https://nostr-relays.com/paid-nostr-relays.md",
      "name": "paid-nostr-relays.md",
      "title": "Paid nostr relays"
    },
    {
      "uri": "https://nostr-relays.com/fastest-nostr-relays.md",
      "name": "fastest-nostr-relays.md",
      "title": "Fastest nostr relays"
    },
    {
      "uri": "https://nostr-relays.com/nostr-search-relays.md",
      "name": "nostr-search-relays.md",
      "title": "Nostr search relays"
    },
    {
      "uri": "https://nostr-relays.com/nostr-relay-checker.md",
      "name": "nostr-relay-checker.md",
      "title": "Nostr relay checker"
    },
    {
      "uri": "https://nostr-relays.com/find-nostr-event.md",
      "name": "find-nostr-event.md",
      "title": "Find a nostr event"
    },
    {
      "uri": "https://nostr-relays.com/what-is-a-nostr-relay.md",
      "name": "what-is-a-nostr-relay.md",
      "title": "What is a nostr relay?"
    }
  ],
  "documentation": "https://nostr-relays.com/llms.txt"
}