@suedeai/mcp-server

MCP server: rights-aware music and video generation by Suede AI, payable by autonomous agents over x402 on Base. No API keys. Wallet signature only.

This is the only x402-paying creative-generation MCP server in the public registries. The agent's wallet pays USDC on Base per call and receives a rights-aware, fingerprinted media asset. Designed to register on Smithery and Pulse MCP.

Tools

| Tool | Price | Description | |---|---|---| | suede_generate_music | 0.20 USDC on Base | Generate an original music track. | | suede_generate_video | 1.50 USDC on Base | Generate a short cinematic clip. |

Both tools return { assetUrl, provenance } and stream a human-readable confirmation in the text content block.

Install

pnpm add @suedeai/mcp-server
# or: npm install @suedeai/mcp-server

Then run via the bundled bin:

SUEDE_WALLET_PRIVATE_KEY=0x... npx suede-mcp

Configure

| Env | Required | Default | Notes | |---|---|---|---| | SUEDE_WALLET_PRIVATE_KEY | yes | — | 0x-prefixed hex. Use a dedicated agent wallet funded with USDC on Base. | | SUEDE_SERVICE_URL | no | https://app.suedeai.ai | Override for staging/preview deployments. | | SUEDE_NETWORK | no | base-mainnet | Or base-sepolia for testing. | | SUEDE_RPC_URL | no | viem default | Custom Base RPC endpoint. |

Wire into Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "suede": {
      "command": "npx",
      "args": ["-y", "@suedeai/mcp-server"],
      "env": {
        "SUEDE_WALLET_PRIVATE_KEY": "0x..."
      }
    }
  }
}

How payment works

1. The MCP tool handler POSTs to https://app.suedeai.ai/create-music (or /agent/video).
2. Suede returns 402 Payment Required with an x402 challenge — network eip155:8453, USDC on Base, recipient 0xb5a0…032d.
3. The server signs an EIP-3009 TransferWithAuthorization for the exact amount.
4. The server retries with X-PAYMENT: <base64 signed authorization>.
5. Coinbase x402 facilitator verifies + settles on-chain.
6. Suede returns the asset URL + provenance metadata.

No facilitator key required on this side — Suede operates the facilitator path.

Verify locally

Quick stdio smoke check after pnpm build:

printf '%s\n%s\n%s\n' \
  '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"smoke","version":"0"}}}' \
  '{"jsonrpc":"2.0","method":"notifications/initialized","params":{}}' \
  '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}' \
  | node dist/index.js

You should see both tools listed with their input schemas.

Registry registration

• Smithery: point at this repo; the bin entry exposes the server as npx @suedeai/mcp-server.
• Pulse MCP: submit https://github.com/Suede-AI/mcp-server-suede with the two tool names and price tags above.

Production checklist

• [ ] Wallet has USDC on the configured network
• [ ] Wallet is dedicated to the agent (limit blast radius)
• [ ] Daily spending caps enforced in agent config
• [ ] Telemetry on tx hashes from X-PAYMENT-RESPONSE for audit

License

MIT (c) Suede Labs - https://suedeai.ai

Links

• Service: https://app.suedeai.ai
• x402 discovery: https://app.suedeai.ai/.well-known/x402.json
• Agent card: https://app.suedeai.ai/.well-known/agent-card.json
• IP Registry: https://ip.suedeai.ai
• X: https://x.com/AISUEDE