# twelveswaras

> twelveswaras is an open-source MCP server for design and media. Name the raaga of Carnatic or Hindustani music and look up scales of 70 raagas. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** Web, API
- **Website:** https://twelveswaras.com
- **Repository:** https://github.com/twelveswaras/twelveswaras
- **MCP Registry name:** io.github.sathya-sankaran/twelveswaras
- **Categories:** design and media, games and play
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://twelveswaras.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "twelveswaras": {
      "url": "https://twelveswaras.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [Hourlore](https://ai-powered.com/mcp/hourlore): Hourlore is a freemium MCP server for design and media.
- [Eikino](https://ai-powered.com/mcp/eikino): Eikino is a freemium MCP server for security.

---
Source: https://ai-powered.com/mcp/twelveswaras
