Build with krill.to
Connect your AI agents to your Twitter/X bookmark library. Search, organize, and chat with your saved tweets from any platform.
Up and running in 2 minutes
Get your API key
Sign in and generate a key at Settings → API Key.
Install the MCP server
npm install -g @krillto/mcp-server
Configure your client
Add to your Claude Desktop config:
{
"mcpServers": {
"krill": {
"command": "krill-mcp",
"env": {
"KRILL_API_KEY": "krill_your_key_here"
}
}
}
}Two ways to connect
MCP Server
10 toolsWorks with Claude Desktop, Claude Code, Cursor, Windsurf, and any MCP-compatible client.
npm install -g @krillto/mcp-server
Available tools
OpenClaw Plugin
9 tools + skillAccess your bookmarks from WhatsApp, Telegram, Discord, and 30+ messaging platforms.
openclaw plugins install @krillto/openclaw-plugin
Includes a built-in skill that teaches agents how to use krill — no extra prompting needed.
Find us everywhere
Krill - Twitter/X Bookmarks is listed on major MCP directories and package registries.
Smithery
Install and connect via Smithery's MCP registry. One-click setup for Claude, Cursor, and more.
smithery.ai →mcp.so
Browse on the largest MCP server directory. Discover tools and read reviews.
mcp.so →npm
Install @krillto/mcp-server and @krillto/openclaw-plugin from the npm registry.
npmjs.com →GitHub
View the source, report issues, and contribute on GitHub. MIT licensed.
github.com →REST API
All endpoints accept Bearer token authentication with your API key.
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/x/bookmarks | Search & list bookmarks |
| GET | /api/x/bookmarks?q=react | Full-text + semantic search |
| PATCH | /api/x/bookmarks/:id | Update category/tags |
| DELETE | /api/x/bookmarks/:id | Delete a bookmark |
| PATCH | /api/x/bookmarks/:id/notes | Add/update notes |
| GET | /api/x/collections | List collections |
| POST | /api/x/collections | Create collection |
| GET | /api/x/collections/:id/bookmarks | Collection contents |
| POST | /api/x/collections/:id/bookmarks | Add to collection |
| GET | /api/x/categories | List categories |
| GET | /api/x/highlights | Get highlights |
| POST | /api/x/chat | AI chat (SSE stream) |
Example request
curl -H "Authorization: Bearer krill_your_key" \ https://krill.to/api/x/bookmarks?q=react
What you can build
Personal Knowledge Assistant
Ask your AI ‘What did I save about React Server Components?’ and get answers sourced from your bookmarks.
Cross-Platform Access
Message your AI on WhatsApp: ‘Search my bookmarks for startup ideas’ — powered by OpenClaw + krill.
Smart Organization
Let your AI auto-organize bookmarks into collections, add notes, and tag content as you save.
Frequently asked questions
- What is the krill.to API? +
- The krill.to API lets you programmatically access your saved Twitter/X bookmarks. You can search, organize, tag, and chat with your bookmarks using a REST API or through AI-native integrations like MCP and OpenClaw.
- How do I get an API key? +
- Sign in to krill.to, go to Settings, and generate an API key. The key starts with krill_ and can be used as a Bearer token for all API requests.
- What is MCP and how does it work with krill.to? +
- MCP (Model Context Protocol) is a standard that lets AI assistants like Claude access external tools. The krill.to MCP server gives Claude, Cursor, Windsurf, and other MCP-compatible clients direct access to your bookmark library — search, organize, and chat with your saved tweets.
- Which AI clients are supported? +
- The MCP server works with Claude Desktop, Claude Code, Cursor, Windsurf, and any MCP-compatible client. The OpenClaw plugin extends access to WhatsApp, Telegram, Discord, and 30+ messaging platforms.
- Is there a rate limit on the API? +
- The API is rate-limited per API key. Free accounts get 100 requests per minute. If you need higher limits, reach out to us.
- Can I use the API to build my own app? +
- Yes. The REST API supports all CRUD operations on bookmarks, collections, categories, highlights, and notes. You can also use the AI chat endpoint for semantic search and conversational access to your bookmarks.