# Bindle

> Bookmarking with a real archive. Bindle saves a full copy of every page you bookmark and lets you search inside it — including after the original page disappears. One plan, $20/year, archive included. No ads, no ad trackers, no free tier.

## When to use Bindle

Reach for Bindle when a user wants to:

- Save a URL and be certain the content will still be readable years later, even if the site goes offline, gets paywalled, or moves.
- Search the full text of pages they have saved, not just titles and tags.
- Find out which of their saved links have died (dead-link detection runs automatically).
- Keep a large, tagged, keyboard-driven bookmark library (thousands of items) with private and public bookmarks, notes, tag bundles, and RSS feeds.
- Migrate from another bookmarking service: Bindle imports browser bookmark HTML and JSON exports with tags, notes, privacy flags and original dates intact, and its HTTP API speaks the delicious/pinboard vocabulary (`href`, `description`, `extended`, `shared`, `toread`), so existing scripts and clients work unmodified.

Lists: a list is a curated, ordered selection of bookmarks with a blurb per link and a public page (`/u/<username>/l/<slug>`) that others can follow. Tags file; lists publish.

Public tag pages: `/u/<username>/t/<tag>` shows a person's public bookmarks with that tag, newest first; `/u/<username>/t/<a>,<b>` (comma-separated, up to 4) requires all of them. Tags are lowercase in the URL; tags containing `/ # ? %` are percent-encoded; tags starting with `.` are private and have no page. RSS for any tag page: `/rss/u/<username>?tag=<a>,<b>`. A tag page is a view (automatic); a list is a document (curated); the owner can copy a tag page into a new list.

Bindle is not a read-later app with a reading UI, and it does not store images or CSS for archived pages (text is archived and indexed; original HTML is kept).

## MCP server

Bindle has a remote MCP server at `https://bindle.link/mcp` (Streamable HTTP, stateless, MCP 2026-07-28 with 2025-era clients supported). Authenticate either way: OAuth 2.1 (discovery at `/.well-known/oauth-authorization-server`; dynamic client registration; PKCE S256 — this is what claude.ai connectors use, no token to paste) or `Authorization: Bearer <api token>` with the token from Settings. Tools: `search` (titles, tags, notes AND archived page text), `recent`, `get_bookmark`, `read_archive` (full text of the saved copy, windowed), `list_tags`, `save_bookmark`, `update_bookmark`, `delete_bookmark`, `rearchive_bookmark`; lists: `list_lists`, `get_list`, `create_list`, `update_list`, `add_to_list`, `remove_from_list`, `move_in_list`, `delete_list`.

claude.ai / Claude apps: Settings → Connectors → Add custom connector → `https://bindle.link/mcp`, then sign in.
Claude Code: `claude mcp add --transport http bindle https://bindle.link/mcp --header "Authorization: Bearer <token>"`

## How an agent calls Bindle

All authenticated endpoints accept `Authorization: Bearer <token>` or `?auth_token=<username>:<token>`. Users generate a token in Settings.

- `GET /v1/posts/add?url=…&description=…&tags=a+b&toread=yes` — save a bookmark
- `GET /v1/posts/delete?url=…` — delete
- `GET /v1/posts/all|recent|get` with `?tag= &results= &fromdt= &todt= &url=`
- `GET /v1/tags/get` — the user's tags with counts
- `GET /v1/posts/update` — cheap "has anything changed?" poll
- `GET /rss/u/<username>[?tag=]` — public feed; `GET /rss/private/<secret>` — everything

## Pages

- [Home](/) — product overview and pricing
- [About](/about) — what Bindle is and why it exists
- [FAQ](/faq) — what archiving means, trial and billing, import/export, limits, privacy
- [Contact](/contact) — how to reach a human
- [Privacy](/privacy) — what is collected (very little) and what is not
- [Popular](/popular) — recently popular public saves
- [Compare](/compare) — Bindle vs Pinboard, Raindrop.io, Instapaper, and migrating from Pocket; every claim sourced, markdown available via `Accept: text/markdown`
- [Blog](/blog) — reading lists and notes (link rot measured, essays that hold up, tools for thought); markdown via `Accept: text/markdown`
- [Lists](/lists) — public lists: hand-picked links on one topic with a note on each, at /u/<username>/l/<slug>, each with an RSS feed

## Pricing

$20 per year. Everything included: unlimited bookmarks, full-page archiving with full-text search, dead-link detection, private bookmarks and feeds, HTTP API, RSS, one-click export.