@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