x-reader MCP Server: Setup for Claude, Cursor and Other Apps

• Reads one link and returns its content as structured JSON

  Fetches one link, picks the right reader for the site (X, YouTube, a podcast, a web page and so on) and returns the title, text and source details as JSON. It also saves the result to an inbox file on your machine, and may call helper programs such as yt-dlp for video.

  Try: “Read this X thread and tell me what the original post says: https://x.com/example/status/123”

  Runs code · read_url

• Reads several links at once and returns a list of results

  Does the same as the single-link tool for a list of links in parallel. Use it when you have a reading list to go through. Results are saved to the same local inbox file.

  Try: “Read these five article links and summarize each in two lines.”

  Runs code · read_batch

• Shows everything x-reader has already fetched

  Returns the items stored in the local inbox file from earlier reads, so the assistant can reuse them without fetching again.

  Try: “What links have you already read for me?”

  Files · list_inbox

• Says which site reader a link would use

  Tells you which handler x-reader would pick for a link, for example Twitter, YouTube or a generic web page, without fetching the page.

  Try: “Which platform does this link belong to: https://youtu.be/abc123?”

  Read · detect_platform

Watch out for

• It saves what it reads to a local inbox file

  Each read adds the result to unified_inbox.json, in the folder the server starts in. Delete that file if the pages were private. github.com

• Some links pass through a third-party reader

  The code sends some X and web addresses to Jina Reader (r.jina.ai) to get their text. Do not give it links you want to keep off third-party services. github.com

• The suggested launch command tracks the main branch

  The README's uvx command installs straight from GitHub with no version pinned, so each launch can run newer code. Pin a tag such as v0.5.0 if you want fixed code. github.com

• Audio can go to Groq when a key is set

  With GROQ_API_KEY set, video audio can be sent to the Groq transcription API. Leave the key unset to avoid that. github.com

• SSE mode stays on localhost by default

  The optional SSE mode binds to 127.0.0.1 and refuses 0.0.0.0 unless you pass the allow-external flag. github.com

Security advisories