THIRI Chord Intelligence API

Developer Dashboard

Paste your API key to view your tier, quota usage, and recent activity. Your key is sent only to chords.thiri.ai from your browser — it never touches this site's server.

Need to create, rotate, or revoke keys? Go to your API keys.

New here, or want the full endpoints + MCP setup? This page is your live usage dashboard — the complete API reference & integration guide lives on thiri.ai.

Studio Rack

Open the rack — full instrument overview

Five lanes with scroll-linked copy, per-module MCP prove actions, and install snippet.

Live Studio Proof

See MCP + API work in the Band dashboard

End-to-end demo with API health ping, module-to-tool map, and call log. Local: npm run dev:studio then open /band.

Endpoints

All POST to https://chords.thiri.ai · Authorization: Bearer YOUR_KEY

/v2/analyzechord → root, quality, intervals, roman numeral, function

/v2/resolvechord → spelled notes, frequencies, MIDI, scale recs

/v2/voicinginstrument-ready voicings + voice-leading score

/v2/reharmonizeprogression → 8 reharmonization techniques

/v2/conductprompt → 4-lane band arrangement + MIDI

Quickstart

curl -s https://chords.thiri.ai/v2/analyze \
  -H "Authorization: Bearer YOUR_KEY" -H "Content-Type: application/json" \
  -d '{"chord":"Dm7b5","key":"C"}'

Use it in Claude / Cursor (Local MCP)

Run the THIRI MCP server locally on your machine.

claude mcp add thiri --env THIRI_API_KEY=YOUR_KEY -- npx -y @bluesprincemedia/thiri-mcp

Hosted MCP Endpoint (Claude & Cursor)

Use THIRI's hosted MCP server on cloud-based AI clients.

Base Schema URL

https://mcp.thiri.ai/mcp

Authentication

Configure the Action/Connector with **API Key** authentication (Bearer type) using your developer key: YOUR_KEY

Automate with n8n

Add THIRI as a node in any n8n workflow — including as a tool for n8n AI Agents.

Install

In n8n: Settings → Community Nodes → Install, then paste the package name:

n8n-nodes-thiri

Credential

Add a THIRI API credential with your sk_live_… key. The node exposes all five endpoints (analyze, resolve, voicing, reharmonize, conduct) and works as an AI Agent tool.

npm package ↗

Csound agent loop (dual MCP)

Hosted mcp.thiri.ai = theory + conduct lanes. WAV render needs local thiri-conductor-mcp and Csound CLI.

Agent recipes → Conductor MCP Research Lab

See it live

Playgrounds built on this same API.

All instruments — built with the THIRI API →

Keys can't be recovered — if you've lost yours, go to your API keys to rotate or revoke them.