sparkit-mcp

# sparkit-mcp MCP server for [SPARKIT](https://sparkit.science) — call the scientific research agent from Claude Desktop, Cursor, Claude Code, or any other MCP-compatible client. Two tools are exposed: - **`research`** — submit a scientific question. SPARKIT searches the literature, reads the relevant papers, and returns a cited Markdown report. Blocks until the job finishes (default 4 min) and returns the full report inline. - **`get_job_status`** — fetch a previously-submitted job by id. Useful when `research` returned before the job finished, or to revisit a past report. ## Install ```bash uv tool install sparkit-mcp ``` Or with pip: ```bash pip install sparkit-mcp ``` Either installs a `sparkit-mcp` console script. (Pre-release: install straight from GitHub with ``uv tool install "git+https://github.com/SPARKIT-science/sparkit-mcp.git"`` until the first PyPI release lands.) ## Get an API key 1. Sign up at https://app.sparkit.science/signup (Try-it costs $10 for 5 queries; subscriptions start at $50/mo). 2. Visit https://app.sparkit.science/keys and create a key. 3. Copy the key — it's shown only once. ## Configure your MCP client ### Claude Desktop Edit `claude_desktop_config.json`: - macOS: `~/Library/Application Support/Claude/claude_desktop_config.json` - Windows: `%APPDATA%\Claude\claude_desktop_config.json` Add: ```json { "mcpServers": { "sparkit": { "command": "sparkit-mcp", "env": { "SPARKIT_API_KEY": "sk_sparkit_..." } } } } ``` Restart Claude Desktop. You should see `sparkit` appear in the tools icon next to the chat input. If `sparkit-mcp` isn't on Claude Desktop's PATH (common with `uv tool`), use the absolute path: ```json "command": "/Users/you/.local/bin/sparkit-mcp" ``` (Find the path with `which sparkit-mcp` after `uv tool install`.) ### Cursor Edit `~/.cursor/mcp.json` (or `.cursor/mcp.json` in your project): ```json { "mcpServers": { "sparkit": { "command": "…