tallyprime-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| TALLY_URL | No | Where Tally's HTTP server listens. | http://localhost:9000 |
| TALLY_COMPANY | No | Company to query; empty means the active company. | |
| TALLY_TIMEOUT | No | Seconds to wait for Tally. | 60 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
Read-only access to the books in a locally running TallyPrime. Amounts are in the company's base currency. Balances are reported as an absolute amount plus a side ('debit' or 'credit'). Call list_companies first if you are unsure which company is loaded. This server cannot create or change anything in Tally.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_companiesA | List the companies currently loaded in TallyPrime. Also works as a connection check: an error here means Tally is not reachable. |
| list_ledgersA | List ledgers with opening and closing balances. group: restrict to ledgers under this group, including sub-groups (e.g. "Sundry Debtors", "Bank Accounts", "Indirect Expenses"). name_contains: case-insensitive filter on the ledger name. nonzero_only: drop ledgers whose closing balance is zero. limit: maximum ledgers to return (largest closing balances first). company: company name; defaults to the configured or active company. |
| get_vouchersA | Fetch vouchers (transactions) in a date range, oldest first. from_date / to_date: inclusive, YYYY-MM-DD. voucher_type: e.g. "Sales", "Purchase", "Receipt", "Payment", "Journal". party_contains: case-insensitive filter on the party ledger name. limit: maximum vouchers to return. Totals by type always cover the full matching set, so narrow the range or filters if results are truncated. |
| get_outstandingB | Pending bills: what customers owe (receivable) or what is owed to suppliers (payable), with ageing. min_days_outstanding: only bills at least this many days old, counted from the bill date (e.g. 60 for "older than 60 days"). as_of: date to age against, YYYY-MM-DD. Defaults to today. Only covers ledgers that use bill-wise details in Tally. |
| get_trial_balanceB | Trial balance built from ledger closing balances, grouped by each ledger's parent group, with debit and credit totals. 'balanced' is false when total debits and credits differ by more than one rupee, which usually points at an unposted opening-balance difference. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 5 tools
Each tool maps to a distinct reporting concept: companies, ledgers, vouchers, outstanding bills, and trial balance. The only mild overlap is list_ledgers (per-ledger closing balances) versus get_trial_balance (the same balances aggregated by parent group); descriptions clarify the difference, but an agent could occasionally hesitate between them.
All names follow a clean verb_noun pattern (list_companies, list_ledgers, get_vouchers, get_outstanding, get_trial_balance). The list_/get_ split is semantically meaningful rather than inconsistent.
Five tools is well-scoped for a read-only TallyPrime reporting surface; every tool covers a real accounting workflow (connectivity, ledgers, transactions, receivables/payables, trial balance) with no filler.
Core read paths are covered, but the surface stops at trial balance: no P&L, balance sheet, stock/inventory summary, or single-voucher/ledger detail retrieval. Write operations (posting vouchers, creating ledgers) are absent, which may be deliberate but limits agents to reporting only.