xmark is an MCP server published by io.github.JCLVSH, hosted at api.xmark.dev. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 11 tools, including list_bookmarks, get_bookmark, search_bookmarks, sync_bookmarks, delete_bookmark.
Search and chat with your X bookmarks, with citations back to the original posts.
645 connections through 4 shared values. Tap any node.
Inferred from the host name and headers: what a server runs on, not who runs it.
List the authenticated user's X bookmarks. Paginated.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number (1-indexed) |
| pageSize | integer | Items per page (max 100) |
{
"name": "list_bookmarks",
"description": "List the authenticated user's X bookmarks. Paginated.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"page": {
"type": "integer",
"default": 1,
"minimum": 1,
"description": "Page number (1-indexed)"
},
"pageSize": {
"type": "integer",
"default": 50,
"maximum": 100,
"minimum": 1,
"description": "Items per page (max 100)"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"destructiveHint": false
}
}None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Fetch a single bookmark by ID.
| Parameter | Type | Description |
|---|---|---|
| id * | string | Bookmark UUID |
{
"name": "get_bookmark",
"description": "Fetch a single bookmark by ID.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "Bookmark UUID"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"destructiveHint": false
}
}Semantic search over the user's bookmarks. Returns ranked matches with relevance scores.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Max results to return |
| query * | string | Natural-language search query |
{
"name": "search_bookmarks",
"description": "Semantic search over the user's bookmarks. Returns ranked matches with relevance scores.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"query"
],
"properties": {
"limit": {
"type": "integer",
"default": 10,
"maximum": 50,
"minimum": 1,
"description": "Max results to return"
},
"query": {
"type": "string",
"minLength": 1,
"description": "Natural-language search query"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"destructiveHint": false
}
}Trigger a fresh sync from X. Pulls latest bookmarks, embeds new ones for semantic search. Free tier allows one sync per day.
No parameters.
{
"name": "sync_bookmarks",
"description": "Trigger a fresh sync from X. Pulls latest bookmarks, embeds new ones for semantic search. Free tier allows one sync per day.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
},
"annotations": {
"readOnlyHint": false,
"destructiveHint": false
}
}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).
| Parameter | Type | Description |
|---|---|---|
| id * | string | Bookmark UUID |
| unbookmark | boolean | Also remove the bookmark on X, not just locally |
{
"name": "delete_bookmark",
"description": "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).",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "Bookmark UUID"
},
"unbookmark": {
"type": "boolean",
"default": false,
"description": "Also remove the bookmark on X, not just locally"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"destructiveHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| question * | string | The question to ask |
| maxCitations | integer | Maximum citations to include in the answer |
| conversationId | string | Continue an existing conversation by ID |
{
"name": "chat",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"question"
],
"properties": {
"question": {
"type": "string",
"minLength": 1,
"description": "The question to ask"
},
"maxCitations": {
"type": "integer",
"default": 5,
"maximum": 20,
"minimum": 1,
"description": "Maximum citations to include in the answer"
},
"conversationId": {
"type": "string",
"format": "uuid",
"description": "Continue an existing conversation by ID"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"destructiveHint": false
}
}List the user's past chat conversations. Paginated.
| Parameter | Type | Description |
|---|---|---|
| page | integer | |
| pageSize | integer |
{
"name": "list_conversations",
"description": "List the user's past chat conversations. Paginated.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"page": {
"type": "integer",
"default": 1,
"minimum": 1
},
"pageSize": {
"type": "integer",
"default": 50,
"maximum": 100,
"minimum": 1
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"destructiveHint": false
}
}A conversation's message history, oldest first. Assistant messages carry the IDs of the bookmarks retrieved for that answer.
| Parameter | Type | Description |
|---|---|---|
| conversationId * | string | Conversation UUID |
{
"name": "get_conversation_messages",
"description": "A conversation's message history, oldest first. Assistant messages carry the IDs of the bookmarks retrieved for that answer.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"conversationId"
],
"properties": {
"conversationId": {
"type": "string",
"format": "uuid",
"description": "Conversation UUID"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"destructiveHint": false
}
}Permanently delete a conversation and its messages. Free tier allows one concurrent conversation, so deleting is how a free account starts a fresh chat.
| Parameter | Type | Description |
|---|---|---|
| conversationId * | string | Conversation UUID |
{
"name": "delete_conversation",
"description": "Permanently delete a conversation and its messages. Free tier allows one concurrent conversation, so deleting is how a free account starts a fresh chat.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"conversationId"
],
"properties": {
"conversationId": {
"type": "string",
"format": "uuid",
"description": "Conversation UUID"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"destructiveHint": true
}
}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 parameters.
{
"name": "get_usage",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
},
"annotations": {
"readOnlyHint": true,
"destructiveHint": false
}
}machine-readable release history (public) - version, date, type, summary, migration notes on breaking entries. the X-Notice header's structured backstory.
No parameters.
{
"name": "get_changelog",
"description": "machine-readable release history (public) - version, date, type, summary, migration notes on breaking entries. the X-Notice header's structured backstory.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
},
"annotations": {
"readOnlyHint": true,
"destructiveHint": false
}
}Names, descriptions and schemas were written by the server and are shown as data.
Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators.