Soundza

npx add-mcp 'https://mcp.soundza.com/mcp/oauth'

Como Conectar

Use o soundza a partir de um assistente de IA ou do seu próprio código. Ambos são gratuitos e oferecem os mesmos sons.

Em um assistente de IA

No Claude, ChatGPT, Claude Code ou qualquer aplicativo MCP, adicione o servidor MCP do soundza e faça login uma vez com uma conta gratuita. As etapas para cada um estão abaixo.

No seu próprio código

Em aplicativos, jogos, scripts e ferramentas de build, chame a API REST com uma chave de API gratuita. Obtenha uma chave.

REST

https://api.soundza.com/v1

MCP, login

https://mcp.soundza.com/mcp/oauth

MCP, chave de API

https://mcp.soundza.com/mcp

OpenAPI

soundza.com/openapi.json

Para agentes

soundza.com/llms.txt

O servidor MCP tem cinco ferramentas: search_sounds, get_sound, search_packs, get_pack e download_sound, que retorna um link de 15 minutos, um comando curl pronto e a página do som.

Claude

1. Clique em Adicionar ao Claude. O Claude abre com o nome e a URL preenchidos. Clique em Adicionar.
2. Faça login no soundza e aprove. Uma conta gratuita é tudo que você precisa.
3. Em um chat, clique em +, abra Conectores e ative o Soundza.

Adicionar ao Claude ou adicione um conector personalizado com https://mcp.soundza.com/mcp/oauth

ChatGPT

1. Abra plugins do ChatGPT e adicione um servidor MCP personalizado. Nomeie-o como Soundza e mantenha OAuth.
2. Cole a URL abaixo e faça login no soundza.
3. Em um novo chat, escolha Soundza no menu de ferramentas.

URL https://mcp.soundza.com/mcp/oauth

Servidores personalizados dependem do seu plano do ChatGPT; alguns precisam do Modo de desenvolvedor ativado nas configurações.

Claude Code

Adicione-o e execute /mcp, escolha soundza e faça login no navegador.

claude mcp add --transport http soundza https://mcp.soundza.com/mcp/oauth

Prefere usar uma chave? Defina SOUNDZA_API_KEY e adicione https://mcp.soundza.com/mcp com um cabeçalho Authorization. A página de chaves mostra este comando com sua chave preenchida:

claude mcp add --transport http soundza https://mcp.soundza.com/mcp --header "Authorization: Bearer $SOUNDZA_API_KEY"

Codex, Cursor e outros agentes

Qualquer cliente que fale HTTP streamable. Use https://mcp.soundza.com/mcp/oauth se ele suportar login; caso contrário, use https://mcp.soundza.com/mcp com um cabeçalho Authorization. Para o Cursor, adicione isso ao ~/.cursor/mcp.json; ele lê a chave do seu ambiente, então a chave fica fora de arquivos que você possa commitar.

{
  "mcpServers": {
    "soundza": {
      "url": "https://mcp.soundza.com/mcp",
      "headers": { "Authorization": "Bearer ${env:SOUNDZA_API_KEY}" }
    }
  }
}

Obtenha uma chave de API

Use uma chave no seu próprio código. Envie-a como Authorization: Bearer <key>. As chaves começam com sz_live_. Mantenha a sua no servidor ou em um .env ignorado pelo git, nunca no código do cliente.

Crie uma você mesmo

Faça login e crie uma chave na página de chaves. Ela é mostrada uma única vez, com o comando MCP preenchido.

Ou deixe seu agente fazer login

Peça ao seu agente de codificação para encontrar sons em soundza.com. Ele lê llms.txt, envia um link para você aprovar e salva a chave ele mesmo.

Soundza is free, but every call needs an API key tied to a person's account. Get one with a one-click sign-in:

1. Start the sign-in. Include what the person is building, if you know it from the project: project_kind (one of game, video_tool, own_content, app, agent, music, trying, other) and project, one plain line about it. After approving, the person sees both and can change them; leave out anything you'd have to guess.
   curl -s -X POST https://api.soundza.com/v1/auth/device -H "content-type: application/json" -d '{"client_name":"<your tool> on <this machine>","project_kind":"game","project":"<one line, e.g. A retro sci-fi shooter in Godot>"}'
   It returns device_code, user_code, verification_uri_complete, expires_in (600 seconds) and interval (5 seconds).
2. Tell the human: "Open <verification_uri_complete> and approve code <user_code> (sign in with Google if it asks)." Nothing else is needed from them.
3. Right after telling them, poll every <interval> seconds until they approve. Run the polling loop in the foreground and wait for it; don't end your turn while the sign-in is pending (the code lasts 10 minutes).
   curl -s -X POST https://api.soundza.com/v1/auth/token -H "content-type: application/json" -d '{"device_code":"<device_code>"}'
   While it returns {"error":"authorization_pending"} keep polling; on "slow_down" wait the "interval" it returns. On approval it returns {"access_token":"sz_live_...","token_type":"Bearer",...} once: access_token is the API key. "expired_token" or "access_denied" means stop (start again only if the human asks).
4. Save the key as SOUNDZA_API_KEY in the project's .env and make sure .env is in .gitignore. Never commit the key or put it in a project-scope .mcp.json.
5. Optional: connect this MCP server with the key. The command reads $SOUNDZA_API_KEY from the shell, so load .env first (set -a; . ./.env; set +a). It stores the key in Claude Code's own settings (local scope), not in the project. If soundza is already added without a key, run "claude mcp remove soundza" first.
   claude mcp add --transport http soundza https://mcp.soundza.com/mcp --header "Authorization: Bearer $SOUNDZA_API_KEY"
   The tools load in the next session (or after /mcp). Until then, and in any tool that can't add MCP servers, use the REST API at https://api.soundza.com/v1 with the header "Authorization: Bearer $SOUNDZA_API_KEY". It does everything the MCP tools do.

A person can also create a key at https://soundza.com/developers/keys and set it the same way.

Início rápido

Pesquise e baixe o que você usar. Defina SOUNDZA_API_KEY primeiro.

curl -s "https://api.soundza.com/v1/sounds/search?type=sound_effect&q=whoosh&per_page=5" \
  -H "Authorization: Bearer $SOUNDZA_API_KEY"

# download_url redirects to the file: -L follows it, -OJ saves it under its own name
curl -LOJ "https://api.soundza.com/v1/sounds/SOUND_ID/file" \
  -H "Authorization: Bearer $SOUNDZA_API_KEY"

Cada resultado tem preview_files, MP3s de 128 kbps que tocam direto do nosso CDN sem chave, e um download_url para o arquivo de qualidade total.

Endpoints

Cada endpoint é uma requisição GET sob https://api.soundza.com/v1. A especificação completa está em /openapi.json.

Endpoint	O que faz
GET /sounds/search	Pesquisa por palavras e filtros. Retorna uma página de sons e um search_id.
GET /sounds/{id}	Um som, por id.
GET /sounds/{id}/file	O arquivo de qualidade total, geralmente WAV, com nível ajustado ao catálogo;?variant=original para o original intacto. Um 302 para um link que funciona por 5 minutos. search_id e user opcionais.
GET /packs	Pacotes públicos, melhores primeiro. q, page e per_page opcionais.
GET /packs/{id}	Um pacote e, em seguida, uma página de seus sons. Cada som nomeia seu pacote.
GET /removals?since=	Sons removidos desde uma data ISO, para quem armazena arquivos.

Parâmetros de pesquisa

Forneça um q, pelo menos um filtro, ou ambos. As durações estão em segundos.

Parâmetro	Tipo	Descrição
q	string	Palavras para corresponder, ex.: "batida de porta" ou "loop de bateria lofi". Erros de digitação são perdoados.
type	string	O que o som é: music, sound_effect ou ambience (veja Tipo e fatos). Não diferencia maiúsculas de minúsculas. Uma pesquisa com q que não encontra nada dentro do seu tipo pesquisa todos os tipos e informa isso em relaxed_filters.
form	string	Somente música: track, excerpt, loop, one_shot ou stem.
parts	string	Somente música: full_mix ou single_part. Sem ele, type=music classifica mixes completos primeiro, depois loops, depois partes únicas.
vocals	string	Somente música: none, backing ou lead.
style	string	Somente efeitos sonoros: retro ou cartoon. Definido por pacote, então a maioria dos sons não tem; com um q que não encontra nada com ele, ele é descartado e listado em relaxed_filters.
min_duration	number	Duração mais curta, em segundos.
max_duration	number	Duração mais longa, em segundos.
min_bpm	number	Tempo mais lento. Somente música tem tempo.
max_bpm	number	Tempo mais rápido.
key	string	Tom musical, ex.: "C", "F# minor" ou "Bbm". Corresponde apenas aos tons que os sons mostram: informados pela fonte ou por uma pessoa, ou detectados com alta confiança.
chord	string	Acorde que um one-shot de acorde toca, ex.: "Am", "C#m7" ou "Fmaj7".
note	string	Nota que um one-shot afinado toca: "D3" para aquela oitava (C3 é o Dó central), ou "D" para qualquer oitava.
mood	list	Palavras de humor separadas por vírgula; sons que correspondem a qualquer uma delas voltam, e mais correspondências classificam mais alto. Uma de: airy, heavy, metallic, bright, dark, punchy, soft, warm, glitchy, organic, cinematic, cartoony, retro.
good_for	list	Trabalhos separados por vírgula para os quais o som deve servir. Somente classificação: sons correspondentes classificam mais alto, e nada é filtrado. Uma de: transition, reveal, build_up, impact_on_beat, title_or_logo, notification, ui_click, menu, game_pickup, game_hit, game_power_up, footsteps, background_bed, intro, outro.
fit_seconds	number	A duração que o som precisa preencher, ex.: 20 para um anúncio de 20 segundos. Classifica sons que podem preenchê-la (uma faixa com pelo menos essa duração, ou um loop contínuo) e adiciona uma dica de ajuste a cada resultado. Não filtra nada.
pack	string	O id ou slug de um pacote: apenas os sons daquele pacote.
loop_seamless	boolean	true: apenas sons que fazem loop contínuo, medido pelo áudio (o final volta ao início sem clique ou salto). Para música de jogos e camadas de ambiente que se repetem sob uma cena.
category	string	Uma categoria de nível superior do Universal Category System ("CROWDS") ou CatID ("CRWDCheer"). Efeitos sonoros e ambientes.
page	integer	Número da página, a partir de 1.
per_page	integer	Resultados por página: padrão 15, no máximo 50. Os resultados param em 500 por consulta.

Resposta

Uma página de resultados, com um link para a próxima página. bpm e key descrevem música; creator é null quando um som não tem criador público.

Os arquivos têm nível ajustado, então os sons se encaixam sem ajustar cada um: um ganho por som, sem compressão, picos em ou abaixo de −1 dBTP. Ambientes visam −20 LUFS, música, pads e loops longos visam −16, todo o resto visa −13 nos 400 ms mais altos. lufs, true_peak_db e loudness descrevem o original; gain_db é o que o arquivo padrão adiciona a ele. Adicione ?variant=original à rota do arquivo para o original como enviado.

{
  "page": 1,
  "per_page": 5,
  "total_results": 38,
  "next_page": "https://api.soundza.com/v1/sounds/search?q=whoosh&type=SOUND_EFFECT&per_page=5&page=2",
  "search_id": "x7k2m9q4r1t8v3w6y0z5a2b4",
  "sounds": [
    {
      "id": "cm9w2k4e30001",
      "url": "https://soundza.com/sounds/fast-air-whoosh",
      "title": "Fast Air Whoosh",
      "description": "A quick, bright air whoosh that sweeps left to right.",
      "type": "sound_effect",
      "form": null,
      "parts": null,
      "vocals": null,
      "style": null,
      "good_for": ["transition"],
      "duration": 0.84,
      "bpm": null,
      "key": null,
      "chord": null,
      "note": null,
      "mood": ["airy", "bright"],
      "tags": ["whoosh", "swipe", "air", "airy", "bright"],
      "sync_ms": 310,
      "lufs": -19.4,
      "true_peak_db": -6.1,
      "loudness": { "value": -18.2, "basis": "momentary_max" },
      "gain_db": 5.1,
      "loop_seamless": null,
      "file_type": "audio/wav",
      "file_extension": "wav",
      "sample_rate": 48000,
      "bit_depth": 24,
      "channels": 2,
      "size_bytes": 322604,
      "category": { "id": "WHSH", "label": "Swooshes › Whoosh" },
      "pack": {
        "id": "cm8p1x7a20004",
        "name": "Air and Motion",
        "slug": "air-and-motion",
        "sound_count": 42,
        "url": "https://soundza.com/packs/air-and-motion"
      },
      "creator": null,
      "preview_files": [
        { "type": "audio/mpeg", "bitrate": 128, "link": "https://media.soundza.com/public/previews/4fJ9aQx2LmP0sT7vKc1Rb8Ze.mp3" }
      ],
      "download_url": "https://api.soundza.com/v1/sounds/cm9w2k4e30001/file",
      "license": { "name": "Soundza Standard License", "url": "https://soundza.com/license" },
      "attribution": "\"Fast Air Whoosh\" on Soundza (https://soundza.com/sounds/fast-air-whoosh)"
    }
  ]
}

Tipo e fatos

type diz o que um som é. Filtre primeiro por tipo, depois pelos fatos que você conhece, e coloque o resto em q.

type	O que pertence	Fatos
music	Faixas, trechos, loops, one-shots, stems, stingers, jingles e vocal chops, incluindo música de jogos.	form (track, excerpt, loop, one_shot, stem), parts (full_mix, single_part), vocals (none, backing, lead), bpm, key, note, chord
sound_effect	Whooshes, impactos, foley, sons de UI e jogos, vozes como efeitos.	category (UCS), style (retro, cartoon; definido por pacote)
ambience	Lugares, tom de ambiente e camadas de ruído.	category (UCS)

"Música de fundo corporativa, sem vocais" é type=music&vocals=none&q=corporate. Com type=music, mixes completos vêm primeiro, depois loops, depois partes únicas, a menos que você defina parts. good_for move sons adequados a um trabalho (transition, ui_click, background_bed …) para cima nos resultados sem filtrar nenhum. Uma pesquisa com q que não encontra nada dentro do seu tipo pesquisa todos os tipos e lista type em relaxed_filters.

Limites

Chaves gratuitas recebem:

• 60 pesquisas por minuto
• 250 downloads por hora
• 350 downloads por dia

Cada resposta inclui estes cabeçalhos. Um 429 também inclui Retry-After, em segundos:

• X-RateLimit-Limit
• X-RateLimit-Remaining
• X-RateLimit-Reset
• X-RateLimit-Policy

Todas as chaves em uma conta compartilham esses limites. Experimente sons com seus preview_files, que são gratuitos e não contam, e baixe apenas os sons que você usar.

Apenas sons diferentes contam como downloads, então buscar o mesmo som novamente dentro de 24 horas é gratuito. O total de buscas de arquivos é limitado ao dobro dos limites de download. Salve cada arquivo uma vez e reutilize-o pelo id do som. Consultar um único som ou pacote tem um limite separado, cinco vezes o limite de pesquisa.

Colocando um seletor de sons no seu aplicativo? Pode ir em frente: uma chave gratuita cobre um aplicativo pequeno com alguns usuários por dia. Quando ele tiver tráfego real, solicite limites maiores na página de chaves e conte um pouco sobre ele, ou escreva para admin@soundza.com. Responderemos por e-mail.

Solicitar limites maiores

Dando crédito

Tudo é completamente gratuito. A única coisa que pedimos é que você credite soundza.com (e/ou um criador original do som, se aplicável) em algum lugar que faça sentido para o seu projeto. Idealmente, inclua um link para soundza.com em algum lugar do seu site/blog/página itch (ex.: 'Obrigado à soundza.com pelos sons gratuitos'). Se você não tiver um site, adoraríamos um agradecimento nas redes sociais ou na descrição de um vídeo no Youtube, etc. Ajude a espalhar a palavra!

Abaixo estão alguns exemplos. Somos flexíveis sobre como você nos credita, mas pedimos que o faça de alguma forma que funcione naturalmente para o seu projeto.

O que você está fazendo	Como creditar
Um aplicativo ou ferramenta com seletor de sons	Powered by soundza no seletor, além de um link para soundza.com no rodapé do seu site, página Sobre, blog ou outro lugar que faça sentido.
Um jogo, mesmo pequeno	Onde você o compartilhar (um post no Reddit ou Discord, X, seu devlog ou site, itch.io ou Steam), um rápido agradecimento à soundza.com, com um link onde puder.
Vídeos	Sound effects: soundza.com na descrição do YouTube. No TikTok ou Instagram, marque @soundza_audio se puder.
Um bot, agente ou ferramenta de código aberto	Uma linha no seu README, texto de ajuda ou página de listagem.
Algo só para você	Nada necessário.

Quer usar nosso logotipo? Fique à vontade para mostrá-lo com seu link: o logotipo completo (PNG) ou a marca sozinha (SVG). Só não o use como ícone do seu aplicativo.

Fez algo com o soundza? Adoraríamos ver. Envie um e-mail para admin@soundza.com ou marque @soundza_audio. Compartilhamos projetos legais.

Erros

Erros são JSON: {"error": {"code", "message", "details"?}}.

Status	Código	Significado
400	invalid_request	Um parâmetro está errado. details lista cada um.
401	missing_key	Sem cabeçalho Authorization: Bearer.
401	invalid_key	A chave não existe.
401	revoked_key	A chave foi revogada.
404	not_found	Nenhum som público tem esse id.
429	rate_limited	Um limite foi atingido. Aguarde os segundos de Retry-After.
500	server_error	Algo deu errado do nosso lado. Tente novamente em breve.

Licenciamento

Todo som está sob a Licença Padrão Soundza, vinculada ao campo license: livre de royalties para uso pessoal e comercial, sem necessidade de atribuição para os próprios sons (veja como dar crédito para o que pedimos em troca). Revisamos os sons com cuidado, mas os fornecemos como estão, sem garantia de que um som esteja livre de reivindicações de terceiros. A licença contém os termos completos.

Diretrizes

• Assim que pessoas fora da sua equipe virem o que você cria, faça um link de volta para soundza.com da forma que fizer sentido: "Powered by soundza" junto ao seu seletor de sons, além de um link no seu site, um agradecimento onde você compartilhar seu jogo, ou uma linha na descrição do seu vídeo. Veja soundza.com/developers#credit.
• Solicite o download_url de um som quando ele for adicionado a um projeto, salve o arquivo uma vez e reutilize-o pelo id do som.
• As prévias servem para ouvir. Use os arquivos baixados no trabalho final.
• Não copie a funcionalidade principal da Soundza nem crie uma biblioteca de sons ou API concorrente.
• Uma chave gratuita pode armazenar até 500 sons baixados. Remova qualquer som listado em GET /v1/removals e verifique pelo menos mensalmente.
• Respeite os limites de taxa e peça quando precisar de mais. Podemos suspender ou encerrar o acesso à API para qualquer pessoa, a qualquer momento, por qualquer motivo.

O uso da API é regido pelos Termos de Serviço e pela Licença.

Seletor Soundza

Um seletor de sons para o seu produto em três arquivos: duas rotas de servidor que mantêm sua chave privada, e um componente com chips, prévias e o link de crédito. Estilize para combinar com seu aplicativo.

// app/api/sounds/route.ts: search, with your key kept on the server
export async function GET(req: Request) {
  const params = new URL(req.url).searchParams;
  const res = await fetch(\`https://api.soundza.com/v1/sounds/search?${params}\`, {
    headers: { Authorization: \`Bearer ${process.env.SOUNDZA_API_KEY}\` },
  });
  return new Response(res.body, { status: res.status, headers: { "Content-Type": "application/json" } });
}

// app/api/sounds/[id]/file/route.ts: call it from your server when a user adds a sound
export async function GET(req: Request, { params }: { params: Promise<{ id: string }> }) {
  const { id } = await params;
  const query = new URL(req.url).searchParams; // search_id, and your own user id as user
  const res = await fetch(\`https://api.soundza.com/v1/sounds/${encodeURIComponent(id)}/file?${query}\`, {
    headers: { Authorization: \`Bearer ${process.env.SOUNDZA_API_KEY}\` },
    redirect: "manual",
  });
  const location = res.headers.get("location");
  return location ? Response.redirect(location, 302) : new Response(res.body, { status: res.status });
}

Quando um usuário adicionar um som, busque a rota de arquivo do seu servidor e salve o arquivo no seu próprio armazenamento. Isso conta como download. A rota redireciona para um link assinado que dura 5 minutos e não pode ser lido de um navegador em outro site, então não o busque no lado do cliente nem guarde o link. Passe seu próprio ID de usuário como user se quiser relatórios por usuário.

FAQ

A API é gratuita?

Sim. A API e as chaves são gratuitas. Em troca, adoraríamos um link de volta para soundza onde fizer sentido com o que você cria.

Preciso dar crédito à soundza?

Pedimos isso assim que pessoas fora da sua equipe virem o que você cria, na forma que fizer sentido: um link no seu site, na sua página de loja ou na descrição do seu vídeo. Nada é necessário enquanto você desenvolve ou testa, nem para coisas que são só para você.

O que conta como crédito?

Um link para soundza.com onde as pessoas possam vê-lo. Para um aplicativo, Powered by soundza junto ao seu seletor de sons, além de um link no rodapé do seu site, na página Sobre, no blog ou em outro lugar que faça sentido. Para um jogo, um agradecimento onde você o compartilhar: uma postagem no Reddit ou Discord, seu devlog ou site, ou a página no itch.io ou Steam. Para um vídeo, Sound effects: soundza.com na descrição. Um agradecimento no X, Discord ou YouTube também é bem-vindo.

Vocês vão compartilhar o que eu criar?

Adoraríamos saber o que você constrói. Envie um e-mail para admin@soundza.com ou marque @soundza_audio e conte o que você fez. Recompartilhamos projetos legais feitos com soundza.

Posso usar o logotipo da soundza?

Sim, adoraríamos que você o exibisse junto ao seu link "Powered by soundza", embora seja opcional. Por favor, não o use como ícone do seu aplicativo. Baixe o logotipo completo (soundza.com/logo-wordmark.png) ou a marca sozinha (soundza.com/logo.svg).

Quais são os limites?

Chaves gratuitas recebem 60 buscas por minuto, 250 downloads por hora e 350 por dia, compartilhados por todas as chaves da sua conta. Pré-vias não contam. Cada resposta tem cabeçalhos X-RateLimit-*.

Como obtenho limites maiores?

Os limites gratuitos cobrem criar um jogo, editar vídeos ou um aplicativo pequeno com seletor de sons. Se você está colocando um seletor de sons em um aplicativo com tráfego real, use "Request higher limits" na página de chaves e conte um pouco sobre isso, ou envie um e-mail para admin@soundza.com com o prefixo da sua chave e o que você está criando. Responderemos por e-mail.

Posso usar os sons em projetos comerciais?

Sim. Todo som é livre de royalties para uso pessoal e comercial sob a Licença Padrão Soundza, e incluir um som dentro de um jogo ou aplicativo que você cria é permitido.

Posso armazenar os arquivos?

Sim. Salve cada arquivo uma vez e reutilize-o pelo id do som. Uma chave gratuita pode armazenar até 500 sons baixados. Não guarde o link assinado para o qual download_url redireciona; ele dura 5 minutos.

E se um som for removido?

Chame GET /v1/removals?since=<date> de vez em quando (pelo menos mensalmente) e exclua qualquer som que ele listar.

Posso usar os sons para treinar IA?

Não. Os sons não podem ser usados para treinar, ajustar ou construir um modelo de IA ou aprendizado de máquina.

Posso criar uma biblioteca de sons com a API?

Não. Por favor, não redistribua sons como arquivos independentes ou pacotes de samples, nem crie uma biblioteca de sons ou API concorrente.

REST ou MCP?

Ambos usam a mesma chave, limites e catálogo. Use REST no seu código e MCP (mcp.soundza.com/mcp) para que um agente como Claude Code ou Cursor possa buscar e baixar por você.

Meu agente de codificação pode obter uma chave sozinho?

Sim. Peça a ele para encontrar sons em soundza.com. Ele lê llms.txt, envia a você um link para aprovar e salva a chave.