S
spicyapi-ai/spicy-mcp
Official SpicyAPI MCP server: let Claude, Cursor and Codex generate images, videos, speech and music with 200+ models through an unrestricted AI API, with a USD quote before every paid step.
SECURITY.md ✓
View on GitHub ↗Link checked 2026-11-12 · HTTP 200 · opens the vendor's own site
checked 2026-11-14 — this package is not on npm/PyPI (E404); the command below fails as written.
Install & config
- Copy the command above
- Paste it as one entry under
mcpServersinclaude_desktop_config.json— local servers take command + args (example: clients) - Restart your client
Client config (built from the install command this repo gives)
{
"mcpServers": {
"spicyapi-ai-spicy-mcp": {
"command": "npx",
"args": ["--yes", "--package=@spicyapi/mcp", "spicyapi-mcp"]
}
}
}Parsed from the README we fetched on 2026-10-26; we have not executed it.
command/args come from the install command the repository states. When it is ambiguous, the project README wins.
VS Code (.vscode/mcp.json - the key is servers)
{
"servers": {
"spicyapi-ai-spicy-mcp": {
"command": "npx",
"args": ["--yes", "--package=@spicyapi/mcp", "spicyapi-mcp"]
}
}
}Same server, but VS Code keeps it under <code>servers</code>.
Claude Code (command line)
claude mcp add --transport stdio spicyapi-ai-spicy-mcp -- npx --yes --package=@spicyapi/mcp spicyapi-mcp
Claude Code does not read a config file; add the server with this command.
Key names differ by client: Clients & CLI
- Star count
- 1 ★ · spicyapi-ai/spicy-mcp · read from the GitHub search API · (checked 2026-11-13 20:00:50)
- Source
- collected from the punkpeye/awesome-mcp-servers list · type: MCP server
- Harvest history
- first seen 2026-10-23 · last seen 2026-11-14 · seen 26× · listed by 23 sources
- Score
- score 2,300 · 1 ★ · 23 sources · mcp
- Install
npx --yes --package=@spicyapi/mcp spicyapi-mcp
FAQ (answers come from our records)
How do I install it?
The repository provides this install command:
npx --yes --package=@spicyapi/mcp spicyapi-mcp. It comes from the repository itself; we cannot guarantee it runs as-is in your client.Who is it for?
We filed it under these tags: MCP 服务. The tags come from the entry itself, not a taxonomy we imposed.
Who maintains it?
repository
spicyapi-ai/spicy-mcp；first catalogued 2026-10-23；last seen 2026-11-14。There is no official certification or quality rating here — we record sources and dates only.# @spicyapi/mcp
以下摘录自该仓库的 README（片段） · 在 GitHub 读完整 README →
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 model catalog, compare prices, create generation tasks and collect results,
with every billable step confirmed by you.
SpicyAPI is an unrestricted AI API: one key for 200+ image, video, audio and chat models (Seedance,
Kling, Wan, MiniMax, Seedream, GPT Image, Suno and more), with no content filter added by the
platform. What a request can produce depends on the model you pick, and the catalog marks which
models are uncensored.
This package installs spicyapi-mcp (stdio) and spicyapi-mcp-http (loopback-only Streamable
HTTP). It does not contain the CLI or the Agent Skill.
Full, beginner-friendly guide: docs.spicyapi.ai/docs/mcp.
## What it does, in plain words
MCP (Model Context Protocol) is an open standard for giving AI assistants extra abilities. Once this
server is added to your assistant, you can ask in ordinary language — "make a five-second video
from this photo" — and the assistant:
1. finds a suitable model in the live catalog and reads what it accepts;
2. uploads your local file if there is one;
3. gets an exact USD quote and stops to ask you before anything is charged;
4. starts the task, waits for it and gives you the result link.
The server runs on your own computer. Your assistant app starts it when needed; there is nothing to
host.
## Requirements
Node.js 22.13 or later (node --version). npx ships with Node.js.
A SpicyAPI API key (below), and funds on the account for paid tasks. Browsing, quoting and
reading results are free.
An MCP client. Creating, retrying and purging tasks additionally require a client that
supports MCP form elicitation (the protocol's way of asking the user a question). In a client
without it those three tools return an error, usually containing
did not declare the required capability. Nothing is created, reserved, charged or destroyed:
creation has fetched only its free quote by then, and retry and purge have sent no request. The
read-only tools still work.
## Get a key first
1. Create an account at spicyapi.ai/register — if sign-ups are
paused, that page shows how to join the waitlist.
2. On the API keys page choose Create key. Name it after the
assistant that will use it. Under Advanced you can set a daily cap, monthly budget, lifetime
cap, allowed models, IP allowlist and expiry; new keys always get the platform's default daily
cap unless you enter 0 for no cap.
3. Copy the key. It starts with sk-spicy- and is shown once.
4. For the terminal-based setups below, export it in the terminal you will run the setup command
from:
bash
export SPICYAPIKEY="sk-spicy-..." # paste your own key
In Windows PowerShell: $env:SPICYAPIKEY = "sk-spicy-...".
## Add it to your client
Every client below runs the same stdio server: npx --yes --package=@spicyapi/mcp spicyapi-mcp.
You never run this server yourself — your MCP client starts it. Launched by hand it just waits
silently on stdin, which looks like a hang. And it needs --package=@spicyapi/mcp in front of the
binary name, because this package ships two of them; plain npx @spicyapi/mcp fails with
already use — Claude Desktop, Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI or any MCP
client — browse the live model catalog, compare prices, create generation tasks and collect results,
with every billable step confirmed by you.
SpicyAPI is an unrestricted AI API: one key for 200+ image, video, audio and chat models (Seedance,
Kling, Wan, MiniMax, Seedream, GPT Image, Suno and more), with no content filter added by the
platform. What a request can produce depends on the model you pick, and the catalog marks which
models are uncensored.
This package installs spicyapi-mcp (stdio) and spicyapi-mcp-http (loopback-only Streamable
HTTP). It does not contain the CLI or the Agent Skill.
Full, beginner-friendly guide: docs.spicyapi.ai/docs/mcp.
## What it does, in plain words
MCP (Model Context Protocol) is an open standard for giving AI assistants extra abilities. Once this
server is added to your assistant, you can ask in ordinary language — "make a five-second video
from this photo" — and the assistant:
1. finds a suitable model in the live catalog and reads what it accepts;
2. uploads your local file if there is one;
3. gets an exact USD quote and stops to ask you before anything is charged;
4. starts the task, waits for it and gives you the result link.
The server runs on your own computer. Your assistant app starts it when needed; there is nothing to
host.
## Requirements
Node.js 22.13 or later (node --version). npx ships with Node.js.
A SpicyAPI API key (below), and funds on the account for paid tasks. Browsing, quoting and
reading results are free.
An MCP client. Creating, retrying and purging tasks additionally require a client that
supports MCP form elicitation (the protocol's way of asking the user a question). In a client
without it those three tools return an error, usually containing
did not declare the required capability. Nothing is created, reserved, charged or destroyed:
creation has fetched only its free quote by then, and retry and purge have sent no request. The
read-only tools still work.
## Get a key first
1. Create an account at spicyapi.ai/register — if sign-ups are
paused, that page shows how to join the waitlist.
2. On the API keys page choose Create key. Name it after the
assistant that will use it. Under Advanced you can set a daily cap, monthly budget, lifetime
cap, allowed models, IP allowlist and expiry; new keys always get the platform's default daily
cap unless you enter 0 for no cap.
3. Copy the key. It starts with sk-spicy- and is shown once.
4. For the terminal-based setups below, export it in the terminal you will run the setup command
from:
bash
export SPICYAPIKEY="sk-spicy-..." # paste your own key
In Windows PowerShell: $env:SPICYAPIKEY = "sk-spicy-...".
## Add it to your client
Every client below runs the same stdio server: npx --yes --package=@spicyapi/mcp spicyapi-mcp.
You never run this server yourself — your MCP client starts it. Launched by hand it just waits
silently on stdin, which looks like a hang. And it needs --package=@spicyapi/mcp in front of the
binary name, because this package ships two of them; plain npx @spicyapi/mcp fails with
Listed badge (optional)
Copy this line into the README if you want the listing mark. Optional, and it does not affect being listed.
[](https://anclum.com/en/s/spicyapi-ai-spicy-mcp/)
- Source
- awesome · https://github.com/spicyapi-ai/spicy-mcp
- Browse by field
- MCP servers
- Traction
- 1 ★
- Listed by
- 23 independent sources
- added
- today
- Security policy
- the repository has
SECURITY.mdat its root (we checked that the file exists, not what it says)
More like this
Filed under
Every tag opens the full list for that filter. Counts are the live catalogue figures.