india-pincode-ifsc-mcp
Looks up and searches Indian bank branch data from Razorpay's open IFSC dataset: bulk IFSC validation (malformed and unknown codes bucketed separately), branch details including bank, branch, address, city, district, state, MICR, SWIFT, supported payment services (NEFT, RTGS, IMPS, UPI) and the PIN code embedded in the address, branch search filtered by bank code or well-known bank name, city and branch name with paging, and a list of about 45 recognised 4-letter bank codes. Optionally cross-checks a branch's address PIN code against India Post records.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@india-pincode-ifsc-mcp look up PIN code 560001 and show its post offices"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
india-pincode-ifsc-mcp
A Model Context Protocol server for two free public Indian reference datasets: PIN codes and post offices from India Post (via postalpincode.in), and bank branches and IFSC codes from the open Razorpay IFSC dataset. It needs no API key and is read-only.
The tools are shaped around common jobs rather than one tool per endpoint: bulk validation with malformed and unknown codes sorted into separate buckets (malformed ones are rejected locally, without a request), compact post-office lists, bank-name resolution ("SBI", "HDFC Bank") for branch search with paging, and an optional cross-check that takes the PIN code found in a branch address and resolves it against India Post.
Setup
Requires Python 3.12+ and uv.
git clone https://github.com/Ankur1911/india-pincode-ifsc-mcp && cd india-pincode-ifsc-mcp
uv sync
uv run india-pincode-ifsc-mcp # stdio transportAdd it to any MCP client that launches stdio servers:
{
"mcpServers": {
"india-pincode-ifsc": {
"command": "uv",
"args": ["run", "--directory", "/path/to/india-pincode-ifsc-mcp", "india-pincode-ifsc-mcp"]
}
}
}For HTTP instead of stdio: MCP_TRANSPORT=streamable-http MCP_HOST=127.0.0.1 MCP_PORT=8000 uv run india-pincode-ifsc-mcp.
Related MCP server: BharatPay MCP
Tools
All tools are read-only.
Tool | What it returns |
| 1 to 25 PIN codes in one call. Per PIN: state, district, division, region, postal circle, and the post offices under it with type (HO head, SO sub, BO branch) and whether they deliver mail. Malformed PINs are returned under |
| Post offices matching a locality or office name, with PIN code, type, delivery status, district and state. Use it to go from a place name to a PIN. |
| 1 to 25 IFSC codes in one call (any case or spacing). Per match: bank, branch, address, city, district, state, phone, MICR, SWIFT, supported services (NEFT, RTGS, IMPS, UPI) and the PIN code found in the address. |
| Branches filtered by bank (4-letter code or a well-known name), city and/or branch name, with paging ( |
| The 4-letter bank codes known by name (about 45 larger banks), optionally filtered by text. |
Configuration
All optional environment variables:
Variable | Default | Meaning |
|
| India Post PIN service root (for a mirror or proxy) |
|
| IFSC service root (the dataset can be self-hosted) |
|
| Request timeout in seconds |
|
| Retries on HTTP 429, 502, 503, 504 and timeouts |
|
| Parallel upstream requests for bulk lookups |
|
| Responses longer than this are cut with a notice |
|
|
|
Limits
India only. These are community-run public services with no published SLA; the server retries politely but does not queue or cache requests.
Bulk lookups send one upstream request per code (up to 5 in parallel) and are capped at 25 codes per call.
PIN data has no coordinates. A PIN code covers a delivery area, often several post offices, so district and state are reliable but a PIN is not a precise location.
search_ifscfilters on bank, city and branch name, which the IFSC service matches exactly (this server upper-cases the input). City and district spellings follow the dataset (for exampleBANGALORE URBAN,GREATER BOMBAY), so a differently spelled city returns nothing. There is no filter by state or PIN.Bank-name resolution covers about 45 larger banks; for any other bank pass its 4-letter code (the first four characters of its IFSC codes).
The PIN found in a branch address is parsed from free text, so it can be missing or wrong;
with_postal_areais a sanity check, not an authority.Data freshness follows the upstream datasets. A branch that closed or merged recently may still be listed, and new post offices may be missing.
Development
uv sync
uv run pytestTests mock all HTTP traffic with respx; no network access is needed.
Licence
MIT. Author: Ankur Kapuriya. Not affiliated with or endorsed by India Post, the Reserve Bank of India, Razorpay or postalpincode.in. Check each upstream service's terms before redistributing results or sending heavy traffic.
Available Tools
5 toolslist_bank_codesARead-onlyIdempotent
List the 4-letter IFSC bank codes this server knows by name (about 45 larger banks), optionally filtered by text. Use it to find the code for search_ifsc; any other bank's code is the first 4 characters of its IFSC codes.
Inputs: query.
lookup_ifscARead-onlyIdempotent
Verify and look up 1 to 25 bank IFSC codes in one call (any case or spacing). Each match returns bank, branch, address, city, district, state, phone, MICR, SWIFT and which payment services the branch supports (NEFT, RTGS, IMPS, UPI), plus the PIN code found in the address. Set with_postal_area=true to also look up that PIN with India Post and return its district, state and post offices, which is a quick check that the branch address is consistent. Malformed codes are listed under 'invalid_format' without a request; unknown ones under 'not_found'.
Inputs: codes (required), with_postal_area.
lookup_pincodesARead-onlyIdempotent
Validate and look up 1 to 25 Indian PIN codes in one call. Each match returns state, district, division, region, postal circle and the post offices under that PIN with their type (HO head, SO sub, BO branch office) and whether they deliver mail. PINs that are not 6 digits are reported under 'invalid_format' without a request; well-formed PINs that India Post does not know are under 'not_found'. detail='full' adds each office's block and raw fields. Use search_post_offices when you only have a locality name.
Inputs: pincodes (required), detail.
search_ifscARead-onlyIdempotent
List bank branches and their IFSC codes, filtered by bank, city and/or branch name (at least one filter). 'bank' accepts a 4-letter bank code or a well-known name such as 'HDFC Bank', 'SBI' or 'Kotak'. City and branch names are matched exactly as the dataset spells them (for example 'MUMBAI', 'SAROJINI NAGAR'), so an unlisted spelling returns nothing. Results are paged: when more exist the reply has next_offset to pass back as offset. For one known IFSC use lookup_ifsc.
Inputs: bank, city, limit, branch, +1 more.
search_post_officesARead-onlyIdempotent
Find Indian post offices by name (locality, town or office name) and get each one's PIN code, type, delivery status, district and state. Names repeat across India (there are many 'Gandhi Nagar'), so check district and state. Use it to go from a place name to a PIN code; use lookup_pincodes to go from a PIN to its area.
Inputs: name (required), limit.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
The two lookup tools (PIN→area, IFSC→branch) and the two search tools (locality→PIN, bank/city→IFSC) are explicit inverses, and each description names the sibling tool it should not be confused with. list_bank_codes is a narrow helper that feeds search_ifsc, and its role is stated clearly.
All five tools follow a strict verb_noun snake_case pattern (lookup_pincodes, search_post_offices, lookup_ifsc, search_ifsc, list_bank_codes). The verb choice is semantically meaningful: lookup for exact-key resolution, search for filtered discovery, list for enumeration.
Five tools is exactly right for a two-domain (India Post PIN + bank IFSC) lookup server, with two tools per domain plus one small enumerator for bank codes. No tool feels redundant or padded.
Both directions of both domains are covered (key→record, name→key), including batch lookup, validation, and paging on search_ifsc. Minor gaps: no way to enumerate post offices or branches purely by district/state, and no reverse IFSC-from-bank-name-and-branch beyond the filter-based search_ifsc.
Maintenance
Related MCP Connectors
ifsc-in MCP — Indian bank branch IFSC code lookup via Razorpay's open IFSC API…
Identity resolution MCP server for phone/email lookups across 31+ services. Global + India coverage.
Free Indian data and AI: pincode, IFSC, GSTIN, holidays, GST invoice, OCR, calculators, translation.
380+ live data, validation and utility APIs in one MCP server: IP, DNS, email, FX, weather and more.
Related MCP Servers
- AlicenseAqualityBmaintenanceAn offline-first MCP server for Indian financial, tax, and government APIs, providing tools for identity validation (PAN, Aadhaar, GSTIN), tax calculations (Income Tax, TDS, GST), and master data lookups (IFSC, Pincode, HSN/SAC) with zero authentication required.7676 PyPI87MIT
- AlicenseAqualityCmaintenanceProvides AI agents with Indian fintech utilities including IFSC bank lookups, PAN/GSTIN validation, mutual fund NAVs, UPI VPA identification, pincode lookups, and INR formatting, all with zero authentication and zero cost.722 PyPIMIT
- AlicenseAqualityDmaintenanceEnables LLMs to query real-time Indian bank branch details, postal PIN codes, validate GSTIN/PAN structures, check e-commerce serviceability, and compute GST breakdowns using free public APIs and offline verification logic.611 npm1MIT
- AlicenseAqualityCmaintenanceEnables live GSTIN verification, GST return and compliance history lookup, HSN/SAC code searches, and MCA company registry queries through MCP clients.1050 npmMIT