Search and chat with your X bookmarks, with citations back to the original posts.
Connect Remote server
claude mcp add --transport http xmark https://api.xmark.dev/mcp --header "Authorization: Bearer <YOUR_API_KEY>"
{
"mcpServers": {
"xmark": {
"url": "https://api.xmark.dev/mcp",
"headers": {
"Authorization": "Bearer <YOUR_API_KEY>"
}
}
}
}
{
"servers": {
"xmark": {
"type": "http",
"url": "https://api.xmark.dev/mcp",
"headers": {
"Authorization": "Bearer <YOUR_API_KEY>"
}
}
}
}
Settings > Connectors > Add custom connector
URL: https://api.xmark.dev/mcp
Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.
Tools 11 found in our last check
list_bookmarksList the authenticated user's X bookmarks. Paginated.
get_bookmarkFetch a single bookmark by ID.
search_bookmarksSemantic search over the user's bookmarks. Returns ranked matches with relevance scores.
sync_bookmarksTrigger a fresh sync from X. Pulls latest bookmarks, embeds new ones for semantic search. Free tier allows one sync per day.
delete_bookmarkRemove 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).
chatAsk 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.
list_conversationsList the user's past chat conversations. Paginated.
get_conversation_messagesA conversation's message history, oldest first. Assistant messages carry the IDs of the bookmarks retrieved for that answer.
delete_conversationPermanently delete a conversation and its messages. Free tier allows one concurrent conversation, so deleting is how a free account starts a fresh chat.
get_usageThe 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.
get_changelogmachine-readable release history (public) - version, date, type, summary, migration notes on breaking entries. the X-Notice header's structured backstory.
Headers
| Name | Description |
|---|---|
AuthorizationRequired, secret | xmark API key, sent as a Bearer token. Its scopes apply. |
Details
| Endpoint | https://api.xmark.dev/mcp (Streamable HTTP) |
| Package | @jclvsh/[email protected] (NPM, stdio) |
| First published | 12 Nov 2026 |
| Last updated | 12 Nov 2026 |
| Registry name | io.github.JCLVSH/xmark |
More communication servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.
