# Sogni MCP

> Sogni MCP is a freemium MCP server for design and media. Hosted MCP server for generating images, video and audio with a Sogni account. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, Web
- **Website:** https://docs.sogni.ai/agents/mcp/
- **MCP Registry name:** io.github.Sogni-AI/sogni-mcp
- **Categories:** design and media
- **Listing updated:** 2026-11-15

## About

Connecting takes a developer API key from your Sogni account, sent as a Bearer token to a hosted Streamable HTTP endpoint. OAuth sign-in is not supported on this connection. The key can carry its own spending limits, model access and expiry, and for IP-restricted keys the docs say to allow the gateway's fixed outbound address rather than your own.

The workflow is built around cost control. An agent lists models, reads the account balance, then asks for a quote before generating anything. A quote is an estimate and not a reservation, and an unavailable estimate is not the same as free. Jobs keep running if the client disconnects, so the agent saves the job ID and reads it later with get_job. When a job needs cost approval, the preview goes to the user and approve_cost confirms or declines it. Retries should reuse the same request ID, since a new ID can start and charge for another job.

Billing can follow the account's Unlimited subscription or tokens, with premium models still charged normally. Hosted MCP generation runs on the Fast network. Reference images and media go through signed uploads from create_upload.

## Features

- **Quote before you spend:** The quote tool estimates image, video, audio or transform calls without starting them.
- **Image, video and audio:** Separate tools generate images, video, and music or speech.
- **Media transforms:** Upscaling and background removal are handled by transform_media.
- **Durable jobs:** Jobs continue after disconnect and can be read or cancelled by job ID.
- **Cost approval flow:** approve_cost confirms or declines a job's current cost preview.
- **Managed creative agent:** run_creative_agent delegates a whole brief to Sogni's agent.
- **Reference uploads:** create_upload returns a signed form for reference media.

## Good for

- Generate product images from an assistant after checking cost
- Create short video clips from a first frame or reference media
- Upscale or remove backgrounds from existing images
- Resume a long render after a client reconnect
- Browse Sogni's changelog from an agent

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http sogni-mcp https://mcp.sogni.ai/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.sogni.ai/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "sogni-mcp": {
      "url": "https://mcp.sogni.ai/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "sogni-mcp": {
      "type": "http",
      "url": "https://mcp.sogni.ai/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "sogni-mcp": {
      "serverUrl": "https://mcp.sogni.ai/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "sogni-mcp": {
      "type": "http",
      "url": "https://mcp.sogni.ai/mcp"
    }
  }
}
```

## Tools

- `list_models`: Discovers models and their supported inputs.
- `get_balance`: Reads account balances and subscription status.
- `quote`: Estimates an image, video, audio or transform call without starting it.
- `generate_image`: Generates images or edits with a supported image-edit model.
- `generate_video`: Generates video from text, image, frame or media inputs.
- `generate_audio`: Generates supported music or speech.
- `transform_media`: Applies transformations such as upscaling or background removal.
- `run_creative_agent`: Delegates a complete brief to Sogni's managed creative agent.
- `create_upload`: Returns a signed upload form and download URL for reference media.
- `get_job`: Reads durable job status, output links and approval requests.
- `approve_cost`: Confirms or cancels a job's current cost preview.
- `cancel_job`: Requests cancellation of a durable job.
- `list_changelog`: Reads the Sogni platform changelog.

## FAQ

### How do I authenticate?

Use a Sogni developer API key as a Bearer token or in an Authorization header. OAuth sign-in and browser session tokens are not accepted.

### Can an agent spend my balance without asking?

Quotes are estimates only, and the docs tell agents to wait for approval of any token charge. Key-level spending limits also apply.

### Does it use the Relaxed network?

No. Hosted MCP generation runs on Fast, and the network filter only affects model discovery.

### What happens if my connection drops?

Jobs continue independently. Call get_job with the saved job ID and kind to read status and outputs.

### Is Sogni MCP free?

Sogni MCP has a free plan, with paid plans for more usage or features.

### How do I add Sogni MCP to Claude Code?

Run this command in your terminal: claude mcp add --transport http sogni-mcp https://mcp.sogni.ai/mcp

### What are the best alternatives to Sogni MCP?

The closest alternatives to Sogni MCP are HyperFrames by HeyGen, ffmpeg-skill, AvatarSay — Fictional Character & Talking Video MCP, ChartAnt and VfxSmith.

## Alternatives

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.
- [Eikino](https://ai-powered.com/mcp/eikino): Eikino is a freemium MCP server for security.
- [Hourlore](https://ai-powered.com/mcp/hourlore): Hourlore is a freemium MCP server for design and media.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.

---
Source: https://ai-powered.com/mcp/sogni-mcp
