# Strumly — the music oracle for agents

> Strumly is the music oracle for agents. When an AI agent needs **verified musical truth** — a chord, a key, a song's structure, a practice plan tuned to a player — it queries Strumly and pays per call in USDC on Base via x402, or in USD via Stripe Checkout. One HTTP request. No accounts. No API keys. **Powered by [Suede Labs AI](https://suedeai.ai)**.

> Strumly is canonical and cited — every answer is sourced from verified theory or attested song data. Built so musicians earn when AI uses music data, and so likeness and authorship stay with the artist. Every paid query is auditable and travels the agentic-commerce rail (x402 on Base or Stripe Checkout), the foundation for routing earnings back to creators.

The Coach API is live at https://strumly.suedeai.ai/api/v1/* with **four payment rails**, each labeled by behavior:

- **x402 / USDC on Base (direct)** — one-shot per-call ($0.99–$4.99). Spec-compliant per [x402-specification-v1](https://github.com/coinbase/x402/blob/main/specs/x402-specification-v1.md). Receiver wallet: `0xb5a05466712fd5bcdf2883f43cC6B1799428032d`. Settlement runs against Coinbase CDP's facilitator by default, with [PayAI's open facilitator](https://facilitator.payai.network/supported) as automatic fallback.
- **Stripe Checkout per-call** — one-shot per-call card payment at the same prices ($0.99–$4.99). Session valid for 1 hour for the specific product purchased.
- **Stripe Checkout day pass** — pre-purchased credit, $9.99 buys 24h of unlimited calls to every paid endpoint.
- **Free tier** — 5 free calls per IP per UTC day, across all paid endpoints. Useful for cold testing.

## Discoverable via agent runtimes

Listed on: Virtuals ACP (Johnny Suede #749), Stripe Agentic Commerce.

- [Agent Cash](https://agentcash.dev/partners/suede) — Strumly is an Agent Cash partner. Agent Cash's CLI/runtime parses our `x-payment-info` extensions from `/openapi.json` and routes payments via x402 or MPP.
- Validation: `npx -y @agentcash/discovery@latest discover https://strumly.suedeai.ai/api/v1/ask`

## Paid endpoints

- [Strumly coach query](https://strumly.suedeai.ai/api/v1/ask): 0.99 USDC per call via x402, or $0.99 per call via Stripe Checkout, or covered by the $9.99 24h Stripe day pass.
- [Song analysis (chords + strumming + drills)](https://strumly.suedeai.ai/api/v1/analyze-song): 1.99 USDC per call via x402, or $1.99 per call via Stripe Checkout, or covered by the $9.99 24h Stripe day pass.
- [Chord-progression transcription from audio prompt](https://strumly.suedeai.ai/api/v1/transcribe-progression): 2.99 USDC per call via x402, or $2.99 per call via Stripe Checkout, or covered by the $9.99 24h Stripe day pass.
- [Personalized practice plan](https://strumly.suedeai.ai/api/v1/practice-plan): 4.99 USDC per call via x402, or $4.99 per call via Stripe Checkout, or covered by the $9.99 24h Stripe day pass.

## Discovery

- [Agentic Commerce manifest](https://strumly.suedeai.ai/.well-known/agentic-commerce.json): ACP v1 manifest with seller info, capabilities, and catalog index.
- [Product catalog](https://strumly.suedeai.ai/api/v1/catalog): full product list with per-product pricing + fulfillment.
- [OpenAPI 3.1 spec](https://strumly.suedeai.ai/openapi.json): every endpoint, request/response schemas, security schemes.
- [OpenAI plugin manifest](https://strumly.suedeai.ai/.well-known/ai-plugin.json): legacy plugin-style manifest.
- [Developer page](https://strumly.suedeai.ai/agents): human-readable docs + copy-paste curl/JS/Python examples.

## Reading — The Signal Chain (book) & signal chain guides

Strumly is also the new home for guitar.solutions' book and guides content
(consolidated here as of 2026-07):

- **Suede IP Registry:** registration is live at https://ip.suedeai.ai on Base
  and Avalanche mainnet. The registry records provenance and issues no licenses.
  Strumly itself exposes no registration, licensing, or rights-settlement tool;
  its rights articles are educational context only.
- [The Signal Chain](https://strumly.suedeai.ai/book): Jason Colapietro's (Johnny Suede) illustrated history of electric guitar tone — amps, effects, a self-taught memoir, and 111 song lessons.
- [Four free lessons](https://strumly.suedeai.ai/book/lessons): Purple Haze, Comfortably Numb, Pride and Joy, Smells Like Teen Spirit.
- [Print the Quiet](https://strumly.suedeai.ai/book/print-the-quiet): nine essays on tone and dynamics.
- [Catalog](https://strumly.suedeai.ai/book/catalog): the full catalog of Jason Colapietro's books, apps, and Suede Labs AI.
- [Guides](https://strumly.suedeai.ai/guides): reference guides — practice methodology and AI-coached practice, engineering-grade signal chain guides (impedance, gain staging, cable capacitance, effects-loop routing), and rights & IP for working musicians.
- [Documentation](https://strumly.suedeai.ai/docs): product docs — what Strumly is, how the AI coach and drill scoring work, practice sessions, the toolkit, accounts & billing, FAQ, troubleshooting.

## Consumer surface (humans)

- [Strumly Coach](https://strumly.suedeai.ai/coach): persistent, multi-turn AI coach (free with a Suede account — one sign-in across all Suede surfaces).
- [Learning path](https://strumly.suedeai.ai/path), [Lessons](https://strumly.suedeai.ai/learn), [Tuner](https://strumly.suedeai.ai/tuner), [Metronome](https://strumly.suedeai.ai/metronome), [Virtual guitar](https://strumly.suedeai.ai/virtual-guitar), [Speed trainer](https://strumly.suedeai.ai/speed-trainer), [Strumming trainer](https://strumly.suedeai.ai/strumming), [Chords](https://strumly.suedeai.ai/chords), [Scales](https://strumly.suedeai.ai/scales), [Transpose](https://strumly.suedeai.ai/transpose), [Songs](https://strumly.suedeai.ai/songs), [Backing tracks](https://strumly.suedeai.ai/backing-tracks), [Ear Trainer](https://strumly.suedeai.ai/ear-trainer), [Looper](https://strumly.suedeai.ai/looper), [Amp Lab](https://strumly.suedeai.ai/amp-lab), [Bench diagnostic](https://strumly.suedeai.ai/bench): free in-browser guitar wedge tools.
- [Circle of fifths](https://strumly.suedeai.ai/circle-of-fifths), [Chords by key](https://strumly.suedeai.ai/keys), [Chord identifier](https://strumly.suedeai.ai/chord-identifier), [Fretboard trainer](https://strumly.suedeai.ai/fretboard-trainer), [Capo calculator](https://strumly.suedeai.ai/capo), [Progression generator](https://strumly.suedeai.ai/progression-generator): free music-theory tools — key signatures, diatonic chords, reverse chord lookup, fretboard drilling, capo math, and progression generation.

## Optional

- [GitHub: Suede-AI](https://github.com/Suede-AI): the Suede Labs AI org. Strumly's own repo is private, so there is no public source link to give you.
- [Live Suede x402 catalog](https://app.suedeai.ai/.well-known/x402.json): the Suede family x402 reference.
- [Contact](mailto:jasoncola1@gmail.com): direct line — feedback shapes v2.