Install in your client

Claude Code

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

Claude Desktop

Open Settings, then Developer, then Edit Config. Paste this in, replace YOUR_KEY (keep the quotes), save, then quit Claude completely and reopen it.

{
  "mcpServers": {
    "thiri": {
      "command": "npx",
      "args": ["-y", "@bluesprincemedia/thiri-mcp"],
      "env": { "THIRI_API_KEY": "YOUR_KEY" }
    }
  }
}

If the file already has an mcpServers block, add the thiri entry inside it with a comma before it. Two mcpServers blocks is the most common broken config.

Claude web and mobile (hosted, no install)

In Claude, open Settings, then Connectors, then Add custom connector. Use the URL below and your key as the bearer token. The hosted server exposes the same tools as the local package and runs on Cloudflare at the edge.

https://mcp.thiri.ai/mcp

Cursor

Cursor → Settings → MCP → Add new global MCP server, or save as .cursor/mcp.json in your project.

{
  "mcpServers": {
    "thiri": {
      "command": "npx",
      "args": ["-y", "@bluesprincemedia/thiri-mcp"],
      "env": { "THIRI_API_KEY": "YOUR_KEY" }
    }
  }
}

VS Code (Copilot agent mode)

{
  "servers": {
    "thiri": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@bluesprincemedia/thiri-mcp"],
      "env": { "THIRI_API_KEY": "YOUR_KEY" }
    }
  }
}

n8n

In n8n go to Settings, then Community Nodes, then Install, and paste the package name. Add a THIRI API credential with your key. The node exposes all five endpoints and works as a tool for n8n AI Agents.

n8n-nodes-thiri

Any language (REST)

Nothing to install. Keep the key in an environment variable and send it as a bearer token.

# .env — never commit this file
THIRI_API_KEY=sk_live_your_key_here

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

Verify the connection

• Claude Desktop: the tools icon in the chat box lists thiri with its tools. If not, you did not quit all the way.
• Claude Code: /mcp shows thiri: connected.
• REST: GET https://chords.thiri.ai/v2/account with your bearer token returns your tier and quota. That is the same call the usage dashboard makes.