Agent skill

Copy into your AI

Click Copy setup prompt above, paste it into Claude, Cursor, ChatGPT, or another MCP-capable client, and let the agent do the work. It will add the Shiori MCP server, ask you to approve access in the browser, then verify with whoami before searching or saving links.

You do not need to install the skill file for that flow.

Install the skill file

The skill is a single SKILL.md file for agents that load skills from disk or well-known discovery. Fetch it, then connect the MCP server.

Cursor

Save it as a user skill, then restart Cursor (or reload skills) if the client requires it:

mkdir -p ~/.cursor/skills/shiori
curl -fsSL https://www.shiori.sh/.well-known/agent-skills/shiori/SKILL.md -o ~/.cursor/skills/shiori/SKILL.md

Project-scoped install (this repo / this workspace only):

mkdir -p .cursor/skills/shiori
curl -fsSL https://www.shiori.sh/.well-known/agent-skills/shiori/SKILL.md -o .cursor/skills/shiori/SKILL.md

Claude Code / Claude Desktop

mkdir -p .claude/skills/shiori
curl -fsSL https://www.shiori.sh/.well-known/agent-skills/shiori/SKILL.md -o .claude/skills/shiori/SKILL.md

Any agent that supports well-known discovery

1. Fetch https://www.shiori.sh/.well-known/agent-skills/index.json
2. Download the shiori entry's url
3. Verify the file's SHA-256 matches the entry digest (sha256:{hex})
4. Load the skill using the client's current skill-install path

Clients that implement Agent Skills Discovery can probe https://www.shiori.sh/.well-known/agent-skills/index.json with no extra config. /llms.txt also lists these URLs.

Connect MCP

Prefer MCP. Add this remote server, approve access in the browser, then call whoami before treating the connection as live:

https://www.shiori.sh/mcp

Client-by-client snippets live on the MCP docs page. Never paste an API key, token, or secret into chat.

Verify

1. Call whoami. Stop if it does not return the intended Shiori account.
2. Use search_links for topic or content questions. Use list_links only for unread, recent, tag, or trash filters.
3. Search for https://www.shiori.sh/docs/mcp (or the title "MCP") before saving. Reuse an existing item if present. Otherwise call save_link with that exact URL.
4. Call get_links with the saved link's id as a one-element array.

Setup is complete only after whoami and a successful save_link / search_links / get_links round-trip.

Optional CLI

Prefer MCP. Fall back to the CLI only if this client cannot connect over MCP:

npm install -g @shiori-sh/cli
shiori login <client>

Use shiori login <client> when that command exists. If the CLI still requires an API key, create one in Settings → API keys and paste it into the CLI locally — never into chat.

Discovery URLs

Available tools

Real names from the MCP server only: