{
  "$schema": "https://static.modelcontextprotocol.io/schemas/mcp-server-card/v1.json",
  "version": "1.0",
  "protocolVersion": "2025-11-25",
  "serverInfo": {
    "name": "psychicwho",
    "title": "PsychicWho — psychic advisor finder",
    "version": "2.0.0",
    "websiteUrl": "https://psychicwho.com"
  },
  "description": "Find psychic advisors that fit a question, budget and reading style, explained with figures from their public client reviews; look up any advisor's research dossier; compare platforms and their dated new-customer offers. Read-only, no key.",
  "documentationUrl": "https://psychicwho.com/llms.txt",
  "transport": {
    "type": "streamable-http",
    "endpoint": "https://psychicwho.com/mcp"
  },
  "capabilities": {
    "tools": {
      "listChanged": false
    },
    "prompts": {
      "listChanged": false
    }
  },
  "authentication": {
    "required": false,
    "schemes": []
  },
  "tools": [
    {
      "name": "recommend_advisors",
      "title": "Recommend psychic advisors",
      "description": "Recommend psychic advisors for what the user needs: a topic (love, an ex, twin flame, career, contacting someone who passed, a pet, spiritual guidance, life purpose), a budget, how they want to talk, and the reading style they like. Uses PsychicWho's published match engine: it screens on topic, channel and price, then scores fit from what clients actually wrote in public reviews, plus client satisfaction. Returns advisors with price, rating, the review figures behind each pick, a heads-up when a relevant complaint is elevated, the new-client offer, profile_url and booking_url. Leave out anything the user did not say.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "topic": {
            "type": "string",
            "enum": [
              "love-relationships",
              "ex-back-reconciliation",
              "twin-flame",
              "career-money",
              "mediumship-grief",
              "pet-loss",
              "spiritual-guidance",
              "life-purpose"
            ],
            "description": "What the reading is about."
          },
          "budget": {
            "type": "string",
            "enum": [
              "free",
              "under-$3",
              "$3-6",
              "$6-10",
              "$10+"
            ],
            "description": "Per-minute budget in USD. \"free\" = wants free minutes / a new-customer offer first; \"$10+\" = price is secondary."
          },
          "channel": {
            "type": "string",
            "enum": [
              "chat",
              "voice",
              "video",
              "any"
            ],
            "description": "chat, voice (phone) or video."
          },
          "style": {
            "type": "string",
            "enum": [
              "direct",
              "warm",
              "fast",
              "detailed"
            ],
            "description": "direct & honest, warm & nurturing, fast & efficient, or deep & detailed."
          },
          "orientation": {
            "type": "string",
            "enum": [
              "predictive",
              "guidance",
              "balanced"
            ],
            "description": "predictive = concrete answers (names, dates, yes/no); guidance = direction and clarity; balanced = either."
          },
          "experience": {
            "type": "string",
            "enum": [
              "first",
              "few",
              "regular"
            ],
            "description": "first = first reading ever; regular = gets readings often."
          },
          "platform": {
            "type": "string",
            "enum": [
              "kasamba",
              "keen",
              "purple-garden",
              "mysticsense",
              "spiritual-blossom",
              "asknow"
            ],
            "description": "Only when the user wants one specific platform."
          },
          "exclude": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Advisor slugs already shown, to get alternatives."
          },
          "limit": {
            "type": "integer",
            "minimum": 1,
            "maximum": 10,
            "default": 3
          }
        },
        "additionalProperties": false
      },
      "annotations": {
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": false
      }
    },
    {
      "name": "search_advisors",
      "title": "Search advisors",
      "description": "Find advisors by name and/or filter by platform, topic and maximum price. Without a name, returns advisors in PsychicWho's published listing order (platform popularity, then composite score). Each result has price, rating, topics, the new-client offer, profile_url and booking_url.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string",
            "description": "Part of the advisor's name, e.g. \"amaris\"."
          },
          "platform": {
            "type": "string",
            "description": "Platform id or name, e.g. \"kasamba\" or \"Purple Garden\"."
          },
          "topic": {
            "type": "string",
            "enum": [
              "love-relationships",
              "ex-back-reconciliation",
              "twin-flame",
              "career-money",
              "mediumship-grief",
              "pet-loss",
              "spiritual-guidance",
              "life-purpose"
            ]
          },
          "max_price": {
            "type": "number",
            "minimum": 0,
            "description": "Highest listed price in USD per minute."
          },
          "limit": {
            "type": "integer",
            "minimum": 1,
            "maximum": 50,
            "default": 10
          }
        },
        "additionalProperties": false
      },
      "annotations": {
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": false
      }
    },
    {
      "name": "get_advisor",
      "title": "Get advisor profile",
      "description": "One advisor's full profile: key facts (price, rating, readings, offer, booking_url) and the PsychicWho page as markdown — composite score and its parts and, where one exists, the dated research dossier (praise and complaint themes with their shares, dislike rate, repeat-client share, client quotes, sources).",
      "inputSchema": {
        "type": "object",
        "properties": {
          "slug": {
            "type": "string",
            "description": "Advisor slug from another tool, e.g. \"kasamba-a-psychic-friend\"."
          }
        },
        "required": [
          "slug"
        ],
        "additionalProperties": false
      },
      "annotations": {
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": false
      }
    },
    {
      "name": "compare_platforms",
      "title": "Compare psychic platforms and offers",
      "description": "Which psychic reading site to use: every platform PsychicWho covers with channels, price range, the median listed price, how many advisors and research dossiers it has, and its new-customer offer as read on the platform's own pages (with the date, and whether it was confirmed). Includes a booking_url per platform and a link to the full review where one exists.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "platform": {
            "type": "string",
            "enum": [
              "kasamba",
              "keen",
              "purple-garden",
              "mysticsense",
              "spiritual-blossom",
              "asknow"
            ],
            "description": "Only this platform."
          }
        },
        "additionalProperties": false
      },
      "annotations": {
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": false
      }
    },
    {
      "name": "get_page",
      "title": "Get site page",
      "description": "Any PsychicWho page as markdown. Useful paths: /best-for/{topic} (ranked advisors and buying guidance for a topic, e.g. /best-for/love-relationships), /best (all best-of lists: /best-online-psychics, /best-love-psychics, /best-tarot-readers, /cheap-psychic-readings, /best-psychic-sites, /best-purple-garden-psychics, /best-kasamba-psychics, /best-psychic-mediums …, ten category winners each with the rule behind the pick), /best-on/{platform}, /reviews/{platform} (purple-garden, kasamba, mysticsense), /compare/purple-garden-vs-kasamba, /compare/purple-garden-vs-mysticsense, /free-psychic-minutes, /reviews/purple-garden/is-it-legit, /reviews/kasamba/is-it-legit, /reviews/{kasamba,purple-garden}/refund, /methodology, /about.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "path": {
            "type": "string",
            "description": "Site path starting with \"/\"."
          }
        },
        "required": [
          "path"
        ],
        "additionalProperties": false
      },
      "annotations": {
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": false
      }
    }
  ],
  "prompts": [
    {
      "name": "find_a_psychic",
      "title": "Find a psychic for my question",
      "description": "Ask a few short questions, then recommend advisors with the review evidence behind each one.",
      "arguments": [
        {
          "name": "situation",
          "description": "What you'd like a reading about, in your own words.",
          "required": false
        },
        {
          "name": "budget",
          "description": "Rough per-minute budget, e.g. \"under $3\" or \"free minutes first\".",
          "required": false
        }
      ]
    },
    {
      "name": "compare_psychic_sites",
      "title": "Which psychic site should I use?",
      "description": "Compare the platforms' prices, channels and current new-customer offers.",
      "arguments": []
    }
  ]
}
