sansfiction-catalog

SansFiction

SansFiction is a digital library for books, collections, reading journals, and discovery. This skill drives its public REST API (/api/v1). An MCP server exposing the same capabilities is also available at /api/mcp for MCP-native clients — both accept the same bearer token.

Base URL: https://sansfiction.com

Authentication

Public catalog endpoints need no auth. Personal library endpoints require a bearer token:

Authorization: Bearer sf_mcp_xxxxxxxxxxxxxxxxxxxxxxxx

A signed-in user generates a token at https://sansfiction.com/docs/agents. Never ask the user for a password — only a token. On 401, ask for a fresh one.

Public catalog (no auth)

• GET /api/v1/catalog/search?q={query}&limit=20&searchType=all|author|series|mood|isbn
• GET /api/v1/catalog/books/{bookId}
• GET /api/v1/catalog/series/{seriesId}
• GET /api/v1/catalog/collections?limit=20

curl "https://sansfiction.com/api/v1/catalog/search?q=dune&limit=5"

Personal library (bearer token required)

• GET /api/v1/library/books?status=reading|want|read|dnf|all&limit=20
• POST /api/v1/library/books — body { "book_id", "status?", "edition_id?" }
• PATCH /api/v1/library/books/{bookId} — body { "status?","rating?","review?","started_at?","finished_at?","current_page?" }
• DELETE /api/v1/library/books/{bookId}
• GET /api/v1/library/search?q={query}&status=all&limit=10
• GET /api/v1/library/collections?limit=20&query=
• GET /api/v1/library/collections/{collectionId}?limit=&offset=&rank=true
• POST /api/v1/library/collections/{collectionId}/items — body { "book_id","note?","edition_id?" }
• GET /api/v1/library/stats?scope=weekly|monthly|yearly&include_logs=false