Krillto Mcp Server

@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

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: krillto
• Source: krillto/mcp-server
• License: MIT

Install and usage instructions live in the source repository linked above.