Log inSubmit server
2DAI logo

2DAI

Generate images and video, manage 2DAI creations, and inspect account and wallet data through MCP.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install 2DAI

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "2dai-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "2dai-mcp-server"
      ],
      "env": {
        "TWODAI_API_KEY": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.

Overview

2DAI MCP server connects Claude, Cursor, Cline, Windsurf, and other MCP hosts to a user’s 2DAI account. 2DAI exposes tools for image and video generation, reference uploads, creation downloads, public-feed browsing, and cloud-drive organization. Local stdio execution uses npx and an API key, while a hosted Streamable HTTP endpoint is also available. Reach for it when an agent needs to create media and manage the resulting assets without leaving 2DAI.

Use cases

  • Generate reference-guided character images
  • Animate a still image into a video clip
  • Organize generated assets into folders
  • Publish selected creations to the public feed
  • Inspect generation spending and wallet history

Key features

  • Text-to-image and reference-based image generation
  • Short video generation with optional audio references
  • Creation search, filtering, download, and organization
  • Folder, publishing, like, trash, and restore management
  • Account, statistics, wallet, and token-price reads

Tools25

What 2DAI lets your agent do. Expand a tool for its parameters.

Self-reported~785 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 3d ago

Recent health check succeeded.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 11d ago via OSV.dev · 2dai-mcp-server (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

npm downloads1.9kPackage downloads in the last 30 days.
Last commit3d agoMost recent push to the default branch.
Tools exposed25Callable tools this server registers over MCP.

How 2DAI works

What 2DAI MCP server does

2DAI connects an MCP-compatible agent to a 2DAI account for multimedia creation and asset management. It can generate still images, animate creations into short videos, produce variations, apply curated artistic styles, and expand images into wallpaper formats. Reference images can guide character consistency, style transfer, or edits; Gen8 Preview image and video modes support additional references, while Gen8 Preview video can include sound and an optional audio reference.

The server also exposes the operational side of a 2DAI library. Agents can upload reference images and audio, retrieve or download creations, search and filter the library, manage folders, move or trash assets, publish work to the public feed, and inspect generation statistics. Read-only account and wallet tools report credits, tiers, balances, staking-lock status, transaction history, and token-price information.

How it works

The local transport runs over stdio through npx, so the MCP host starts the package as a child process. Authentication uses a 2DAI API key supplied through the environment; the key is not passed as a tool argument. Generation requests may be queued, with check_generation available for polling and cancel_generation able to stop a still-waiting request and refund its charge.

A hosted alternative is available at https://mcp.2dai.io:800/mcp using Streamable HTTP and a Bearer API key. Both transports expose the same tools. Hosted execution has no server-side filesystem: uploads use base64, and downloads return an inline preview plus a URL that can be fetched with the same authorization header.

Setup and configuration

Create an API key in 2DAI under Dashboard, Integrations, and API keys. For local use, configure an MCP client with the 2dai-mcp-server package and set TWODAI_API_KEY to the key. A typical command is:

Terminal
npx -y 2dai-mcp-server

Claude Code can register the command with claude mcp add; clients using JSON MCP configuration can specify npx as the command, -y 2dai-mcp-server as its arguments, and the key in the environment. For the hosted option, configure the MCP URL and send Authorization: Bearer 2dai_sk_... on each request.

API-key scopes control access. Generation requires read and generate permissions, management operations require the manage scope, and wallet information requires the optional finance scope. Wallet tools are read-only and cannot move funds.

Tools and capabilities

  • Generate images from prompts, references, or existing creations, including Gen8 Preview image requests.
  • Generate short videos from still creations, with Gen8 Preview sound and optional music or voice references.
  • Upload image and MP3 references, then download full-resolution results or return previews.
  • Browse, search, sort, and filter creations across folders, trash, shared areas, smart collections, and activity views.
  • Create and manage folders, favorites, posters, and sidebar groups; move, like, restore, trash, or publish creations.
  • Query account credits, generation statistics, wallet history, staking locks, and cached $2DAI prices.

Generation tools spend account credit. Artistic-style generation uses styles returned by list_artistic_styles; reference-based tools enforce limits that vary by operation and model.

Limitations and notes

The hosted deployment cannot read local paths or write files to the client machine. Use base64 for hosted uploads and retrieve downloadable files from the returned API URL. Local execution can save downloads to disk.

Account tier and key permissions affect access to Gen8 Preview models, qualities, durations, and other presets. get_account reports the capabilities available to the authenticated account. Reference uploads and generated media may incur charges, and the generation response’s costUsd is the source of the actual price. Permanent deletion is one-at-a-time, while batch trash and restore support up to 100 creations. NSFW-related flags and rates are included in library rows so an agent can apply its own safeguards.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about 2DAI

2DAI is an MCP server that connects AI hosts to a user’s 2DAI account. Its main tools generate images and video, upload references, download creations, browse and organize the cloud library, publish work, and read account, statistics, and wallet information through local stdio or hosted Streamable HTTP.

Run it with npx rather than installing it permanently: `npx -y 2dai-mcp-server`. Add the command to your MCP client configuration and set `TWODAI_API_KEY` to an API key created in 2DAI Dashboard under Integrations and API keys.

Yes, 2DAI works with Cursor. Configure Cursor to run `npx -y 2dai-mcp-server` and provide `TWODAI_API_KEY`, or point it at `https://mcp.2dai.io:800/mcp` with a Bearer API key for hosted Streamable HTTP access.

Yes, Gen8 Preview video can produce clips with sound. Upload an MP3 with `upload_audio`, then pass its creation ID to `generate_video`; the audio can be used as music or as a voice sample.

No, the hosted server cannot read local upload paths or write downloads to the client machine. Send image and audio uploads as base64, and use the inline preview or returned download URL from `download_creation` for hosted downloads.

Related MCP servers

All in Multimedia Process All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG Preview2DAI AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/2dai-mcp-server?style=directory)](https://allmcps.com/mcp/2dai-mcp-server)
HTML Embed
<a href="https://allmcps.com/mcp/2dai-mcp-server"><img src="https://allmcps.com/api/badge/2dai-mcp-server?style=directory" alt="2DAI on AllMCPs" /></a>