MCP-India-Stack
mcp
Gecti
Health Gecti
- License — License: MIT
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Community trust — 19 GitHub stars
Code Gecti
- Code scan — Scanned 12 files during light audit, no dangerous patterns found
Permissions Gecti
- Permissions — No dangerous permissions requested
Purpose
This MCP server provides AI agents with tools to validate, decode, and calculate Indian financial and government identifiers—such as GSTIN, PAN, IFSC, and Aadhaar—completely offline and without requiring authentication keys.
Security Assessment
Overall Risk: Low. The server does not request dangerous system permissions or execute shell commands. No hardcoded secrets or dangerous code patterns were found in the 12 scanned files. It functions offline-first, meaning it relies on local algorithms (like checksum verifications) and embedded datasets rather than making live, external network requests to government databases. While it processes highly sensitive identifiers (Aadhaar, PAN), it only validates their mathematical structure and format rather than querying PII.
Quality Assessment
The project demonstrates strong health indicators. It is licensed under the permissive MIT license, making it highly accessible for integration. Maintenance is excellent, with repository activity as recent as today. It features a comprehensive README, CI/CD testing pipelines, and is actively packaged on PyPI. While the community is currently small (19 GitHub stars), the foundation is solid, professional, and well-documented.
Verdict
Safe to use.
This MCP server provides AI agents with tools to validate, decode, and calculate Indian financial and government identifiers—such as GSTIN, PAN, IFSC, and Aadhaar—completely offline and without requiring authentication keys.
Security Assessment
Overall Risk: Low. The server does not request dangerous system permissions or execute shell commands. No hardcoded secrets or dangerous code patterns were found in the 12 scanned files. It functions offline-first, meaning it relies on local algorithms (like checksum verifications) and embedded datasets rather than making live, external network requests to government databases. While it processes highly sensitive identifiers (Aadhaar, PAN), it only validates their mathematical structure and format rather than querying PII.
Quality Assessment
The project demonstrates strong health indicators. It is licensed under the permissive MIT license, making it highly accessible for integration. Maintenance is excellent, with repository activity as recent as today. It features a comprehensive README, CI/CD testing pipelines, and is actively packaged on PyPI. While the community is currently small (19 GitHub stars), the foundation is solid, professional, and well-documented.
Verdict
Safe to use.
MCP server for Indian APIs — GSTIN, IFSC, PAN, UPI, pincode, HSN/SAC. Zero auth. Offline-first. For AI agents.
README.md
mcp-india-stack
MCP server exposing Indian financial and government APIs for AI agents. Zero auth. Offline-first.
Install
pip install mcp-india-stack
Run
mcp-india-stack
or
python -m mcp_india_stack
Tools
Lookup Tools
lookup_ifsc— Bank branch details from IFSC codelookup_pincode— India pincode details and post officeslookup_hsn_code— HSN/SAC code lookup by code or keyworddecode_state_code— GST state code metadata
Validation Tools
validate_gstin— GSTIN structure and checksumvalidate_pan— PAN format and entity type decodevalidate_upi_vpa— UPI VPA structure and provider decodevalidate_aadhaar— Aadhaar number with Verhoeff checksumvalidate_voter_id— Voter ID (EPIC) format with legacy detectionvalidate_driving_license— DL format with state/RTO/year decodevalidate_passport— Indian passport number formatvalidate_cin— Company Identification Number with full field decodevalidate_din— Director Identification Number format
Tax Calculators (FY2025-26)
calculate_income_tax— Old vs new regime comparison with surcharge, rebate, cesscalculate_tds— TDS rate lookup and computation for 12+ sectionscalculate_gst— GST breakdown (CGST/SGST/IGST/cess)calculate_surcharge— Surcharge and marginal relief calculator
Additional Tools
bulk_validate_gstin— Parallel GSTIN batch validationbulk_validate_pan— Parallel PAN batch validationbulk_validate_ifsc— Parallel IFSC batch validationvalidate_fssai— FSSAI license number validation and decodecalculate_hra_exemption— HRA exemption calculator for salary planningcalculate_capital_gains— Capital gains tax helpercalculate_advance_tax— Advance tax estimatorlookup_bbps_biller— BBPS biller directory lookupdecode_pan_type— Decode PAN entity type from the 4th characterlookup_bank— Basic bank master lookup by name or codevalidate_epf_code— EPF establishment code validatorvalidate_esic_code— ESIC employer code validatordecode_digilocker_uri— DigiLocker URI decoder and validator mapper
Prompt Workflows
vendor_kyc— GSTIN, PAN, and IFSC verification workflowsalary_planner— Income, HRA, and take-home salary workflowinvoice_audit— GSTIN, HSN, and GST rate audit workflow
Resources
india://status— Version, DB connectivity, and runtime flagsindia://changelog— Structured changelog resource
Data Freshness
Datasets are bundled with the package for offline-first operation. An optional auto-update mechanism fetches the latest versions from jsDelivr CDN in the background.
- Auto-update is non-blocking — stale data triggers a background refresh; the current request uses existing data.
- Opt out — set
MCP_INDIA_STACK_NO_AUTO_UPDATE=1environment variable to disable all update checks. - Manual refresh — run
mcp-india-stack --refresh-allto synchronously refresh all datasets from CDN. - Cache location — platform-specific via
platformdirs(e.g.,~/.cache/mcp-india-stackon Linux).
Bundled Data Size
This package bundles static datasets for offline-first workflows.
- IFSC dataset (Razorpay releases)
- India pincode dataset (GeoNames IN postal dump, CC-BY)
- HSN/SAC master (GST tutorial workbook transformed to CSV)
- State codes and curated UPI handles
Expected install footprint includes approximately 10-11MB compressed static data.
Limitations
- GSTIN validation checks format and checksum, not active GSTN status.
- PAN validation is structural; PAN check character is not publicly algorithmic.
- HSN/SAC rates are static references and may vary by conditions/notifications.
- All tax calculations are estimates for FY2025-26. Actual liability may differ — consult a CA.
- Aadhaar, Voter ID, DL, Passport, CIN, DIN validators are format-only — they do not verify active status with issuing authorities.
Legal and Attribution
See NOTICES for dataset attribution and licensing details.
Launch Notes
This repository is release-ready for GitHub launch with:
0.3.0package metadata and changelog coverage- A complete MCP server-card under
docs/.well-known/mcp/server-card.json - Local setup and publishing steps in
SETUP.md - Contribution guidance and versioning policy in
CONTRIBUTING.md
Yorumlar (0)
Yorum birakmak icin giris yap.
Yorum birakSonuc bulunamadi