Use Suno in Vercel AI SDK applications through Ace Data Cloud's hosted MCP service. This integration is maintained by Ace Data Cloud, not by the Suno model creator or Vercel. Each service is an independently installable npm package; no local Python server is required.
Target official listing: AI SDK Tools Registry. Not listed yet. Version 0.1.0 is published on npm, with provenance and exact registry integrity readback verified on 2026-10-19. The independent GitHub release archive is also available. Official AI SDK Tools Registry acceptance is a separate stage; this service is not listed there yet.
npm install @acedatacloud/ai-sdk-suno ai@^7 zod@^4
npm install https://github.com/AceDataCloud/AISDK/releases/download/v0.1.0/acedatacloud-ai-sdk-suno-0.1.0.tgz ai@^7 zod@^4
Use the exact asset URL and compare its SHA-256 with SHA256SUMS.txt on release v0.1.0. A GitHub artifact is not an npm or official Tools Registry listing. Release availability is tracked on that page.
Node.js 22+ is required. Keep dependencies within one AI SDK major. The release runner also validated the current AI SDK 7.0.143 / MCP 2.0.78 / compatible 3.0.71 with a real local protocol fixture and type checks. No paid generation was run.
ACEDATACLOUD_API_KEY. Do not include Bearer in this value. A platform-... account-management token cannot replace a generation API key. Never expose this key in browser code, screenshots, prompts or Git.

These are existing Ace console screenshots from SunoDify commit 8d3d035 (reused 2026-10-18), not AI SDK configuration screens. Real credentials are not shown.
AI SDK is a library: configuration belongs in your server module, not a newly added provider dropdown.
import { createSunoTools } from '@acedatacloud/ai-sdk-suno';
const connection = await createSunoTools({
apiKey: process.env.ACEDATACLOUD_API_KEY,
// Defaults to read-only task/reference tools. No paid generation is exposed.
});
try {
console.log(Object.keys(connection.tools));
} finally {
await connection.close();
}
Connection performs MCP initialization and tool discovery. It does not submit a model/media generation, prove downstream balance, or query unrelated user tasks. Hosted endpoint: https://suno.mcp.acedata.cloud/mcp. The package allows only this service's documented tool names and rejects contract drift.
import { generateText, stepCountIs } from 'ai';
import { createSunoTools } from '@acedatacloud/ai-sdk-suno';
// `model` is your configured AI SDK language model (Ace or another provider).
// `approvalStore` is application code that records a user's explicit approval.
const connection = await createSunoTools({
mode: 'generate',
authorize: async (call) => approvalStore.consumeApproval(call),
});
try {
const result = await generateText({
model,
tools: connection.tools,
prompt: userMessage,
stopWhen: stepCountIs(3),
maxRetries: 0,
});
console.log(result.text);
} finally {
await connection.close();
}
This is an application integration excerpt: model, approvalStore and userMessage are supplied by your application. Implement the approval policy outside model control; an explicit true from the callback authorizes that one paid tool call. The package defaults to read-only and refuses generation mode without the callback. Do not use an unconditional approval function in an untrusted public app.
Generation can incur charges. Save the original task ID returned by suno_generate_music; it can be pending, not a completed media result. Query the same ID with suno_get_task until the server reports a terminal success or failure. Keep the structured/text MCP content and errors intact; do not invent success from an accepted submission or URL alone. Never resubmit a paid create after an ambiguous timeout. This package neither auto-polls nor auto-retries paid calls.
Display the final URL in your application's image/audio/video component; AI SDK tool support does not automatically add a player. Reconcile each real create request with Ace usage history. Model tokens and media service charges are separate.
Read-only/reference mode: suno_get_task, suno_get_tasks_batch, suno_list_models, suno_list_actions.
Generation mode additionally allows: suno_generate_music, suno_generate_custom_music, suno_extend_music, suno_cover_music.
All other server tools stay hidden; tools can restrict the published allowlist further. Call close() after streaming has fully ended, not immediately after constructing a stream.

Official Chatbot original last changed 2026-03-20; edited reference dated 2026-10-17. This is not actual Ace execution, not a new GUI or proof of registry listing. Original source.
The published package is tested with free fixtures and hosted discovery only. No new paid generation is claimed. These npm packages reuse hosted service implementations from AceDataCloud/MCPs; they do not fork provider workers, prices or model fallbacks. 中文说明.