Skip to content
MCP server

twelveswaras

Name the raaga of Carnatic or Hindustani music and look up scales of 70 raagas

Status and history

Answered our latest tool-list check 21 hours ago with 4 tools. It will be marked verified after 3 successful checks in 7 days.

Pricing
Open source
Platforms
Web, API
Runs
Locally or Remotely
Version
1.1.0
Listing updated
3 days ago

About twelveswaras

twelveswaras is an open-source MCP server for design and media. It can run locally on your machine or as a hosted remote server.

twelveswaras is a free, open-source recognizer that listens to about a minute of Carnatic or Hindustani music and names the raaga. It returns the top three guesses with calibrated confidence, the tonic (Sa) it detected, and a short note on how to hear that raaga yourself. It knows 70 raagas, 40 Carnatic and 30 Hindustani.

It works best with a tanpura or shruti-box drone, because the drone fixes the tonic and every note is then heard relative to it. It needs at least 30 seconds of audio before reading anything. Recordings are not stored. If the music is outside the 70 raagas it says it is unsure and shows its closest guesses. Heavy orchestration, chords or songs that move between raagas make it less reliable, and the README calls Hindustani a preview with no real-world benchmark yet.

The MCP server exposes raaga identification and scale lookups to assistants. The project is non-commercial and stewarded in its own GitHub organisation.

Install

Run in a terminal

claude mcp add --transport http twelveswaras https://twelveswaras.com/mcp

Add to Settings → Connectors → Add custom connector

https://twelveswaras.com/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "twelveswaras": {
      "url": "https://twelveswaras.com/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "twelveswaras": {
      "type": "http",
      "url": "https://twelveswaras.com/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "twelveswaras": {
      "serverUrl": "https://twelveswaras.com/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "twelveswaras": {
      "type": "http",
      "url": "https://twelveswaras.com/mcp"
    }
  }
}

Tools this server provides (4)

Read directly from the server.

find_raaga
Look up a raaga by name, in any spelling (with or without diacritics, "raga"/"ragam"/"raag"). Returns its scale, parent, notes, key notes, songs, what it is confused with, and its page.
raagas_with_notes
Find the raagas that use a set of notes: those whose scale is exactly these notes, and those whose notes include them. Carnatic labels (S R1 R2 G2 G3 M1 M2 P D1 D2 N2 N3) or Hindustani letters (S r R g G m M P d D n N: lowercase komal, M tivra).
list_raagas
The 70 raagas twelveswaras knows (40 Carnatic, 30 Hindustani), with their parent and page.
identify_raaga
Name the raaga in a recording of Carnatic or Hindustani music at a public http(s) URL (mp3, wav, m4a, ogg, webm; up to 25 MB). Returns the top three with confidence, the tonic (Sa) it heard, and each raaga's page. Best with a minute or more and a drone. The recording is not stored.

What it does

Raaga recognition
Names the raaga from about a minute of audio.
Top three with confidence
Shows runners-up and the detected tonic.
Drone-based tonic
Finds Sa from a tanpura or shruti box.
70 raagas
40 Carnatic and 30 Hindustani.
No stored recordings
Audio is analysed and discarded.
Learn to hear it
Includes a note on how to recognise each raaga.

Good for

  • Identify the raaga of a concert recording
  • Look up the scale and notes of a raaga
  • Learn to hear a raaga by ear
  • Check a practice recording for the raaga it resembles

Pricing

Open source

Free, no sign-up

Prices change. Check twelveswaras.com before you buy.

twelveswaras FAQ

How long a recording does it need?

At least 30 seconds, with about a minute working best.

Does it keep my audio?

No. The site says recordings are never stored.

Does it work for film songs?

Sometimes, when the melody stays in one raaga; heavy orchestration makes it less reliable.

Is it free?

Yes, free, open source and with no sign-up.

Is twelveswaras free?

Yes. twelveswaras is open source, so you can use and self-host it for free.

How do I add twelveswaras to Claude Code?

Run this command in your terminal: claude mcp add --transport http twelveswaras https://twelveswaras.com/mcp

What are the best alternatives to twelveswaras?

The closest alternatives to twelveswaras are HyperFrames by HeyGen, ffmpeg-skill, AvatarSay — Fictional Character & Talking Video MCP, ChartAnt and VfxSmith.

Alternatives to twelveswaras

  1. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  2. ffmpeg-skill

    MCP server

    Local FFmpeg video and audio editing tools for coding agents over MCP

    Runs locally
    • Open source
    • 6.9K GitHub stars
    • Design and media
  3. ChartAnt

    MCP server

    Remote MCP server returning charts, maps and dashboards as hosted PNG links

    • 51 tools
    • Remote
    • Freemium
    • Design and media
  4. VfxSmith

    MCP server

    Search, generate, refine and export pixel art game effects from Claude Code or Codex

    Not checked yet
    • Remote
    • Freemium
    • Design and media
  5. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media