# Glasp — how to use (mcp.ai)

Connect your Glasp account and use 9 tools for bookmarks straight from your AI agent. Connect with your own API key. Glasp helps users save bookmarks, capture and organize highlights, import Kindle highlights, and access AI-generated summaries.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_glasp?ms=1787295780000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `glasp_create_highlights`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/glasp`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/glasp/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/glasp/create/highlights` — Create between 1 and 100 highlights in the connected Glasp account in one request.
  - body: { highlights: object[] }
- `POST https://api.mcp.ai/api/glasp/delete/highlights` — Delete one Glasp highlight, or explicitly delete all highlights associated with one source document.
  - body: { url: string, highlight_id?: string, delete_document?: boolean }
- `POST https://api.mcp.ai/api/glasp/get/summary` — Fetch one Glasp summary by ID, optionally including the stored page or PDF Markdown content when available.
  - body: { summary_id: string, include_content?: boolean }
- `POST https://api.mcp.ai/api/glasp/list/bookmarks` — Return one page of pages the connected user saved to Glasp without highlighting, optionally limited to bookmarks updated after a timestamp.
  - body: { next_cursor?: string, updated_after?: string }
- `POST https://api.mcp.ai/api/glasp/list/highlights` — Return one page of the connected user's non-Kindle Glasp documents and their nested highlights, optionally limited to records updated after a timestamp.
  - body: { next_cursor?: string, updated_after?: string }
- `POST https://api.mcp.ai/api/glasp/list/kindle/highlights` — Return one page of the connected user's read-only Kindle books and highlights imported into Glasp, optionally limited to records updated after a timestamp.
  - body: { next_cursor?: string, updated_after?: string }
- `POST https://api.mcp.ai/api/glasp/list/summaries` — Return one page of AI summaries generated by the connected user for pages, PDFs, and YouTube videos, optionally limited to records updated after a timestamp.
  - body: { next_cursor?: string, updated_after?: string }
- `POST https://api.mcp.ai/api/glasp/save/bookmark` — Save a URL as a Glasp bookmark, or update the existing bookmark when that URL is already saved.
  - body: { url: string, title?: string, category?: string, description?: string, thumbnail_url?: string }
- `POST https://api.mcp.ai/api/glasp/update/highlight` — Update editable fields on one Glasp highlight identified by its source URL and highlight ID.
  - body: { url: string, note?: string, text?: string, color?: string, location?: number, highlight_id: string, highlight_url?: string }

## Example prompts
- "What can I do in Glasp?"
- "Show me a summary of my Glasp account"

## More
- Page: https://mcp.ai/glasp
- Agent spec (llms.txt): https://mcp.ai/glasp/llms.txt
- Postman collection: https://mcp.ai/glasp/postman.json