Sansfiction
About
Library management and book discovery
Details
- Author
- fgbytes
- Categories
- Productivity, Other, Knowledge Base, Search
Jump to
Setup
Install Sansfiction in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/fgbytes/sansfiction-mcp
Follow the installation instructions in the repository README, then restart your MCP client.
The same capabilities are exposed two ways, both authenticated with the same bearer token:
- MCP server(Streamable HTTP):https://sansfiction.com/api/mcp
- REST API(v1):https://sansfiction.com/api/v1
claude mcp add --transport http sansfiction https://sansfiction.com/api/mcp
Or point any MCP client at the streamable-HTTP endpoint above. Public catalog tools need no auth; personal library tools require a bearer token (generate one atsansfiction.com/docs/agents).
# Public catalog — no auth curl "https://sansfiction.com/api/v1/catalog/search?q=dune&limit=5" # Personal library — bearer token curl -H "Authorization: Bearer $SF_TOKEN" \ "https://sansfiction.com/api/v1/library/books?status=reading"
- GET /api/v1/catalog/search?q=…&searchType=all|author|series|mood|isbn
- GET /api/v1/catalog/books/{bookId}
- GET /api/v1/catalog/series/{seriesId}
- GET /api/v1/catalog/collections
- GET/POST /api/v1/library/books·PATCH/DELETE /api/v1/library/books/{bookId}
- GET /api/v1/library/search
- GET /api/v1/library/collections·GET /api/v1/library/collections/{id}·POST …/items
- GET /api/v1/library/stats
- Agent Skill:SKILL.md— also served athttps://sansfiction.com/.well-known/agent-skills/sansfiction-catalog/SKILL.md
- MCP Registry manifest:server.json
- OpenAPI:https://sansfiction.com/openapi.json
- MCP server card:https://sansfiction.com/.well-known/mcp/server-card.json
Generate a personal access token (sf_mcp_…) while signed in atsansfiction.com/docs/agents. The same token authenticates both the MCP server and the REST API. Rate limits: 60 req/min anonymous, 180 req/min authenticated.
The SansFiction service is proprietary. This repository documents its public agent interface for discovery and integration.
This repo also ships a small stdio MCP server that proxies to the hosted REST API, so you can run it anywhere an MCP client expects a local command:
npx sansfiction-mcp # or npm install && node index.js
- SANSFICTION_TOKEN— bearer token (sf_mcp_…) for the personal-library tools (generate athttps://sansfiction.com/docs/agents). Public catalog tools need none.
- SANSFICTION_BASE_URL— override the API base (defaulthttps://sansfiction.com).
Tools:search_books,get_book,get_series,list_public_collections,list_my_books,add_book_to_library,update_library_book,remove_book_from_library,search_my_library,list_my_collections,get_reading_stats.
- Build steps:["npm install"]
- CMD arguments:["mcp-proxy","--","node","index.js"]
tools/listrequires no network or credentials, so the introspection check passes without a token.
MCP server for Apple Notes with semantic search and CRUD operations. Claude searches, reads, creates, updates, and manages your Apple Notes through natural language.
An MCP server for document ingestion, chunking, semantic search, and note management.
A server for the Scrapbox/CoSense platform to retrieve, list, search, and create pages.
Give AI assistants secure access to your organization's structured business data. Search records, create and update records, retrieve schema information, and manage workflow states using natural language.
JobYap aggregates job postings directly from companies' official careers sites and gives every posting a public discussion thread, with salaries, locations and full descriptions.
Japanese government procurement bid search and AI analysis via MCP
Official Notion MCP server for searching, reading, creating, and updating Notion pages, databases, and workspace content from AI agents.
Prompt Buddy MCP exposes a public, searchable catalog of reusable AI skills.
AI job search & hiring MCP server with 55 tools. Search jobs, apply, interview, negotiate offers across 20 countries. No account needed to start.
Interact with Amazon services for product search, cart management, and viewing order history.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
