# HARMONY MAP

> Chords as a living map: nine diagrams of the same harmony — chord tree, extension star, augmented orbits, Tonnetz and more — each showing where you are, what you can reach and what you have played. Multi-track looping songs, 3D note-cube, AI, EN/FI. This document tells an agent how to call it.

## Installation

Nothing to install. This app runs on an AIMEAT node and is reachable two ways.

Over MCP — attach any MCP-capable client to `https://aimeat.io/v1/mcp` (OAuth 2.1), then:

```
    owner:  happydude500001
    app_id: harmony-map.html        (not "harmony-map")

aimeat_app_tools_get   { owner: "happydude500001", app_id: "harmony-map.html" }
```

Over HTTP — get an identity through the RFC 8628 device flow described at `https://aimeat.io/auth.md`, then
call the endpoints in `https://aimeat.io/v1/spec`.

## Configuration

- **Scopes.** The owner approves a scope set when they approve your agent. A call outside it
  answers 403 naming the scope, never an empty result.
- **Payment.** Priced tools answer 402 with the terms attached until a checkout for them completes;
  completing the checkout IS the invocation.
- **Schemas.** Every tool carries a full input and output schema in the manifest, so nothing has to
  be inferred from the app source: `https://aimeat.io/v1/apps/happydude500001/harmony-map.html/webmcp`

## Usage

```
aimeat_app_tool_invoke {
  owner: "happydude500001",
  app:   "harmony-map.html",
  tool:  "search",
  input: { ... }
}
```

This app publishes no priced tools.

## What this app does

HARMONY MAP

# HARMONY MAP

see harmony, build a session
EN FI

## How it works

Chords are nodes; arrows are how harmony moves. Follow the arrows to build progressions that sound good.

Arrow colours: red = resolution (play in this direction), blue = reversible, dotted gold = relative, green = parallel key, dashed red = secondary dominant.

Demo songs

Load & play

Key

Mode

Diagram

Chords
Triads 7ths 9ths (jazz)

Hear the key

Secondary dominants (V7/x)
Borrowed chords (parallel minor)
Voice leading

Map edits: Track A

Tap a chord to add it to the selected track. Switch mode to recolour the whole map with a new feeling (same theory). Turn on secondary dominants and borrowed chords for extra colour.

## Keyboard

Green keys are the notes of the key/mode. Red keys are the selected chord's tones. Tap keys to try a melody.

## Editing

Chips: tap the beats badge to hold a chord longer. Grid: pick a chord on the map, then paint exactly which beats it plays on.

Chips
Grid (beats)

Preview track
Add rest
Undo
Clear track

## SESSIO

One session shares key, mode and tempo, so everything fits. Each scene (verse, chorus, ...) has its own four tracks; play the scene as a loop, then arrange scenes into a song below.

Play scene
Tempo

100 BPM

Rename
New scene
Duplicate
Delete

Drums
Off Pop Rock Funk Disco Hip-hop Jazz March Ballad

Auto bass (from chord roots)

## Arrange (song)

Order your scenes into a song that plays through once (or on repeat). Set how many times each scene repeats.

Add

Add to song
Play song
Loop song

## Save this song

Keep whole songs (all scenes, tracks, drums, tempo) in your AIMEAT account and reopen them anytime.

Save

Sign in above to save and reopen your songs.

## Ask your own AI

Two ways to work with AI on your song.

### 1. Copy to any AI chat (free, no sign-in)

Build a prompt carrying your whole song as JSON. Paste it into any AI chat (ChatGPT, Claude, ...), tell it what to change or to write a whole song, then paste its JSON reply back below and apply.

Build the prompt

Copy prompt

Paste the AI's JSON reply here to update your song:

Apply JSON

### 2. In-app AI (uses your own key, acts instantly)

These act on your song right away using your own OpenRouter key from AIMEAT settings. No copy-paste.

Suggest next chord
Reharmonize track
Name the song

## Share & export

Copy a share link (the whole song travels inside the link, no sign-in needed), copy the chords as text, or download a MIDI file of the current scene.

Copy share link
Copy chords (text)
Download MIDI

## Learn & play

Hear the classic progressions, then test your ear.

### Guided lessons

### Ear training

Listen, then pick the progression you heard.

New round
Replay

Inspired by Brian Calli's Illustrated Harmony, a visual language for understanding music. [briancallimusic.com](https://briancallimusic.com)

AIMEAT is a digital agency where people, AI, agents and apps work under one roof and everyone owns their own data.

## Agent affordances

- Act — WebMCP tool listing for this app: https://aimeat.io/v1/apps/happydude500001/harmony-map.html/webmcp
- Learn — skills bound to this app: https://aimeat.io/v1/apps/happydude500001/harmony-map.html/skills
- App catalog on this node (this app: happydude500001/harmony-map.html): https://aimeat.io/app-catalog.html
- Register an agent on this node (RFC 8628 device flow): https://aimeat.io/auth.md


## Where the rest is

- [llms.txt](https://harmony-map.apps.aimeat.io/llms.txt) · [Site map](https://harmony-map.apps.aimeat.io/sitemap.md)
- [Node manual](https://aimeat.io/llms-full.txt) · [Node glossary](https://aimeat.io/v1/glossary.md) · [OpenAPI](https://aimeat.io/v1/spec)