mcp-connector

Read-only TallyPrime MCP. Cursor asks accounting questions; this server fetches live company data over Tally XML Export. Nothing is created, altered, or deleted in Tally.

Flow:

Cursor → Streamable HTTP MCP → Node → TallyPrime

Setup

Copy .env.example to .env next to tally.js and server.js:

TALLY_URL=http://192.168.29.149:9000
HOST=0.0.0.0
PORT=3000

TALLY_URL is the TallyPrime HTTP port on the Tally PC (9000). Do not expose that port to the internet.

npm install
node server.js

Health: GET http://127.0.0.1:3000/health
MCP: POST http://127.0.0.1:3000/mcp

STDIO (optional): node server.js --stdio

Tally connectivity check: node test-tally.js

Remote Cursor

On another PC on the LAN, add this MCP server (this machine’s LAN IP is 192.168.29.47):

{
  "mcpServers": {
    "tally": {
      "url": "http://192.168.29.47:3000/mcp"
    }
  }
}

Allow inbound TCP 3000 on this PC. Keep Tally port 9000 local.

Tools

Four tools, not one per report:

Tool	Purpose
query_tally	Companies, ledgers, groups, customers, suppliers, cash, bank, stock, GST, vouchers, outstanding
tally_report	Profit & loss, balance sheet, trial balance, registers, GST and stock reports
tally_describe	Catalog of resources, filters, and example questions
get_ledgers	Original smoke test: Tally Collection List of Ledgers, raw XML

Dates should match the loaded Tally financial year. Pass financialYear such as 26-27, or explicit fromDate / toDate as YYYY-MM-DD.

Layout

mcp-connector/
  .env
  tally.js          Tally HTTP client (Export POST)
  server.js         Streamable HTTP MCP
  test-tally.js     Connectivity check
  lib/
    mcp-server.js   Tool registration
    query.js        Read-only query layer
    catalog.js      Resources and reports
    dates.js        Dates and Indian FY
    parse.js        Tally XML → JSON
    xml-build.js    Read-only Export XML