xmark
Search and chat with your X bookmarks, with citations back to the original posts.
Sollte ich dies verwenden
Qualität und Sicherheit
Befunde (1)
- LOWin chat
Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.
Kontextkosten
Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.
Installieren
Installation mit einem Klick
Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:
{
"mcpServers": {
"xmark": {
"url": "https://api.xmark.dev/mcp"
}
}
}Remote-Endpunkte
https://api.xmark.dev/mcpstreamable-httpWas es kann
Tool-Inventar
Tools (11)
🟢list_bookmarks(page, pageSize)
List the authenticated user's X bookmarks. Paginated.
Eingabe-Schema
{
"type": "object",
"properties": {
"page": {
"type": "integer",
"minimum": 1,
"default": 1,
"description": "Page number (1-indexed)"
},
"pageSize": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"default": 50,
"description": "Items per page (max 100)"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_bookmark(id)
Fetch a single bookmark by ID.
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "Bookmark UUID"
}
},
"required": [
"id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢search_bookmarks(query, limit)
Semantic search over the user's bookmarks. Returns ranked matches with relevance scores.
Eingabe-Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 1,
"description": "Natural-language search query"
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 50,
"default": 10,
"description": "Max results to return"
}
},
"required": [
"query"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪sync_bookmarks
Trigger a fresh sync from X. Pulls latest bookmarks, embeds new ones for semantic search. Free tier allows one sync per day.
Eingabe-Schema
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}🔴delete_bookmark(id, unbookmark)
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).
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "Bookmark UUID"
},
"unbookmark": {
"type": "boolean",
"default": false,
"description": "Also remove the bookmark on X, not just locally"
}
},
"required": [
"id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪chat(question, conversationId, maxCitations)
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.
Eingabe-Schema
{
"type": "object",
"properties": {
"question": {
"type": "string",
"minLength": 1,
"description": "The question to ask"
},
"conversationId": {
"type": "string",
"format": "uuid",
"description": "Continue an existing conversation by ID"
},
"maxCitations": {
"type": "integer",
"minimum": 1,
"maximum": 20,
"default": 5,
"description": "Maximum citations to include in the answer"
}
},
"required": [
"question"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢list_conversations(page, pageSize)
List the user's past chat conversations. Paginated.
Eingabe-Schema
{
"type": "object",
"properties": {
"page": {
"type": "integer",
"minimum": 1,
"default": 1
},
"pageSize": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"default": 50
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_conversation_messages(conversationId)
A conversation's message history, oldest first. Assistant messages carry the IDs of the bookmarks retrieved for that answer.
Eingabe-Schema
{
"type": "object",
"properties": {
"conversationId": {
"type": "string",
"format": "uuid",
"description": "Conversation UUID"
}
},
"required": [
"conversationId"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🔴delete_conversation(conversationId)
Permanently delete a conversation and its messages. Free tier allows one concurrent conversation, so deleting is how a free account starts a fresh chat.
Eingabe-Schema
{
"type": "object",
"properties": {
"conversationId": {
"type": "string",
"format": "uuid",
"description": "Conversation UUID"
}
},
"required": [
"conversationId"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢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.
Eingabe-Schema
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_changelog
machine-readable release history (public) - version, date, type, summary, migration notes on breaking entries. the X-Notice header's structured backstory.
Eingabe-Schema
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}Community
Nachweis