THIRI Chord Intelligence API

Usage 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? Start with the quickstart. The API reference, MCP setup and limits are in the docs.

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 connector with API key authentication (bearer) 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 a local Csound install.

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.