{"uid":"cap_4YPWiOD5T3q9U7Rq3HuY3","slug":"music-theory-scale-speller-e44bfb96","name":"Music Theory Scale Speller","description":"Spell a scale or mode on any root: major, minor, modes, harmonic and melodic minor, pentatonic, blues, whole tone.","url":"https://music-theory.x402tookit.com/scale?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["root"],"properties":{"root":{"type":"string","description":"Root note: C, F#, Bb, Eb"},"type":{"type":"string","description":"Scale name (default major): major, natural-minor, dorian, phrygian, lydian, mixolydian, locrian, harmonic-minor, melodic-minor, major-pentatonic, minor-pentatonic, blues, major-blues, whole-tone, phrygian-dominant"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"asOf":{"type":["null","string"]},"root":{"type":["null","string"]},"type":{"type":["null","string"]},"notes":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"aliases":{"type":["array","null"]},"degrees":{"type":["array","null"],"items":{"type":"string"}},"reasons":{"type":["array","null"],"items":{"type":"string"}},"summary":{"type":["null","string"]},"verdict":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"noteCount":{"type":["null","number"]},"disclaimer":{"type":["null","string"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"stepPattern":{"type":["null","string"]},"pitchClasses":{"type":["array","null"],"items":{"type":"number"}},"semitonesFromRoot":{"type":["array","null"],"items":{"type":"number"}},"midiFromRootOctave4":{"type":["array","null"],"items":{"type":"number"}}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_QXtaI3Hlgl4a1ne9QKUhl","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the notes, degrees, semitone intervals, step patterns, MIDI numbers, and pitch classes for any named scale or mode on a given root note.","exampleAgentPrompt":"What are the notes in an F# harmonic minor scale? Give me the degrees, semitone intervals, and step pattern too.","exampleUseCases":[{"title":"Composer building chord progressions","prompt":"I'm writing a piece in D Dorian — can you spell out all the notes, degrees, and semitone pattern so I know what to work with?"},{"title":"Music teacher explaining pentatonics","prompt":"Spell the A minor pentatonic scale for me, including the note names and how many semitones each step jumps."},{"title":"Developer populating a scale reference app","prompt":"Give me the full breakdown of the Eb whole tone scale: notes, MIDI numbers from octave 4, pitch classes, and step pattern."}],"resultDescription":"Returns a structured object with the root note, scale type, an array of note names (e.g. ['C','D','E','F','G','A','B']), scale degrees, semitones from root, step pattern string, pitch classes as integers, MIDI note numbers from octave 4, note count, and any known aliases for the scale.","failureModes":["Missing required 'root' query parameter returns an error","Unrecognized scale type name may return an error or fall back to major","Invalid root note format (e.g. 'H', 'X') may return an error","Payment failure (402) if USDC balance is insufficient or x402 auth is missing"],"whenToPreferThis":"Use this endpoint when you need the canonical spelling of a scale or mode — its note names, degrees, intervals, and MIDI values — for any root. It covers a broad set of scale types including modes, harmonic and melodic minor, pentatonic, blues, and whole tone, making it the right choice for music theory lookups, educational tools, composition assistants, and audio software that needs ground-truth scale data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T13:11:15.254Z","isFirstParty":false,"canonicalSlug":"music-theory-scale-speller-e44bfb96"}