The official local MCP server for SpicyAPI. It lets the AI assistant you already use — Claude Desktop, Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI or any MCP client — browse the live…
spicy-mcp is an MCP project maintained in the spicyapi-ai/spicy-mcp repository. The maintainer describes its purpose as “The official local MCP server for SpicyAPI. It lets the AI assistant you already use — Claude Desktop, Claude Code, Codex, Cursor, VS Code, Windsurf…”. Read the project documentation for the complete scope.
The project provides a local client configuration using npx. Follow the repository’s build and installation steps before copying it, and replace example paths with the paths on your own computer.
The example declares SPICY_API_KEY. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.
Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.
Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.
| Tool | What it does |
|---|---|
| spicyapi_service_status | none |
| spicyapi_docs_search | query (default ""), limit (1–25, default 10) |
| spicyapi_models_list | modality (image / video / audio / text), provider, task, search, includeSchema, includeExamples (both default false) |
| spicyapi_model_get | model |
| spicyapi_balance_get | none |
| spicyapi_usage_get | from, to (YYYY-MM-DD, UTC) |
| spicyapi_tasks_list | from, to, state, model, limit (1–100, default 20), cursor |
| spicyapi_task_get | taskId |
| spicyapi_task_wait | taskId, timeoutSeconds (1–300, default 60), intervalSeconds (1–60, default adaptive) |
| spicyapi_task_quote | model, input, callBackUrl |
| spicyapi_upload_file | path (absolute; ~/, and ~\ on Windows, is expanded), contentType (only when the extension is missing or wrong) |
| spicyapi_download_url_create | taskId, key |
| spicyapi_task_create | model, input, callBackUrl, idempotencyKey, retentionSeconds |
| spicyapi_task_retry | taskId, idempotencyKey |
| spicyapi_task_purge | taskId |
{
"mcpServers": {
"spicyapi": {
"command": "npx",
"args": [
"--yes",
"--package=@spicyapi/mcp",
"spicyapi-mcp"
],
"env": {
"SPICY_API_KEY": "YOUR_SPICY_API_KEY"
}
}
}
}From the project documentation. Replace placeholders and example paths before connecting.
| Variable | Description | Required |
|---|---|---|
| SPICY_API_KEY | Declared in the maintainer’s client configuration. | Yes |
Retrieve public web pages as readable Markdown with the reference Fetch MCP server, including pagination for longer responses.
Retrieve version-aware library documentation and code examples with Context7 MCP, using resolve-library-id and query-docs.
Use the Supabase MCP server to inspect database schemas, query project data and retrieve docs through a project-scoped connection.
Stop letting your assistant hallucinate n8n node parameters — this server hands it the real schemas, templates and validation.
AWS Labs' official server suite — current AWS docs, CDK guidance, cost analysis and service tools.
Workers, KV, R2 and D1 by conversation — Cloudflare's official remote servers for building and observability.