# Krillto Mcp Server

> MCP server for krill.to — search your Twitter/X bookmarks from any AI agent

- **Type:** MCP server
- **Install:** `agentstack add mcp-krillto-mcp-server`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [krillto](https://agentstack.voostack.com/s/krillto)
- **Installs:** 0
- **Category:** [Search](https://agentstack.voostack.com/c/search)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [krillto](https://github.com/krillto)
- **Source:** https://github.com/krillto/mcp-server

## Install

```sh
agentstack add mcp-krillto-mcp-server
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# @krillto/mcp-server

MCP server for [krill.to](https://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](https://krill.to), go to **Settings → API Key**, and generate a key.

### 2. Configure your MCP client

**Claude Desktop** — add to `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "krill": {
      "command": "npx",
      "args": ["-y", "@krillto/mcp-server"],
      "env": {
        "KRILL_API_KEY": "krill_your_key_here"
      }
    }
  }
}
```

**Cursor** — add to `.cursor/mcp.json`:

```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`:

```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](https://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

```bash
git clone https://github.com/krillto/mcp-server.git
cd mcp-server
pnpm install
pnpm build
```

Test locally:

```bash
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](https://github.com/krillto)
- **Source:** [krillto/mcp-server](https://github.com/krillto/mcp-server)
- **License:** MIT

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

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-krillto-mcp-server
- Seller: https://agentstack.voostack.com/s/krillto
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.