Eco Policy MCP

io.github.Akhilesh-ChandewarPublished by GitHub account Akhilesh-Chandewarv0.1.0Updated Oct 24, 2026

Indian finance MCP server: mutual-fund NAVs, GST & income-tax tools, RBI rates, NSE quotes.

VerifiedSTDIODesktop onlyFinanceData & Analytics

Overview

AI-generated overview

Local MCP server for Indian finance data: mutual-fund NAVs, GST and income-tax calculators, RBI policy rates and NSE quotes, with source provenance.

What you can do
  • Calculate GST splits, inclusive amounts, reverse charge and validate GSTINs
  • Estimate income tax under new and old regimes and compare them
  • Search AMFI schemes, fetch latest and historical NAVs, compute returns and simulate SIPs with XIRR
  • Read RBI policy rates and NSE equity, index and historical OHLCV quotes
  • Inspect server version, tool list and cache health, plus freshness resources and prompts
When to use it
Useful when an assistant needs Indian tax, mutual-fund or market figures with citable sources, for example GST invoice breakdowns, regime comparisons, NAV lookups or SIP projections.
Requirements
Runs locally over stdio, typically via uvx from PyPI (Python/uv toolchain). No authentication or API keys declared. Network access to AMFI, mfapi.in, RBI and NSE endpoints is needed. Optional ECO_ environment variables tune caching, timeouts and base URLs.
Before you install
NSE data comes from unofficial public endpoints and may be delayed or break; RBI figures are a curated snapshot to verify at the source. Tax results are estimators excluding surcharge and capital-gains special rates, not advice. Requests go to third-party data services.

Installation

In SourceWeft

  1. Open Eco Policy MCP in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

eco-policy-mcp

[PyPI] [MCP Registry] [License: MIT] [GitHub release]

An MCP server for Indian finance data — mutual-fund NAVs, GST & income-tax calculators, RBI policy rates and NSE market data — built for any MCP client (Claude, Cursor, Gemini CLI, VS Code, Cline, custom agents...), not just one.

Every successful response carries a provenance block (source, as_of, reference), so AI agents can cite where each number came from instead of hallucinating it.

Links

Install & run

bash
# Run with any MCP client via uvx (installs automatically from PyPI):uvx eco-policy-mcp
# Or pin the version:uvx [email protected]
# From a clone:uv syncuv run eco-policy-mcp            # stdio (default, local clients)uv run eco-policy-mcp --http --port 8000   # streamable-HTTP (remote clients)

See examples/ for client configs (Claude Desktop, Cursor, Gemini CLI, VS Code, remote HTTP).

Tools

DomainToolWhat it does
GSTgst_splitCGST/SGST vs IGST breakup for an amount + slab rate
GSTgst_from_inclusiveExtract GST from a tax-inclusive amount
GSTgst_reverse_chargeReverse-charge (RCM) tax payable
GSTgstin_validateGSTIN mod-36 checksum validation + state code
Income taxincome_tax_new_regimeFY 2026-27 new-regime estimate (std deduction + 87A rebate)
Income taxincome_tax_old_regimeOld-regime estimate (80C, age-based exemption)
Income taxincome_tax_compare_regimesNew vs old with recommendation
Mutual fundsmf_search_schemesSearch all AMFI schemes by name
Mutual fundsmf_get_navLatest NAV for a scheme code
Mutual fundsmf_get_nav_historyHistorical NAVs between dates
Mutual fundsmf_compute_returnsAbsolute return + CAGR between dates
Mutual fundsmf_sip_calculatorSIP simulation on real NAVs with XIRR
RBIrbi_get_policy_ratesRepo, SDF, MSF, bank rate, CRR, SLR (as-of dated)
NSEnse_get_quoteEquity quote (unofficial public endpoint)
NSEnse_get_index_quoteIndex snapshot (NIFTY 50, BANK, IT...)
NSEnse_get_historicalDaily OHLCV (max 1y window)
Servereco_server_infoVersion, tool list, cache health

Also exposes resources (eco-policy://amfi/freshness, eco-policy://rbi/policy-rates) and prompts (compare_mutual_funds, gst_invoice_breakup).

Data sources & disclaimers

  • AMFI (NAVAll.txt) — official daily NAV dump; parsed and cached 6h.
  • mfapi.in — community mirror of AMFI's NAV archive (history, returns, SIP).
  • RBI — curated policy-rate snapshot stamped with its as-of date; verify at rbi.org.in before acting on it.
  • NSE — unofficial public endpoints; quotes may be delayed and endpoints can change without notice. Failures return structured errors, never raw HTML.
  • Tax computations are estimators (excludes surcharge, capital-gains special rates); nothing here is investment or tax advice.

Configuration

All settings via env vars (prefix ECO_): ECO_TTL_AMFI_INDEX, ECO_TTL_NSE_QUOTE, ECO_NSE_MIN_INTERVAL, ECO_HTTP_TIMEOUT, ECO_MFAPI_BASE, ECO_NSE_BASE, ECO_AMFI_NAV_URL, ... — see src/eco_policy_mcp/config.py.

Development

bash
uv sync --dev          # install with dev toolsuv run pytest          # run the test suite (no network needed)

License

MIT — see LICENSE.

Source: README.md at commit 6f09e76

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.0LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts