THIRI · MUSIC THEORY INFRASTRUCTURE · MCP & REST
Your agent guesses chords.
THIRI computes them.
Five music-theory tools over MCP and REST: analyze, resolve, voice, reharmonize, conduct. Same question, same right answer, every time. Free key, no card.
MCP is the Model Context Protocol: the standard way to hand a tool to Claude, Cursor or any AI client. REST is a plain HTTPS API.
- Free tier
- 1,000 calls / month
- Time to first answer
- About five minutes
- Runs in
- Claude, Cursor, n8n, your code
claude mcp add thiri --env THIRI_API_KEY=YOUR_KEY -- npx -y @bluesprincemedia/thiri-mcp {
"mcpServers": {
"thiri": {
"command": "npx",
"args": ["-y", "@bluesprincemedia/thiri-mcp"],
"env": { "THIRI_API_KEY": "YOUR_KEY" }
}
}
} curl -s https://chords.thiri.ai/v2/analyze \
-H "Authorization: Bearer YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"chord":"Dm7b5","key":"C"}' {
"symbol": "Dm7b5",
"notes": ["D", "F", "Ab", "C"],
"numeral": "iiø7",
"function": "predominant (borrowed)",
"scales": [{ "name": "locrian", "role": "primary" }, "..."]
} Three pieces. One cable.
YOUR AGENT
Keeps the conversation
Claude, Gemini, Cursor or your own backend handles intent, planning and taste. That part models are good at.
MCP
Is the plug
The standard way to hand a tool to an AI client. Local via npx, or hosted at mcp.thiri.ai/mcp.
THIRI
Knows the changes
Computed from pitch-class sets and a fixed grid of rules. No sampling, no drift: identical input, identical theory-correct output.
Five questions it answers
Full API reference →POST /v2/analyze What is this chord doing here?
Dm7b5 in C → iiø7, predominant (borrowed), Locrian fits.
POST /v2/resolve Which notes, exactly?
C13 → C E G B♭ D A · MIDI 60 64 67 70 74 81 · 261.63 Hz…
POST /v2/voicing How should the piano play it after the last chord?
C13 rootless after Gm7 → E3 A3 B♭3, score 0.51.
POST /v2/reharmonize What else could this progression be?
Gm7 C7 Fmaj7 → Gm7 G♭7 Fmaj7 (tritone sub), plus six more, each explained.
POST /v2/conduct Make it a band.
"4-bar swung loop in F" → harmony, pattern, bass, drums, lead sheet, MIDI.
PLAY
Hear the engine before you read a line of docs
10 instruments run in the browser on the same calls you will make. Each one has a 30-second goal, a few challenges, and a panel that shows what the API returned.
Web Audio · THIRI API
Helix Arpeggiator
A voice-leading arpeggiator with a fat synth, polyphonic harmony, FX and MIDI export.
30 seconds: Pick a progression, press play, drag the helix. Export the MIDI.
Web Audio · Cymatics Physics · React
Meridian Ambient DAW
Five Claude-driven ambient agents compose healing sequences over Web Audio synthesis and Chladni cymatics.
30 seconds: Load a healing preset or toggle steps. Watch sand particles form Chladni nodal lines.
Csound WASM · THIRI API
Conductor
Type a musical direction; THIRI arranges a four-piece band and plays it in the browser.
30 seconds: Type "slow gospel in Bb, 8 bars". Press conduct. Download the MIDI.
IN PRODUCTION
The same engine, inside a pedal's audio callback
Elk Audio · embedded
THIRI VST on the Elk Stomp
A real-time harmonizer with THIRI voicings, ported from the JavaScript engine to C++ and running on Elk's pedal. First place in the Elk Audio challenge at the MUTEK Montréal hackathon, with the measurements to show for it.
Read the case study →
FYLLM · film scoring
Score your AI video with the same engine
FYLLM turns a clip into a composed, rendered cue: THIRI chooses the harmony, Csound plays it, you get a mixed track that fits the picture. From $47 at bluesprincemedia.com.
See FYLLM →
THE PLUGIN
THIRI VST in Ableton Live
The engine also ships as a plugin: a harmonizer that voices what you play with THIRI's rules, in real time, inside your DAW. Four and a half minutes from download to first harmony, on screen.
- VST3 and AU, macOS and Windows
- Chord input from MIDI or from the chart box
- Same voicing engine as the API, pinned by more than 16,000 golden tests
Latest research
All reports and notes →-
Jul 3, 2026 · Lab note
Week 8: One Gold to Rule Them All
Standardized every THIRI surface to the thiri.ai champagne canon — one gold,
-
Jun 21, 2026 · Report
Get Started: Connecting Ableton Live to the THIRI MCP Server
Building a Max4Live MIDI effect routing live MIDI keys to local MCP server instances to auto-generate accompaniment.
-
Jun 20, 2026 · Report
Get Started: BigFrames Predictor: Modeling Classical Chorales
Training predictive machine learning models on classical voice-leading datasets using BigFrames and Python.
The manual
What THIRI is, how it reasons, what we measured
A month of builds and research organised into one book. Public chapters for everyone, more for signed-in developers, and the deep cuts for Builders. Markdown and PDF.
Open the manual →
T.H.I.R.I. BUILDERS
Come into the room
Mondays: the repo show, one open music repo and one THIRI integration built on it start to finish. Thursdays: the Builders call, bring what you are building or what broke. Members get the private repos, the ship logs and the lessons from the Montréal build. Paid API plans are separate, on the keys page.