xmark

io.github.JCLVSH/xmarkVersion 0.7.3

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

Status

Responds254 msNov 14, 2026, 14:38 UTCAnswered our handshake without sign-in.

Registry data may be out of date

We could not refresh it, so this page shows the last copy.

Last checked: Nov 14, 2026, 14:38 UTC
Latency: 254 ms
Remotes responding: 1 of 1
Sign-in: API key
Hosting: Hosted outside the EU (detected)
Registry data as of: Nov 14, 2026, 21:12 UTC

Data from the official MCP Registry, checked by run.zero. How we check

Connect

Streamable HTTP

https://api.xmark.dev/mcpResponds254 msNov 14, 2026, 14:38 UTC

No sign-in

Claude Code

claude mcp add --transport http xmark https://api.xmark.dev/mcp --header 'Authorization: Bearer <YOUR_TOKEN>'

Replace <YOUR_TOKEN> before running.

Claude Desktop and claude.ai

Settings > Connectors > Add custom connector
Name: xmark
Remote MCP server URL: https://api.xmark.dev/mcp
This server expects the header Authorization.

Cursor

{
  "mcpServers": {
    "xmark": {
      "url": "https://api.xmark.dev/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

Replace <YOUR_TOKEN> before running.

VS Code

code --add-mcp '{"name":"xmark","type":"http","url":"https://api.xmark.dev/mcp","headers":{"Authorization":"Bearer <YOUR_TOKEN>"}}'

Replace <YOUR_TOKEN> before running.

Streamable HTTP

npm: @jclvsh/xmark 0.7.3

Package only

npm (npx)

claude mcp add xmark -e 'XMARK_API_KEY=<YOUR_XMARK_API_KEY>' -- npx -y @jclvsh/xmark@0.7.3

Replace <YOUR_XMARK_API_KEY> before running.

Built your own server? run.zero hosts MCP servers on European infrastructure.

Host your own MCP server on run.zero

Tools

11 tools

Tools of xmark
	Description		Read-only	Idempotent	Open world
`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 per month.	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 per month.	No	No	Not declared	Not declared
`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 syncs; requires a connected X account).	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 syncs; requires a connected X account).	Yes	No	Not declared	Not declared
`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.	Permanently delete a conversation and its messages. Free tier allows one concurrent conversation, so deleting is how a free account starts a fresh chat.	Yes	No	Not declared	Not declared
`get_bookmark`Fetch a single bookmark by ID.	Fetch a single bookmark by ID.	No	Yes	Not declared	Not declared
`get_changelog`machine-readable release history (public) - version, date, type, summary, migration notes on breaking entries. the X-Notice header's structured backstory.	machine-readable release history (public) - version, date, type, summary, migration notes on breaking entries. the X-Notice header's structured backstory.	No	Yes	Not declared	Not declared
`get_conversation_messages`A conversation's message history, oldest first. Assistant messages carry the IDs of the bookmarks retrieved for that answer.	A conversation's message history, oldest first. Assistant messages carry the IDs of the bookmarks retrieved for that answer.	No	Yes	Not declared	Not declared
`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 unlimited plans.	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 unlimited plans.	No	Yes	Not declared	Not declared
`list_bookmarks`List the authenticated user's X bookmarks. Paginated.	List the authenticated user's X bookmarks. Paginated.	No	Yes	Not declared	Not declared
`list_conversations`List the user's past chat conversations. Paginated.	List the user's past chat conversations. Paginated.	No	Yes	Not declared	Not declared
`search_bookmarks`Semantic search over the user's bookmarks. Returns ranked matches with relevance scores.	Semantic search over the user's bookmarks. Returns ranked matches with relevance scores.	No	Yes	Not declared	Not declared
`sync_bookmarks`Trigger a fresh sync from X. Pulls latest bookmarks, embeds new ones for semantic search. Free tier allows one sync per day.	Trigger a fresh sync from X. Pulls latest bookmarks, embeds new ones for semantic search. Free tier allows one sync per day.	No	No	Not declared	Not declared

Details

Registry status: Active
Published: Nov 13, 2026
Updated: Nov 13, 2026
Website: https://www.xmark.dev/⁠ (opens in a new tab)
Repository: Not given
Categories (suggested): CommunicationSuggested categories are assigned automatically from the registry text and may be wrong. Verified operators can correct them.
GDPR: Not declared

Are you the operator? Claim this listing