io.github.JCLVSH/xmark

up checked 2026-11-11T01:38:28.727Z

Unclaimed · Unverified

Publisher-provided title

xmark

Publisher-provided description

Search and chat with your X bookmarks, with citations back to the original posts.

Summary by lookupd

Search, chat with, and manage your saved X bookmarks, with answers that cite the original posts.

Install

Claude Code, remote (streamable-http)

claude mcp add --transport http xmark https://api.xmark.dev/mcp

Claude Code, npm package (stdio)

claude mcp add xmark -- npx -y @jclvsh/xmark

Codex, remote (streamable-http)

codex mcp add xmark --url https://api.xmark.dev/mcp

Codex, npm package (stdio)

codex mcp add xmark -- npx -y @jclvsh/xmark

Cursor, remote (streamable-http) → .cursor/mcp.json

{
  "mcpServers": {
    "xmark": {
      "url": "https://api.xmark.dev/mcp"
    }
  }
}

Cursor, npm package (stdio) → .cursor/mcp.json

{
  "mcpServers": {
    "xmark": {
      "command": "npx",
      "args": [
        "-y",
        "@jclvsh/xmark"
      ]
    }
  }
}

Other clients: docs. Or tell your agent: Set up lookupd for me: read https://lookupd.com/agent.md and follow it.

Publisher-provided text

list_bookmarks List the authenticated user's X bookmarks. Paginated.
get_bookmark Fetch a single bookmark by ID.
search_bookmarks Semantic search over the user's bookmarks. Returns ranked matches with relevance scores.
sync_bookmarks Trigger a fresh sync from X. Pulls latest bookmarks, embeds new ones for semantic search. Free tier allows one sync per day.
delete_bookmark Remove a bookmark. Local-only by default — the next sync re-creates anything still bookmarked on X. Set unbookmark=true to also remove it on X (sticks across sy
chat Ask a natural-language question about the user's X bookmarks. Returns an answer with citations back to the original tweets. Free tier includes 20 chat messages
list_conversations List the user's past chat conversations. Paginated.
get_conversation_messages A conversation's message history, oldest first. Assistant messages carry the IDs of the bookmarks retrieved for that answer.
delete_conversation Permanently delete a conversation and its messages. Free tier allows one concurrent conversation, so deleting is how a free account starts a fresh chat.
get_usage The authenticated user's plan and quota usage: chat messages this month, syncs today, bookmark count, and whether an X account is connected. Limits are null on
get_changelog machine-readable release history (public) - version, date, type, summary, migration notes on breaking entries. the X-Notice header's structured backstory.

Shows this live status and links here; updates hourly.

[![lookupd status](https://lookupd.com/badge/io.github.JCLVSH/xmark.svg)](https://lookupd.com/servers/io.github.JCLVSH/xmark)