Initial release of soundiiz-mcp — an MCP server for the Soundiiz User API (BETA).
Install
```bash
npm install -g soundiiz-mcp
or run via npx
npx soundiiz-mcp
```
Or wire it directly into your MCP client — see the README for Claude Desktop, Claude Code, and OpenCode snippets.
What's in 0.1.0
- 15 curated tools across user, syncs, smartlinks, cache, and auth domains.
- Auto-generated `soundiiz_read_` and `soundiiz_write_` tools from every operation in the vendored OpenAPI spec.
- Confirmation-token flow on the three destructive operations (`soundiiz_sync_trigger`, `soundiiz_sync_delete`, `soundiiz_smartlink_delete`): the first call returns a `confirmId`; the second call (same args + `confirmId`) executes.
- Three key-store backends: env, on-disk file (mode 0600), or OS keychain via `keytar`.
- Per-resource allowlists, token-bucket rate limiter, TTL cache with explicit invalidation.
Status
Early. The Soundiiz User API itself is in BETA, so the surface this server wraps may shift. The 25-test mock suite exercises every curated tool, but the maintainer has not yet validated this against a real Creator-plan account in the wild — if you're an early adopter, please run `npm run smoke:live` and file an issue if anything behaves differently than the spec suggests.
Requires
- Node.js 22 or newer.
- A Soundiiz Creator-plan subscription (the User API is gated behind it).
See CHANGELOG.md for the full notes.