# 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 [facilitator.payai.network](https://facilitator.payai.network/supported) by default.
- **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.

## Consumer surface (humans)

- [Strumly Coach](https://strumly.suedeai.ai/coach): persistent, multi-turn AI coach (Clerk-auth, free).
- [Tuner](https://strumly.suedeai.ai/tuner), [Metronome](https://strumly.suedeai.ai/metronome), [Chords](https://strumly.suedeai.ai/chords), [Scales](https://strumly.suedeai.ai/scales), [Songs](https://strumly.suedeai.ai/songs), [Ear Trainer](https://strumly.suedeai.ai/ear-trainer): free in-browser guitar wedge tools.

## Optional

- [GitHub: Suede-AI/strumly](https://github.com/Suede-AI/strumly): full source.
- [GitHub: Suede-AI/suede-x402-acp](https://github.com/Suede-AI/suede-x402-acp): the Suede family x402 reference.
- [Contact](mailto:jasoncola1@gmail.com): direct line — feedback shapes v2.