Search, organize, and chat with your saved Twitter/X bookmarks from any AI agent. 10 tools: search, AI Q&A, collections, notes, highlights, and more.
Overview
@krillto/mcp-server
MCP server for krill.to — search and manage your Twitter/X bookmarks from any AI agent.
Works with Claude Desktop, Claude Code, Cursor, Windsurf, OpenClaw, and any MCP-compatible client.
Quick Start
1. Get your API key
Sign in to krill.to, go to Settings → API Key, and generate a key.
2. Configure your MCP client
Claude Desktop — add to claude_desktop_config.json:
{
"mcpServers": {
"krill": {
"command": "npx",
"args": ["-y", "@krillto/mcp-server"],
"env": {
"KRILL_API_KEY": "krill_your_key_here"
}
}
}
}
Cursor — add to .cursor/mcp.json:
{
"mcpServers": {
"krill": {
"command": "npx",
"args": ["-y", "@krillto/mcp-server"],
"env": {
"KRILL_API_KEY": "krill_your_key_here"
}
}
}
}
Claude Code — add to .claude/settings.json:
{
"mcpServers": {
"krill": {
"command": "npx",
"args": ["-y", "@krillto/mcp-server"],
"env": {
"KRILL_API_KEY": "krill_your_key_here"
}
}
}
}
That's it. Your AI agent can now search your bookmarks.
Tools
| Tool | Description |
|---|---|
search_bookmarks | Search by keyword, topic, or author (full-text + semantic) |
ask_bookmarks | Ask AI questions about your saved bookmarks |
list_collections | List all your collections |
get_collection_bookmarks | View bookmarks in a collection |
create_collection | Create a new collection |
add_to_collection | Add a bookmark to a collection |
update_bookmark | Update category or tags |
add_notes | Add personal notes to a bookmark |
get_highlights | View all your highlighted passages |
delete_bookmark | Delete a bookmark |
Examples
Ask your AI agent:
- "Search my bookmarks about React Server Components"
- "What have I saved about AI agents lately?"
- "Create a collection called 'Must Read' and add the latest 3 bookmarks"
- "Show me my highlights"
- "What did @karpathy tweet about that I saved?"
What is krill.to?
Krill.to saves your Twitter/X bookmarks, auto-categorizes them with AI, and makes them searchable. Think of it as a second brain for everything you bookmark on X.
- One-click save via Chrome extension
- AI-powered categorization and tagging
- Full-text and semantic search
- Thread unrolling and media capture
- AI chat — ask questions about your bookmarks
Development
git clone https://github.com/krillto/mcp-server.git
cd mcp-server
pnpm install
pnpm build
Test locally:
KRILL_API_KEY=krill_your_key node dist/index.js
Environment Variables
| Variable | Required | Description |
|---|---|---|
KRILL_API_KEY | Yes | Your krill.to API key (starts with krill_) |
KRILL_BASE_URL | No | Custom API URL (default: https://krill.to) |
License
MIT
Server Config
{
"mcpServers": {
"krill": {
"command": "npx",
"args": [
"-y",
"@krillto/mcp-server"
],
"env": {
"KRILL_API_KEY": "<YOUR_API_KEY>"
}
}
}
}