eco-policy-mcp
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.
Install & run
# Run with any MCP client via uvx (once published):
uvx eco-policy-mcp
# From a clone:
uv sync
uv 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
| Domain | Tool | What it does |
|---|---|---|
| GST | gst_split |
CGST/SGST vs IGST breakup for an amount + slab rate |
| GST | gst_from_inclusive |
Extract GST from a tax-inclusive amount |
| GST | gst_reverse_charge |
Reverse-charge (RCM) tax payable |
| GST | gstin_validate |
GSTIN mod-36 checksum validation + state code |
| Income tax | income_tax_new_regime |
FY 2026-27 new-regime estimate (std deduction + 87A rebate) |
| Income tax | income_tax_old_regime |
Old-regime estimate (80C, age-based exemption) |
| Income tax | income_tax_compare_regimes |
New vs old with recommendation |
| Mutual funds | mf_search_schemes |
Search all AMFI schemes by name |
| Mutual funds | mf_get_nav |
Latest NAV for a scheme code |
| Mutual funds | mf_get_nav_history |
Historical NAVs between dates |
| Mutual funds | mf_compute_returns |
Absolute return + CAGR between dates |
| Mutual funds | mf_sip_calculator |
SIP simulation on real NAVs with XIRR |
| RBI | rbi_get_policy_rates |
Repo, SDF, MSF, bank rate, CRR, SLR (as-of dated) |
| NSE | nse_get_quote |
Equity quote (unofficial public endpoint) |
| NSE | nse_get_index_quote |
Index snapshot (NIFTY 50, BANK, IT...) |
| NSE | nse_get_historical |
Daily OHLCV (max 1y window) |
| Server | eco_server_info |
Version, 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
uv sync --dev # install with dev tools
uv run pytest # run the test suite (no network needed)
License
MIT — see LICENSE.
1 maintainer
Metadata
1 maintainer
Release files for eco-policy-mcp 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| eco_policy_mcp-0.1.0.tar.gz | 114.7 kB | With provenance | Details for eco_policy_mcp-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| eco_policy_mcp-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for eco_policy_mcp-0.1.0-py3-none-any.whl |
Total release size: 142.2 kB
Release files / eco_policy_mcp-0.1.0.tar.gz
| Download URL | eco_policy_mcp-0.1.0.tar.gz |
|---|---|
| Size | 114.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
41115bc73bc31f486050c89ba69f7ecb59b0550e15e068a00fe0614ba83cf4a7
|
|
BLAKE2b-256 checksum How to use checksums |
982b74874e038e24a4f5cdda0ca945327b022db735d9f37bbf77861ed91644cc
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 13, 2026.
Transparency logRelease files / eco_policy_mcp-0.1.0-py3-none-any.whl
| Download URL | eco_policy_mcp-0.1.0-py3-none-any.whl |
|---|---|
| Size | 27.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
0fadca8dd673d9852b2a6e646539c20c4ee41e239e36df2098375fb16456d91e
|
|
BLAKE2b-256 checksum How to use checksums |
93bee5f5850595ca3c5e629b22dc90a9480f0d92b9025ad027376b7e31ccbb27
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 13, 2026.
Transparency logSecurity for eco-policy-mcp 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
All 2 files in this release have been uploaded with provenance metadata.
Attestation for eco_policy_mcp-0.1.0.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 13, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
