SJinn MCP

SJinn MCP

SJinn MCP lets an AI client call SJinn tools from a conversation. Use it when you want the assistant to create image, video, or audio tasks, prepare input assets, check your account, or retrieve task results without leaving the chat.

SJinn currently recommends MCP with Claude. For Claude Code and Codex, use SJinn Skills.

---

Connect SJinn in Seconds

Claude MCP Setup Demo

Watch the Claude MCP connection flow:

1. Go to Claude > Customize

In Claude desktop or claude.ai, open Customize > Connectors.

2. Add a custom connector

Name it SJinn and paste this remote MCP server URL:

https://mcp.sjinn.ai/mcp

3. Connect and sign in

Click Add > Connect, then sign in with your SJinn account. After the connector is enabled in a conversation, ask Claude to create an image, create a video, create audio, or check a previous task.

---

Current Capabilities

More MCP tools can be added over time. This page describes the currently documented SJinn MCP surface.

---

Discover a Model Before Creating

Image, video, and audio creation now require an explicit model ID. Calls that omit it are rejected rather than falling back to a default model. Other generation parameters keep their existing behavior.

1. If the user's model name or alias is not yet a confirmed catalog ID, call models_search with the intended output type and a concise query. If several versions remain plausible, clarify rather than automatically picking the first result.
2. Use models_list with a required type to browse all models in that category. Lists and search results contain summaries, not complete parameters, and are not silently truncated. The is_default flag identifies the default selection for a type, not a fallback for missing creation arguments.
3. Before creating, obtain the selected model's complete models_get result. Reuse it when its full applicable details are already available in the current context. Search summaries, skills, remembered parameters, or a note that a lookup previously occurred are not substitutes. If a lookup fails, do not create from guessed parameters.
4. Follow those parameter and asset rules, then call the matching creation tool with the exact model explicitly. Unsupported values are rejected, not automatically replaced. The lookup prerequisite guides the assistant; the server independently validates creation arguments and does not require a lookup receipt.

For example, resolve a video model name:

{"type":"video","query":"Kling"}

Pass the confirmed ID to models_get:

{"model":"kling3"}

Then call create_video_task with valid parameters from that result:

{"model":"kling3","prompt":"A slow camera move through a neon-lit street.","duration":5,"aspect_ratio":"16:9","resolution":"720p"}

You can also search combined requirements in your own language, for example:

{"type":"video","query":"支持 4K、参考图片和 8 秒时长的视频模型"}

Search compares the complete details of every model in that type, including its supported operations, parameter values, and conditional rules. Results contain catalog summaries plus match_reason and conditions; an empty models array means no match was found, while a tool error means the search failed. Search is AI-assisted, so confirm the selected model's full details before creation rather than treating its explanation as a parameter specification.

Model discovery uses the same authenticated MCP connection, but does not require membership, spend SJinn credits, or start generation. It works in both interactive and text-only clients. Semantic queries are processed by a server-side AI provider: do not include credentials, private media URLs, account information, or unrelated conversation text. Lists, details, and queries consisting only of an exact ID do not call the AI provider. If search is temporarily unavailable, wait rather than repeatedly retrying.

Supported Generation Models

Image Models

Both GPT Image 2.5 variants use these parameters with create_image_task:

Omit reference images for text-to-image generation. With references, describe what to preserve and change. Use aspect_ratio, not the underlying API's image_size. Neither variant accepts mode, quality, seed, n, provider, or unlimited.

{
  "model": "gpt-image-2.5-flare",
  "prompt": "Create a minimalist coffee advertisement with warm morning light.",
  "aspect_ratio": "16:9",
  "resolution": "2K"
}

To use Sunburst, change only model to gpt-image-2.5-sunburst.

Video Models

For Seedance 2.5, select the operation before creating: new generation, editing existing content, or appending a continuation. If the provider identifies the request as editing or extension, obtain the corresponding model's complete details and adjust the call. Omitting duration or aspect ratio from seedance2.5 still applies generation defaults; it does not select edit mode. seedance2.5-edit accepts exactly one source video, preserves its duration and ratio, and does not accept additional video references. Do not silently discard a required reference video to fit it. Output durations for generation and extension must be integers from 4 to 30 seconds.

Audio Models

For seed-audio-1-0, provide a prompt. You may also provide either audio_urls with up to 3 reference audio URLs, cited as @Audio1, @Audio2, and @Audio3, or image_urls with one reference image URL. Do not provide both audio_urls and image_urls in the same audio task.

If no model preference is given, the assistant may use the catalog's default selection when it supports the requested operation. It must still obtain or reuse that model's complete details and pass its exact ID explicitly when creating.

---

Example Prompts

Create an image:

Use SJinn to create a square product image of a glass perfume bottle on black marble.

Create a video:

Use SJinn to create a 16:9 video of a slow camera move through a neon studio.

Create audio:

Use SJinn to create a short upbeat jingle for a product launch.

Check a task:

Check this SJinn task and show me the output URL: <task_id>

---

Troubleshooting

The connector does not add

Confirm the URL is exactly:

https://mcp.sjinn.ai/mcp

Do not add extra paths, query parameters, or a trailing slash unless SJinn documentation explicitly changes the URL.

Sign-in does not complete

Remove the connector and add it again, then click Connect and complete the SJinn sign-in flow in the browser.

A task cannot be created

Check that your SJinn account is signed in and has enough credits. You can ask the assistant to run the account check before creating a task.

Media input fails

Use stable public HTTPS media URLs when possible. If your file is only on your local computer, ask the assistant to use upload_asset; supported clients open an SJinn upload panel, while text-only clients return upload commands and asset URLs.

A task is still running

Ask the assistant to check the task again later with the task ID. Video generation can take longer than image generation.