Tabla Focus

TablaFocusMCP

Reliable tabla guidance for MCP-compatible AI assistants

TablaFocusMCP gives assistants a structured interface for glossary lookup, taal guidance, composition design and validation, weekly practice planning, and certification preparation. Instead of improvising on incomplete context, clients call deterministic tools backed by curated Tabla Focus datasets.

Status: live on npm (tablafocus-mcp) and listed on the official MCP Registry.

Last verified: March 4, 2026

GitHub Reponpm Package

Get started in 30 seconds

  1. Run directly from npm

    npx -y tablafocus-mcp@latest

  2. Verify what latest resolves to

    npm view tablafocus-mcp version dist-tags --json

  3. Add in Codex CLI

    codex mcp add tablafocus -- npx -y tablafocus-mcp@latest

  4. Add in Claude Code

    claude mcp add -s user tablafocus -- npx -y tablafocus-mcp@latest

  5. JSON-based MCP clients (Claude Desktop, Cline, VS Code, Cursor)

    {
  "mcpServers": {
    "tablafocus": {
      "command": "npx",
      "args": ["-y", "tablafocus-mcp@latest"]
    }
  }
}

  6. Claude Desktop fallback (macOS PATH issues)

    {
  "mcpServers": {
    "tablafocus": {
      "command": "/opt/homebrew/bin/npx",
      "args": ["-y", "tablafocus-mcp@latest"]
    }
  }
}

Core tools

ToolUse caseExample input
glossary_lookupFind clear tabla term definitions quickly{"term":"sam","category":"rhythm","limit":3}
taal_catalogList taals or fetch one taal in detail{"taal_id":"teental"}
compose_builderGenerate structurally valid tihai/tukra/chakradhar scaffolds{"taal":"teental","form":"tihai","jati":"chatusra","cycles":1}
composition_validatorValidate composition structure before practice{"taal":"jhaptal","form":"tukra","jati":"tisra","cycles":2,"composition_input":"Dha - Ti Re Ki Ta ..."}
practice_coachCreate weekly riyaz plan from goals and availability{"goals":["sam landing","clarity in jhaptal"],"availability":{"daily_minutes":30,"days_per_week":5}}
assessment_builderGenerate practice quiz or certification mock{"mode":"practice_quiz","count":10,"taal":"teental"}
certification_catalogInspect board and level paths for exam prep{"board":"ABGMVM","certification_level":"Madhyama"}

Trust, provenance, and support

Project standards

  • MIT license and transparent changelog.
  • Documented data provenance and licensing.
  • CI checks for lint, tests, build, and packaged startup smoke test.

FAQ

Is TablaFocusMCP publicly available right now?

Yes. It is live on npm as tablafocus-mcp and listed in the official MCP Registry. Use npx -y tablafocus-mcp@latest and verify the current dist-tag with npm view tablafocus-mcp version dist-tags --json.

Does this require private Tabla Focus account data?

No. The MCP server works with bundled datasets by default and does not require your private account data to run.

Can I run it with my own datasets?

Yes. Set TABLA_MCP_DATA_DIR and TABLA_MCP_CURATED_DATA_DIR to absolute paths in your MCP client configuration.

Which clients can use this MCP server?

Any MCP-compatible client that can run npx commands, including Codex CLI, Claude Code, Claude Desktop, Cursor, Cline, and VS Code Copilot MCP setups.

Why does Claude Desktop sometimes fail to start it?

On some macOS setups, Claude Desktop cannot find npx in PATH. Use /opt/homebrew/bin/npx as the command in your JSON config.

Read DocumentationContact Support