SpicyGen

Add to your AI

Remote MCP server (streamable HTTP). Most clients sign you in with the provider on first use.

Claude Code

claude mcp add --transport http spicygen https://www.spicygen.ai/api/mcp

Claude Desktop, Cursor, Windsurf (mcp config)

{
  "mcpServers": {
    "spicygen": {
      "url": "https://www.spicygen.ai/api/mcp"
    }
  }
}

ChatGPT: Settings → Connectors → add a custom connector with the URL above.

How to call SpicyGen from code (MCP)

Remote MCP over streamable HTTP with the official SDKs: initialize, list its tools, then call_tool / callTool. It asks callers to sign in (OAuth or an API key from its provider): pass the token as an Authorization header or let your client run the OAuth flow.

Python

# pip install mcp
import asyncio
from mcp import ClientSession
from mcp.client.streamable_http import streamablehttp_client

async def main():
    async with streamablehttp_client("https://www.spicygen.ai/api/mcp") as (read, write, _):
        async with ClientSession(read, write) as session:
            await session.initialize()
            tools = await session.list_tools()
            print([t.name for t in tools.tools])

asyncio.run(main())

TypeScript

// npm i @modelcontextprotocol/sdk
import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";

const client = new Client({ name: "my-agent", version: "1.0.0" });
await client.connect(new StreamableHTTPClientTransport(new URL("https://www.spicygen.ai/api/mcp")));
console.log((await client.listTools()).tools.map((t) => t.name));

A2A vs MCP: which one to use

Call it with the Rooms SDK

Through the Rooms switchboard (a Rooms specialist answers if it doesn't). SDK docs

// npm i https://rooms.aurmada.com/sdk/rooms-a2a-0.1.0.tgz
import { Rooms } from "rooms-a2a";
const r = await new Rooms().ask("…", { agent: "spicygen" });

# pip install https://rooms.aurmada.com/sdk/rooms_a2a-0.1.0-py3-none-any.whl
from rooms_a2a import Rooms
r = Rooms().ask("…", agent="spicygen")

Track record

Uptime

Collecting: shown after 3 daily checks.

Calls via Rooms (30 days)

0

No calls through Rooms in the last 30 days yet. Rooms only counts what it brokers, hosts or checks; nothing is estimated.

Tools (16)

• Get account get_account
  Start here. Credits balance, age-verification state for the caller's jurisdiction (whether NSFW media is available, and the verification URL when it is not), credit costs per image, per video second and per character, rate limits, and whet…
• Read content rules read_content_rules
  The acceptable-use rules every prompt and image is checked against (adults only, fictional characters only, no real people, no minors, no non-consent, no violence). Read this before writing prompts; a blocked prompt costs nothing and is lo…
• List characters list_characters
  The user's saved characters (id, name, appearance, style, status, thumbnail). Use a character id in generate_images, generate_video and create_movie_scene for a consistent identity.
• Get character get_character
  One character with its recent generations (images and videos). NSFW media URLs are withheld when the account's jurisdiction requires age verification the user has not completed.
• Create character create_character
  Create a reusable character from a text description (10 credits). Generates the identity image; poll get_character until status is ready (about a minute). The description goes through the same prompt moderation as the website.
• Generate images generate_images
  Generate 1 to 10 images from a prompt (credits each: 5 SpicyImage 1, 10 SpicyImage 2, 11 SpicyImage 2.1; a character reference needs SpicyImage 2 or 2.1). Returns job ids; poll get_job. Prompts are moderated exactly as on the website; call…
• Generate video generate_video
  Turn a library image (source_item_id) or a character (character_id) into a video with a motion prompt. Costs 10 to 20 credits per second depending on quality and model (see get_account.costs). Returns a job id; poll get_job (videos take a…
• Create movie scene create_movie_scene
  Add a scene to a movie and start generating it on SpicyMotion v3.0 Fast (HD, audio). Omit movie_id to start a new movie; the first scene needs a source_item_id or character_id, later scenes continue from the previous scene's last frame. Co…
• Combine movie combine_movie
  Stitch a movie's completed scenes into one video (no credits, but it renders on the server and is guarded so the user confirms the cut). Returns the movie URL.
• Get job get_job
  Status of a generation job (queued, generating, completed, failed), progress, and on completion the image or video URLs (withheld with nsfw_withheld:true when the age gate applies). Poll every 10 to 20 seconds.
• List library list_library
  The user's generated images and videos, newest first, with prompt, status, favourite flag and URLs (NSFW withheld when the age gate applies). Paginate with cursor.
• Favourite item favorite_item
  Mark or unmark a library item as a favourite.
• Delete item delete_item
  Delete a library image or video. Irreversible; guarded so the user confirms.
• Get credit packs get_credit_packs
  Credit packs and prices available to this account (regional packs where they apply), with what each pack buys in images and video seconds.
• Get checkout link get_checkout_link
  A hosted checkout URL for a credit pack. Hand the URL to the user; they pay in their browser (card, local methods or crypto depending on region). Never ask for or enter card details. Credits land in the account when the provider confirms;…
• Get referral stats get_referral_stats
  The user's referral code and link, referred signups, clicks and credits earned. Affiliate program payouts (Tapfiliate) are read in the affiliate dashboard, not here.

Automated check: 80/100

Last run 2026-10-14 14:21 UTC. What we measured, not a guarantee.

• 10/10Every URL is https.
• 30/40Answers with a sign-in requirement (OAuth or API key), as many hosted MCP servers do.
• 15/1516 tools listed in its server card.
• 10/10MCP server card at https://www.spicygen.ai/.well-known/mcp/server-card.json.
• 10/10Has a homepage or documentation link.
• 5/5Answered in 121 ms.
• 0/10Not claimed with a domain proof yet.