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.

Project links

Data verified by PyPI on Sep 13, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for Dev_akhil from gravatar.com Dev_akhil

Credits

Author: Eco Policy MCP contributors

GitHub Statistics

Data verified by PyPI on Sep 13, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

MIT License (MIT)

Requires

Python >=3.11

Tags

fastmcp finance gst india mcp model-context-protocol mutual-funds nav nse rbi

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

eco_policy_mcp-0.1.0.tar.gz (114.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

eco_policy_mcp-0.1.0-py3-none-any.whl (27.4 kB view details)

Uploaded Python 3

File details

Details for the file eco_policy_mcp-0.1.0.tar.gz.

File metadata

  • Download URL: eco_policy_mcp-0.1.0.tar.gz
  • Upload date:
  • Size: 114.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for eco_policy_mcp-0.1.0.tar.gz
Algorithm Hash digest
SHA256 41115bc73bc31f486050c89ba69f7ecb59b0550e15e068a00fe0614ba83cf4a7
MD5 2acdc62d6ac8398f829e429c41912d82
BLAKE2b-256 982b74874e038e24a4f5cdda0ca945327b022db735d9f37bbf77861ed91644cc

See more details on using hashes here.

Provenance

The following attestation bundles were made for eco_policy_mcp-0.1.0.tar.gz:

Publisher: publish-pypi.yml on Akhilesh-Chandewar/eco-policy-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file eco_policy_mcp-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: eco_policy_mcp-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 27.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for eco_policy_mcp-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 0fadca8dd673d9852b2a6e646539c20c4ee41e239e36df2098375fb16456d91e
MD5 7466259bbdafb010eef05f9f33032a33
BLAKE2b-256 93bee5f5850595ca3c5e629b22dc90a9480f0d92b9025ad027376b7e31ccbb27

See more details on using hashes here.

Provenance

The following attestation bundles were made for eco_policy_mcp-0.1.0-py3-none-any.whl:

Publisher: publish-pypi.yml on Akhilesh-Chandewar/eco-policy-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page