MCP tools reference

The Sensefold MCP server lives at https://api.sensefold.app/mcp. Connections authorize over OAuth (paste-and-authorize) or with a revocable Agent key, and carry one of three permission tiers. Write tools appear only when the connection’s tier allows them.

Tier	Can
read_only	Search and read the library
edit	Also save links and notes, update notes and tags
full	Also delete items (to the recycle bin — the user can restore)

Tools

Tool	What it does	Tier
search_hub	Semantic + keyword search across the whole library. Prefer this for topic or meaning-based questions.	all
list_items	List recent items with optional filters.	all
get_item	Read one saved item by UUID — full content as Markdown-friendly text.	all
get_quota	Inspect the user’s plan, credits, and limits.	all
save_link	Save an HTTP(S) URL; it runs the normal capture + enrichment pipeline.	edit+
save_note	Save a plain-text or Markdown note.	edit+
update_note	Replace an item’s user-authored text. Revision-backed and undoable.	edit+
update_tags	Replace an item’s full tag list. Revision-backed and undoable.	edit+
delete_item	Move an item to the recycle bin; the user can restore it.	full

ChatGPT connectors additionally use the search and fetch aliases, which map onto the same search and read capabilities.

Connection self-check: your client’s tool list reflects the key’s tier — 6 tools for read-only (the four read tools plus the search/fetch aliases), 10 for edit, 11 for full.

Reliability contract

• For save_link and save_note, generate one UUID before the first attempt and reuse it on every retry — a new UUID creates a new item.
• update_note, update_tags, and delete_item require expectedVersion from a fresh get_item read. On a VERSION_CONFLICT error, re-read the item and retry once with the new version.
• Every write is versioned in Sensefold: the user can review, diff, and revert any agent edit from the item’s history. Write access never means giving up control.

An agent-readable setup guide lives at /for-agents/skill.md.