Agent Examples

Copy-paste tasks and stable calls for agents that need to discover, call, verify, and compose with Agent Pitch Map.

Agent guide llms.txt llms-full.txt OpenAPI Health

Melody to first-position guitar route

Use Agent Pitch Map to convert C4 D4 E4 G4 into a first-position guitar route.

/api/route?notes=C4,D4,E4,G4&root=C&scale=major&position=first

Ranked string/fret route, movement proof, tab events, ASCII tab, and share URLs.

Piano note to guitar coordinates

Where does D4 appear on standard guitar, and which other D notes are nearby?

/api/map?note=D4&root=C&scale=major&piano=49-key

Exact pitch positions, same-note-name positions, piano key, frequency, and theory membership.

Chord voicing selection

Find three C major voicings playable between frets 0-5.

/api/chord?root=C&chord=major&limit=3

Playable voicings with interval labels, optimization cost, and chord-tone proof.

Scale and theory explanation

Explain why G is the fifth of C lydian and show playable guitar anchors.

/api/scale?root=C&scale=lydian&note=G2

Rooted scale degrees, selected-note membership, characteristic tones, and guitar anchors.

Structured events to ASCII tab

Generate ASCII tab for a C major arpeggio from structured note events.

/api/tab

ASCII tab, canonical ProjectState, MIDI/string-fret proof, and compact workbench URL.

Chord resolution with proof

Find the top three G7 to Cmaj7 guitar resolutions and explain why the first is best.

/api/voice-leading?fromRoot=G&fromChord=dominant7&toRoot=C&toChord=major7&limit=3

Three ranked transitions with ids, scores, source/target frets, proof fields, tab events, and per-rank workbench URLs.

POST /api/tab Example

{
  "title": "C major arpeggio",
  "tuning": "standard",
  "tempo": 96,
  "timeSignature": "4/4",
  "events": [
    { "note": "C3", "string": 5, "fret": 3, "beat": 1 },
    { "note": "E3", "string": 4, "fret": 2, "beat": 2 },
    { "note": "G3", "string": 3, "fret": 0, "beat": 3 },
    { "note": "C4", "string": 2, "fret": 1, "beat": 4 }
  ]
}