SansFiction MCP y Agent Skill

Conecta agentes de IA a SansFiction — una biblioteca digital para libros, colecciones, diarios de lectura y descubrimiento.

Las mismas capacidades se exponen de dos maneras, ambas autenticadas con el mismo token de portador:

• Servidor MCP (HTTP Streamable): https://sansfiction.com/api/mcp

• API REST (v1): https://sansfiction.com/api/v1

Inicio rápido (MCP)

claude mcp add --transport http sansfiction https://sansfiction.com/api/mcp

O apunta cualquier cliente MCP al endpoint HTTP streamable anterior. Las herramientas del catálogo público no requieren autenticación; las herramientas de la biblioteca personal requieren un token de portador (genera uno en sansfiction.com/docs/agents).

Related MCP server: Calibre RAG MCP Server

Inicio rápido (REST)

# 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"

Capacidades

Catálogo público (sin autenticación)

• 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

Biblioteca personal (token de portador)

• 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

Descubrimiento

• Agent Skill: SKILL.md — también disponible en https://sansfiction.com/.well-known/agent-skills/sansfiction-catalog/SKILL.md

• Manifiesto del registro MCP: server.json

• OpenAPI: https://sansfiction.com/openapi.json

• Tarjeta del servidor MCP: https://sansfiction.com/.well-known/mcp/server-card.json

Autenticación

Genera un token de acceso personal (sf_mcp_…) mientras estás conectado en sansfiction.com/docs/agents. El mismo token autentica tanto el servidor MCP como la API REST. Límites de tasa: 60 solicitudes/min anónimo, 180 solicitudes/min autenticado.

Licencia

El servicio SansFiction es propietario. Este repositorio documenta su interfaz de agente público para descubrimiento e integración.

Ejecutar localmente como servidor MCP (stdio)

Este repositorio también incluye un pequeño servidor MCP stdio que funciona como proxy hacia la API REST alojada, para que puedas ejecutarlo en cualquier lugar donde un cliente MCP espere un comando local:

npx sansfiction-mcp
# or
npm install && node index.js

Variables de entorno:

• SANSFICTION_TOKEN — token de portador (sf_mcp_…) para las herramientas de la biblioteca personal (genera en https://sansfiction.com/docs/agents). Las herramientas del catálogo público no necesitan ninguno.

• SANSFICTION_BASE_URL — anula la base de la API (por defecto https://sansfiction.com).

Herramientas: 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.

Configuración de compilación de Glama

• Pasos de compilación: ["npm install"]

• Argumentos CMD: ["mcp-proxy","--","node","index.js"]

tools/list no requiere red ni credenciales, por lo que la verificación de introspección se realiza sin un token.