@jclvsh/xmark

MCP server and CLI for the xmark API — chat with your X (Twitter) bookmarks from inside Claude Code, Cursor, or any MCP-compatible client.

What is xmark?

xmark syncs your X bookmarks, embeds them with OpenAI, and lets you query them in natural language with citations back to the original tweets. This package wraps the xmark REST API as an MCP server (for AI clients) and a CLI (for terminal use).

Install

# Run the MCP server (stdio transport)
npx -y -p @jclvsh/xmark xmark-mcp

# Or use the CLI directly
npx -y -p @jclvsh/xmark xmark --help

Setup

Set your xmark API key (get one at /settings/api):

export XMARK_API_KEY=nt_live_...

Optionally override the API host (default is https://api.xmark.dev):

export XMARK_API_URL=https://api.xmark.dev

Tools exposed via MCP

| Tool | What it does | |---|---| | search_bookmarks | Semantic search over the user's bookmarks. | | chat | Ask a natural-language question with citations. | | sync_bookmarks | Pull the latest bookmarks from X. | | list_bookmarks | Paginated bookmark list. | | get_bookmark | Fetch a single bookmark by ID. | | delete_bookmark | Remove a bookmark (local-only, or also on X with unbookmark). | | list_conversations | Past chat conversations. | | get_conversation_messages | A conversation's message history. | | delete_conversation | Permanently delete a conversation. | | get_usage | Plan + quota usage (chat this month, syncs today, bookmark count). |

CLI commands

xmark search "what did I save about Claude?"
xmark chat "summarize what I saved this month about agents"
xmark sync
xmark list --page 1 --page-size 20
xmark get <bookmark-id>
xmark delete <bookmark-id> --unbookmark
xmark conversations
xmark messages <conversation-id>
xmark delete-conversation <conversation-id>
xmark usage

Pricing

Free tier: 20 chat messages/month, 1 sync/day. Pro is $5/month — unlimited chat and sync. The same plan covers the web app, CLI, MCP server, and developer REST API — no separate API tier.

Links

• Homepage: https://xmark.dev
• API reference: https://xmark.dev/docs
• OpenAPI spec: https://api.xmark.dev/openapi.json
• llms.txt: https://api.xmark.dev/llms.txt

License

MIT