Skip to main content
Glama

BytePlus Seed Audio

Generate natural speech and audio with BytePlus Seed Audio 1.0 β€” from Claude, the terminal, or your own code. Three surfaces over one zero-dependency SDK:

I want to…

Use

Talk to Claude / Claude Code

MCP server (seed-mcp)

Generate from the terminal

CLI (seed)

Claude Code skill

Skill (skills/seed.md)

Build my own integration

SDK (seed-sdk)

Provider: Seed Audio runs on fal.ai (bytedance/seed-audio-1.0) today. The SDK hides this behind a provider abstraction, so when BytePlus releases its native Seed Audio API you flip SEED_PROVIDER=byteplus (and add BYTEPLUS_SEED_API_KEY) β€” nothing else changes. See seed/providers/.

Prerequisites

Related MCP server: ElevenLabs MCP Server

Install (workspace, for development)

uv sync --all-packages --dev      # installs seed-sdk, seed-mcp, seed-cli

πŸ–₯ MCP Server

Expose Seed Audio to Claude Desktop / Claude Code.

pip install seed-mcp                # or: uv pip install ./packages/seed-mcp
export FAL_KEY=<your-fal-key>
python -m seed_mcp                  # stdio transport (default)

Register it (or use the CLI installer, below). Claude config:

{
  "mcpServers": {
    "seed": { "command": "python", "args": ["-m", "seed_mcp"] }
  }
}

Tools

Tool

Purpose

seed_audio_generate

Submit an audio job β†’ returns request_id

seed_check_task

Poll until completed; returns audio_url

seed_list_voices

List preset voice ids

seed_list_models

List Seed models + capabilities

seed_ping

Liveness, provider, credential check

Hosted / Docker

docker build -t byteplus-seed-mcp .
docker run -e FAL_KEY=<key> -e MCP_TRANSPORT=sse -p 8000:8000 byteplus-seed-mcp
# health: GET http://localhost:8000/health

πŸ’» CLI

pip install seed-cli                 # or: pip install 'seed-cli[mcp]'
seed auth login                      # stores FAL_KEY in ~/.seed/credentials

# Generate
seed generate \
  --prompt "A short suspense radio drama in a late-night convenience store." \
  --watch

# With a preset voice
seed voices                          # list presets
seed generate -p "Welcome back to the late show." -v sophie_en_zh --watch

# Voice cloning from reference audio
seed generate -p "In @Audio1's voice: 'Once upon a time…'" \
  --audio-ref https://cdn.example.com/narrator.mp3 --watch

# Track a job
seed status <request_id>
seed watch  <request_id>

# Skill management (Claude Desktop + Claude Code)
seed skill install
seed skill check

Run seed --help for the full command reference.


🧠 Claude Code Skill

skills/seed.md (+ skills/references/) teaches Claude Code how to use Seed Audio well β€” prompting, voice presets, cloning, multi-speaker scenes, and safety.

seed skill install                   # copies the skill + registers the MCP server
# restart Claude Code, then just ask it to "generate a 20s upbeat intro voiceover"

πŸ“¦ SDK

from seed import SeedClient

client = SeedClient()                                  # provider from SEED_PROVIDER (default: fal)
task = client.submit_audio(
    "A short suspense radio drama in a late-night convenience store.",
    output_format="mp3",
)
# poll until done
import time
while not (result := client.check_task(task.request_id)).terminal:
    time.sleep(5)
print(result.audio_url)

seed-sdk has zero runtime dependencies (stdlib urllib only).


Repo structure

byteplus-seed-mcp/
β”œβ”€β”€ packages/
β”‚   β”œβ”€β”€ seed-sdk/      # core: client, types, credentials, providers/{fal,byteplus}
β”‚   β”œβ”€β”€ seed-mcp/      # FastMCP server (5 tools, stdio + SSE)
β”‚   └── seed-cli/      # Typer + Rich CLI, skill installer
β”œβ”€β”€ skills/            # seed.md + references/
β”œβ”€β”€ Dockerfile         # SSE server image
β”œβ”€β”€ render.yaml        # Render.com deployment
└── pyproject.toml     # uv workspace

Credentials

Resolution order (first non-empty wins): explicit arg β†’ FAL_KEY env β†’ ~/.seed/credentials [default] β†’ .env.

Release

Independent per-package PyPI publishes via tags:

git tag sdk/v0.1.0 && git push --tags   # β†’ seed-sdk
git tag mcp/v0.1.0 && git push --tags   # β†’ seed-mcp
git tag cli/v0.1.0 && git push --tags   # β†’ seed-cli

Roadmap

  • Native BytePlus Seed Audio provider (SEED_PROVIDER=byteplus)

  • Local-file upload helper (host local audio/images β†’ public URL)

  • Additional Seed models as they ship

Support

F
license - not found
-
quality - not tested
C
maintenance

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/mittulmadaan/byteplus-seed-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server