# Linkhut — how to use (mcp.ai)

LinkHut manages bookmarked links in a minimalistic, shareable interface, helping teams organize URLs and track references in one place

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_linkhut?ms=1781542140000`
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. `linkhut_add_bookmark`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/linkhut`
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/linkhut/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/linkhut/add/bookmark` — Adds a new bookmark to linkhut. the bookmark can be marked as private/public and read/unread, with optional tags and notes.
  - body: { url: string, tags?: string, shared?: boolean, toread?: boolean, extended?: string, description: string }
- `POST https://api.mcp.ai/api/linkhut/delete/bookmark` — This tool allows users to delete a bookmark from their linkhut account by providing the bookmark url. it operates independently and only requires the url parameter to identify and remove the bookmark.
  - body: { url: string }
- `POST https://api.mcp.ai/api/linkhut/get/all/tags` — Retrieves a list of all tags and their usage counts for the authenticated user. no additional parameters required besides authentication.
- `POST https://api.mcp.ai/api/linkhut/get/bookmarks` — This tool retrieves all bookmarks from the user's linkhut account. it makes a get request to the api endpoint and handles authentication. the tool returns a list of bookmarks including details such as
  - body: { tag?: string }
- `POST https://api.mcp.ai/api/linkhut/update/bookmark` — This tool allows users to update an existing bookmark in linkhut. the tool updates the metadata of a bookmark including its title, description, and tags.
  - body: { url: string, tags?: string, shared?: boolean, toread?: boolean, extended?: string, description?: string }

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