mcp-sparkit
Officialsparkit-mcp
Servidor MCP para SPARKIT — llama al agente de investigación científica desde Claude Desktop, Cursor, Claude Code o cualquier otro cliente compatible con MCP.
Se exponen dos herramientas:
research— envía una pregunta científica. SPARKIT busca en la literatura, lee los artículos relevantes y devuelve un informe en Markdown con citas. Se bloquea hasta que finaliza el trabajo (4 minutos por defecto) y devuelve el informe completo en línea.get_job_status— recupera un trabajo enviado previamente mediante su ID. Útil cuandoresearchdevuelve un resultado antes de que el trabajo haya finalizado, o para revisar un informe anterior.
Instalación
uv tool install sparkit-mcpO con pip:
pip install sparkit-mcpCualquiera de las dos opciones instala un script de consola sparkit-mcp. (Pre-lanzamiento: instalar directamente desde GitHub con
uv tool install "git+https://github.com/SPARKIT-science/sparkit-mcp.git"
hasta que llegue el primer lanzamiento en PyPI).
Related MCP server: scholar-memory
Obtener una clave API
Regístrate en https://app.sparkit.science/signup (la opción "Try-it" cuesta 10 $ por 5 consultas; las suscripciones comienzan en 50 $/mes).
Visita https://app.sparkit.science/keys y crea una clave.
Copia la clave: solo se muestra una vez.
Configurar tu cliente MCP
Claude Desktop
Edita claude_desktop_config.json:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
Añade:
{
"mcpServers": {
"sparkit": {
"command": "sparkit-mcp",
"env": {
"SPARKIT_API_KEY": "sk_sparkit_..."
}
}
}
}Reinicia Claude Desktop. Deberías ver aparecer sparkit en el icono de herramientas junto a la entrada de chat.
Si sparkit-mcp no está en el PATH de Claude Desktop (común con uv tool), utiliza la ruta absoluta:
"command": "/Users/you/.local/bin/sparkit-mcp"(Encuentra la ruta con which sparkit-mcp después de uv tool install.)
Cursor
Edita ~/.cursor/mcp.json (o .cursor/mcp.json en tu proyecto):
{
"mcpServers": {
"sparkit": {
"command": "sparkit-mcp",
"env": {
"SPARKIT_API_KEY": "sk_sparkit_..."
}
}
}
}Recarga Cursor (Cmd+Shift+P → "Reload Window").
Claude Code
claude mcp add sparkit -e SPARKIT_API_KEY=sk_sparkit_... -- sparkit-mcpPruébalo
Una vez configurado, pregúntale al LLM:
Usa SPARKIT para buscar la literatura más reciente sobre el papel de WRNIP1 como objetivo sintético-letal en el cáncer.
El LLM llamará a research. Espera entre 60 y 180 segundos, y luego obtendrás un informe en Markdown con citas en línea y una lista numerada de fuentes.
Configuración
Variable de entorno | Por defecto | Descripción |
| (requerido) | Clave Bearer de https://app.sparkit.science/keys. |
|
| Sustituye la URL base de la API. Útil para despliegues de prueba o autohospedados. |
|
| Tiempo de espera por solicitud HTTP. No afecta al tiempo de espera total de |
Referencia de herramientas
research(question, response_format?, include_citations?, max_wait_seconds?)
Argumento | Tipo | Por defecto | Descripción |
| string | — | La pregunta científica. Requerido. Sé específico. |
|
|
| Longitud del informe en Markdown devuelto. |
| boolean |
| Mantener |
| int (30-540) |
| Cuánto tiempo bloquear la espera antes de devolver el job_id con instrucciones para consultar el estado. |
Devuelve Markdown. En caso de tiempo de espera agotado, devuelve una línea de estado con el job_id para que el LLM pueda llamar a get_job_status más tarde.
get_job_status(job_id)
Devuelve el informe en Markdown con citas si el trabajo se ha completado, una línea de estado si todavía se está ejecutando, o un mensaje de error en caso contrario.
Solución de problemas
Error de autenticación — SPARKIT_API_KEY no está configurado o no es válido. Comprueba si hay errores tipográficos en claude_desktop_config.json; reinicia Claude Desktop después de realizar cambios.
Cuota agotada — se han acabado las consultas mensuales / créditos de "Try-it". Visita https://app.sparkit.science/billing.
La herramienta no aparece en Claude Desktop — comprueba el registro de Claude Desktop:
macOS:
~/Library/Logs/Claude/mcp-server-sparkit.logWindows:
%LOCALAPPDATA%\Claude\Logs\mcp-server-sparkit.log
El problema más común es que command: sparkit-mcp no esté en el PATH; sustitúyelo por la ruta absoluta obtenida con which sparkit-mcp.
El trabajo agota el tiempo de espera — el límite de max_wait_seconds es de 540s (9 min). Para preguntas muy profundas, envía el trabajo y luego consulta get_job_status en lugar de esperar en línea. SPARKIT también cancelará automáticamente los trabajos que superen su propio límite interno.
Licencia
MIT.
Available Tools
2 toolsget_job_statusA
Fetch the current status (and result if done) of a SPARKIT job.
Use this when research returned before the job finished, or to
revisit a previous result by id.
Args:
job_id: The id returned by a prior research call.
Returns the cited Markdown report if the job has completed, a status line if it's still running, or a failure message otherwise.
Inputs: job_id (required). Returns: result
researchA
Submit a scientific question to the SPARKIT research agent.
SPARKIT searches the literature, reads relevant papers, and returns a cited Markdown report. Best for questions where a correct answer requires synthesizing across multiple primary sources.
Args:
question: Free-text scientific question. Be specific —
"Which kinases are upregulated in pancreatic cancer with
evidence from human tissue?" works better than "tell me
about pancreatic cancer."
response_format: "full" (default) for a multi-paragraph
Markdown report, or "brief" for a tighter summary.
include_citations: Keep True (default) so the report is
usable for downstream work; only set False if you
specifically want unsourced prose.
max_wait_seconds: How long to block waiting for the job before
returning the job_id with instructions to poll via
get_job_status. Default 240s (4 min). Range 30-540.
Returns the cited Markdown report on success. If the job is still
running at the wait limit, returns the job_id and status so the
caller can resume with get_job_status.
Inputs: question (required), response_format, include_citations, max_wait_seconds. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 2 tools
The two tools have clearly distinct purposes: 'research' submits a scientific question and returns either a report or a job ID, while 'get_job_status' retrieves the status or result of a previously submitted job. There is no overlap in functionality.
Both tool names use snake_case, but 'research' is a single-word noun while 'get_job_status' follows a verb_noun pattern. This minor inconsistency prevents a perfect score.
With only two tools, the server covers the essential workflow of submitting a research job and checking its status. While minimal, the count is appropriate for the narrow scope of a scientific research agent.
The tool set covers the primary use case (submit and retrieve results), but lacks features like job listing, cancellation, or retry. For a simple agent this may suffice, but there are notable gaps in lifecycle management.
Maintenance
Related MCP Connectors
Open scientific and engineering knowledge for AI agents: search, evidence, document publishing.
Research papers for AI agents: PubMed, arXiv, Crossref; citations, references, open access texts
Academic papers, reference verification and research data for AI agents.
Search peer-reviewed papers and research methodology guidance from your AI agent.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceTurn any AI agent into an academic researcher that can search, read, cite, and write full literature reviews autonomously.14MIT
- AlicenseNot gradedqualityDmaintenanceEnables scientific literature research through multi-agent search, analysis, and semantic memory, exposing 9 MCP tools for querying, storing, and retrieving research findings.15 PyPI2MIT
- FlicenseNot gradedqualityCmaintenanceEnables AI agents to search and retrieve academic papers from arXiv and PubMed with citation-grade extraction, providing clean citations and summaries.-
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to run reproducible, high-recall literature search across seven source families with RRF fusion, fetch open-access full texts (falling back to abstracts), expand citations, export BibTeX/RIS, and audit reference coverage — all without any LLM API key, leaving query planning and writing to the agent. Multiple agent clients share one accumulating literature pool and background search jobs that keep running after sessions close.3MIT