Skip to main content
Founder#1 on AI Agents DirectoryRequest a scope
All docs

Products

Suede AI developer resources: API, MCP server, and CLI

Suede AI developer resources: the x402 music, video and image API and its OpenAPI spec, the remote and npm MCP servers, the suede CLI and SDK, and Markdown for every page.

Last updated

Suede AI API

The Suede AI API generates an original song, a short video clip with native audio, or a still image from a text prompt. It is paid per call in USDC on Base over the x402 protocol, so an agent needs a funded wallet and no account or API key. The base URL is https://app.suedeai.ai and the contract is the Suede AI OpenAPI spec, which carries the live routes, prices, request and response schemas, the typed error model, and the rate-limit headers.

  1. Send the request without payment. The API answers HTTP 402 with the payment requirements.
  2. Sign the payment and send the same request again with a PAYMENT-SIGNATURE header. A Skyfire pay or kya-pay token is accepted in the same header.
  3. A paid call is asynchronous by default and answers 202 with a pollUrl. Polling it is free and returns the finished asset.

Single-capability specs, one per paid endpoint, are listed in the Suede AI service spec index.

Suede AI MCP servers

  • Remote: suedeai.ai/mcp speaks the Model Context Protocol over Streamable HTTP. It is read-only and needs no authentication. Its tools return the company overview, the live paid-endpoint catalog, and any suedeai.ai page as Markdown. The discovery document is at /.well-known/mcp.
  • Local: the @suedeai/mcp-server npm package runs over stdio with an agent wallet and exposes the paid generation tools.

Suede AI CLI and SDK

The @suedeai/agents npm package is the SDK for agents on Suede AI Agent Studio and installs the suede command. Install it globally with npm i -g @suedeai/agents, then use suede init to scaffold an agent, suede login to save a workspace key, suede push and suede pull to sync with Agent Studio, suede dev to run locally, and suede whoami to check the active workspace.

Machine-readable files

  • llms.txt: what Suede AI is, when an agent should use it, and how to call it.
  • Agent card: A2A discovery metadata.
  • x402 manifest: the paid resources and their payment requirements.
  • Markdown: every page on suedeai.ai answers Accept: text/markdown at its normal URL with a Markdown version of the page.

Support

Questions about the API or the MCP servers go to support. Service engagements go through Suede AI SEO.

PreviousAgent StudioNextStrumly and Muse