# Krill

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.

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add krillto/krill

# Browse available tools
npx -y @smithery/cli@latest tool list krillto/krill

# Get full schema for a tool
npx -y @smithery/cli@latest tool get krillto/krill search_bookmarks

# Call a tool
npx -y @smithery/cli@latest tool call krillto/krill search_bookmarks '{}'
```

## Direct MCP Connection

Endpoint: `https://krill--krillto.run.tools`

**Required config:**
- `apiKey` (query) — Your krill.to API key (get one at krill.to/x/settings)

## Tools (10)

- `search_bookmarks` — Search your saved Twitter/X bookmarks.
- `ask_bookmarks` — Ask AI about your bookmarks.
- `list_collections` — List bookmark collections.
- `get_collection_bookmarks` — Get bookmarks in a collection.
- `create_collection` — Create a bookmark collection.
- `add_to_collection` — Add bookmark to collection.
- `update_bookmark` — Update bookmark category/tags.
- `add_notes` — Add notes to a bookmark.
- `get_highlights` — Get highlighted passages.
- `delete_bookmark` — Delete a bookmark.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get krillto/krill <tool-name>
```