India API MCP server
Commit Nov 13, 2026Provides access to a wide range of Indian data including pincodes, IFSC, GSTIN, holidays, OCR, and financial calculators.
Also known as dharunashokkumar/api.dharun.dev, api-dharun-dev
- Stars
- 10
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 1.1.42
- Last commit
- Nov 13, 2026
- License
- AGPL-3.0
What is India API MCP?
India API provides access to a wide range of Indian data including pincodes, IFSC, GSTIN, holidays, OCR, and financial calculators.
Summary generated from the project's README
About India API MCP server
India API provides a comprehensive collection of 48 different APIs designed to access diverse Indian datasets through a consistent JSON format. It serves developers needing specific regional information such as pincodes, IFSC bank codes, GSTIN and PAN validation, and RTO codes. The server also includes specialized tools for Indian languages, including translation, speech to text, and OCR capabilities for English and ten Indian languages.
Users can access these tools locally via an MCP server or remotely through standard web requests. Most endpoints do not require an API key, though obtaining a free key allows for higher usage limits. The service includes practical utilities like financial calculators for income tax and EMI, company logo retrieval for NSE or BSE listed entities, and document processing tools that can read GST invoices, receipts, or bank statements. It is a versatile resource for anyone building applications tailored to the Indian market.
What you can do with it
- 1Validate Indian financial identifiersCheck if a GSTIN, PAN, or IFSC code follows the correct structure and character rules.
- 2Automate financial calculationsCalculate income tax under different regimes or determine EMI schedules for loans.
- 3Process regional language documentsExtract text from photos or scans using OCR in English and ten Indian languages.
- 4Retrieve regional location dataFind post office details, districts, and states associated with a specific pincode.
Written from the project's README. Every use case is checked against a quote from it.
How to install India API MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall India API MCP in Claude Code
$ claude mcp add --transport http api-dharun-dev https://api.dharun.dev/mcpInstall India API MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"api-dharun-dev": {
"url": "https://api.dharun.dev/mcp"
}
}
}Install India API MCP in VS Code
.vscode/mcp.json
{
"servers": {
"api-dharun-dev": {
"type": "http",
"url": "https://api.dharun.dev/mcp"
}
}
}Install India API MCP in VS Code CLI
$ code --add-mcp '{"name":"api-dharun-dev","type":"http","url":"https://api.dharun.dev/mcp"}'Install India API MCP in Codex
$ codex mcp add api-dharun-dev --url https://api.dharun.dev/mcpInstall India API MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.api-dharun-dev] url = "https://api.dharun.dev/mcp"
Install India API MCP in Gemini CLI
$ gemini mcp add -s user --transport http api-dharun-dev https://api.dharun.dev/mcpInstall India API MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"api-dharun-dev": {
"url": "https://api.dharun.dev/mcp",
"type": "http"
}
}
}Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachabledharunashokkumar/api.dharun.dev is public and reachablegithub.com/dharunashokkumar/api.dharun.dev ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)AGPL-3.0spdx.org/licenses/AGPL-3.0.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-13github.com/dharunashokkumar/api.dharun.dev ↗Pass
- OpenSSF ScorecardOpenSSF Scorecard 8.2 / 10; weakest: Code-Review 0, Contributors 0, Branch-Protection 3scorecard.dev/viewer/?uri=github.com/dharunashokkumar/api.dh ↗Pass
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeinitialize answered with protocol 2025-06-18 in 909 msPass
README
View on GitHubIndia API
Free, open source APIs for Indian data. Pincodes, IFSC and bank branches, GSTIN and PAN checks, bank and market holidays, RTO codes, company logos, UPI QR codes, numbers in lakh and crore, GST invoices as PDF, OCR in Indian languages, PDF and image tools, translation, speech to text and text to speech, money calculators and more: 48 APIs behind one consistent JSON shape. No API key needed for most endpoints (a free key raises the limits), open CORS, free tool pages, a playground, and an MCP server so AI assistants can use it too.
Documentation: api.dharun.dev · API reference · Playground · Free tools · API keys · Guides · Use with AI · OpenAPI · llms.txt
curl https://api.dharun.dev/v1/pincode/637001
{
"data": { "pincode": "637001", "district": "Namakkal", "stateCode": "TN", "state": "Tamil Nadu", "offices": [ ... ] },
"meta": { "source": { "name": "...", "licence": "...", "attribution": "..." } }
}
APIs
Each name links to its page, with every parameter, a real response and code in curl, JavaScript and Python.
| API | Example | What you get |
|---|---|---|
| Company logos | /v1/logos/TCS, /v1/companies/RELIANCE |
SVG or PNG logo of an NSE or BSE listed company, REITs and InvITs included; an unknown symbol gets an initials tile, never a broken image, after the brand, global stock and asset sets are tried; sector, ISIN, market cap, indexes; old tickers still work |
| Brand, stock and asset logos | /v1/brand-logos/phonepe, /v1/stock-logos/AAPL, /v1/asset-logos/BTC |
Logos of unlisted Indian brands (payments, fintech, insurers, mutual fund houses, apps, government services), global stocks (US and nine major markets) and crypto, indices, ETFs and commodities; /v1/logos falls through to them |
| Pincodes | /v1/pincode/637001, /v1/pincode/near?lat=&lng= |
Post offices, district, state, coordinates; pincodes near a point |
| IFSC and banks | /v1/ifsc/SBIN0000001, /v1/banks?q=gramin |
Bank, branch, address, MICR, payment systems; banks and their codes by name |
| RTO codes | /v1/rto/TN-28 |
Transport office for a vehicle registration |
| Holidays | /v1/holidays/2026?type=market, /v1/holidays/2026.ics?state=TN |
Bank, central government and stock market holidays; a calendar feed to subscribe to |
| Today in India | /v1/today?state=TN&pincode=600001 |
Date and time in IST, financial year and quarter, working days, today's holidays, market status, panchang in brief |
| Money calculators | /v1/calc/income-tax?income=1500000, /v1/calc/emi?amount=1000000&rate=8.5&years=20 |
SIP, lump sum, EMI with schedule, GST split, income tax under both regimes, HRA, gratuity, PPF, capital gains, share trade charges; each names its rule |
| Working days | /v1/working-days/2026-01-16?calendar=bank&state=TN |
Working day or not, the next one, N working days ahead, T+1 settlement dates; whether NSE is open |
| HSN and SAC | /v1/hsn/0902, /v1/hsn?q=tea |
Tariff codes with descriptions and their chapter |
| Mutual funds | /v1/mutual-funds/122639 |
Latest NAV of a scheme, search by name or fund house |
| Railway stations | /v1/stations/MAS |
Station name, zone, state |
| Airports | /v1/airports/MAA |
IATA and ICAO codes, city, coordinates |
| Phone numbers | /v1/phone/9500112345 |
Valid or not, mobile or landline, original operator and circle |
| Constituencies | /v1/constituency?pincode=637001 |
Assembly and parliamentary constituency for a place |
| Panchang | /v1/panchang/2026-01-14?pincode=600001 |
Tithi, nakshatra, yoga, karana, sunrise, Rahu kalam, Tamil month |
| Sun and moon | /v1/sun-moon/today?pincode=600001 |
Sunrise, sunset, twilight, moonrise, moon phase and illumination |
| Satellite passes | /v1/sat-pass?sat=ISS&pincode=600001 |
When the ISS or an amateur radio satellite passes over, and whether it can be seen |
| HF propagation | /v1/propagation |
Solar flux, K and A index, NOAA scales, and a day and night rating per band |
| Thirukkural | /v1/thirukkural/1 |
Couplet, transliteration, two English translations; search and random |
| Transliteration | /v1/transliterate?to=tamil&text=..., /v1/transliterate/suggest?lang=ta&text=vanakkam |
Between nine Indian scripts, ISO 15919, IAST and ASCII; Roman typing to 21 Indian scripts with a model |
| Translation | /v1/translate?from=en&to=ta&text=... |
Between English and 22 Indian languages with IndicTrans2 |
| Embeddings and reranking | /v1/embed?text=..., POST /v1/rerank |
Multilingual vectors for semantic search, and a reranker to order results |
| Tamil legacy encodings | /v1/tamil-font/convert?from=tscii&text=... |
TSCII text to Unicode and back |
| IP lookup | /v1/ip/8.8.8.8, /v1/ip |
Country, city and network of an address, or of the caller |
| Email check | /v1/email/someone@example.com |
Syntax, disposable domain, whether the domain takes mail |
| DNS check | /v1/dns/example.com?type=MX |
Records as several public resolvers see them |
| Traceroute from India | /v1/mtr/example.com |
MTR-style path from a server in India: network, loss and latency per hop |
| Whois | /v1/whois/example.co.in, /v1/whois/AS55836 |
Registrar, dates, status and nameservers of a domain; holder and abuse contact of an IP network or AS number, through RDAP |
| TLS check | /v1/tls/example.com |
Certificate validity, chain, days left, TLS versions and weak ciphers, as a list of problems |
| IPv6 check | /v1/ipv6/example.com |
IPv6 addresses for the site, its nameservers and mail servers |
| HTTP probe from India | /v1/probe?url=https://example.com |
DNS, connect, TLS and first-byte times from India, redirects, headers and the CDN edge city |
| Website icons | /v1/icon/github.com?size=64 |
Any site's icon as a square PNG, or an initials tile |
| QR, UPI QR and barcodes | /v1/qr?text=hello, /v1/upi-qr?pa=shop@okaxis&am=250, POST /v1/barcode/read |
QR codes, UPI payment QR codes and links, barcodes; reading codes from a photo |
| GST invoice | POST /v1/invoice |
A GST tax invoice PDF from JSON: CGST and SGST or IGST, HSN summary, amount in words, UPI QR |
| OCR | POST /v1/ocr?lang=eng+tam |
Text from photos, scans and scanned PDFs in English and ten Indian languages |
| Document reading | POST /v1/doc/markdown, /doc/tables, /doc/invoice, /doc/einvoice-qr, /doc/receipt, /doc/cheque, /doc/statement, /doc/redact, /doc/mask-aadhaar |
PDFs and scans to Markdown and tables; GST invoices, e-invoice QR codes, receipts, cheques and bank statements read and checked; identifiers redacted and Aadhaar numbers masked |
| Image tools | POST /v1/image/convert?format=webp&width=800 |
Resize and convert (WebP, AVIF, HEIC in), remove backgrounds, perceptual hashes |
| PDF tools | POST /v1/pdf/merge, /pages, /rotate, /compress, /text, /render |
Merge, split, rotate, compress, read text, draw pages |
| Typst to PDF | /v1/typst?text=... |
Typst documents to PDF or PNG, with Indian scripts |
| Speech | POST /v1/stt, /v1/tts?text=...&voice=hi, POST /v1/audio/denoise |
Speech to text and subtitles with Whisper; text to speech in Hindi, Telugu, Malayalam and English; noise removal |
| Generated images | /v1/og-image?title=Hello, /v1/avatar/Priya%20Raman, /v1/chart?values=1,3,2 |
Link preview cards, code images, initials avatars, placeholders and bar, line, pie and sparkline charts, in ten scripts |
| Batch lookups | POST /v1/batch |
Up to 1,000 pincode, IFSC, phone, GSTIN and other lookups in one request |
| Text tools | /v1/text/chunk, /redact, /moderate, /tokens, /language |
Chunking for retrieval, PII and name redaction, moderation with Hinglish and Tanglish, token counts, language detection |
| Regex tester | /v1/regex?pattern=...&text=... |
Every match with its groups, replacement, the pattern explained |
| Fake Indian data | /v1/fake/companies?count=5 |
Test people and companies with PAN and GSTIN that pass format checks |
| Number to words | /v1/words/1,25,000?lang=ta |
Lakh and crore spelling in English, Hindi, Tamil |
| Format checks | /v1/validate/gstin/27AAPFU0939F1ZV |
GSTIN, PAN and IFSC structure and check characters |
| States | /v1/states/TN |
State codes, GST codes, vehicle prefixes |
| Number formatting | /v1/format/number/123456789.5 |
Lakh and crore grouping, 12.35 Cr short forms, rupees, words, Indian-script digits |
| Indian date tools | /v1/dates/2026-11-11, /v1/dates/diff?from=1995-08-15 |
Financial and assessment year, quarter, Saka, Tamil and Hijri dates, ages |
| UPI handles and payment QR | /v1/upi-handles/okhdfcbank, /v1/qr/parse?text=upi://... |
The app and bank behind a handle; a UPI or Bharat QR code's fields with the checksum checked |
| README badges | /v1/badge/market, /v1/badge?label=&message= |
Market open or closed, next holiday, dataset freshness, or your own |
| Address reader | /v1/address/parse?text=... |
A written address split into house, street, city, state and pincode, checked against the post offices |
| Data format tools | POST /v1/convert?to=yaml, POST /v1/diff, POST /v1/sheet/to-json |
JSON, YAML, TOML, CSV and XML to each other; text and JSON differences; XLSX and CSV to JSON and back |
| Developer utilities | /v1/cron?expr=..., /v1/uuid?kind=uuid7, /v1/time?at=3pm&to=PST |
Cron in words with next runs, UUIDs and ULIDs, hashes and HMACs, JWT decoding, user agents, time zones |
| Colours | /v1/color/ff9933, /v1/color/contrast?fg=&bg= |
Hex, RGB, HSL and OKLCH, WCAG contrast with a passing suggestion, a picture's palette |
| Web pages | /v1/unfurl?url=, /v1/read?url= |
Link previews, a page as Markdown for agents (robots.txt respected) |
| Audio and video tools | POST /v1/media/convert?format=mp3, /trim, /waveform, /thumbnail |
Convert, cut, draw a waveform, take a frame |
| Request bins | POST /v1/hooks |
A private address that records webhooks for a day |
| Throwaway databases | POST /v1/db |
A private SQLite database for a day, SQL over HTTPS |
| Festivals | /v1/festivals/2026, /v1/festivals/2026.ics?state=TN |
Hindu, Tamil, Sikh, Jain, Buddhist, Islamic and Christian festival dates 1950 to 2100, computed from the panchang with each rule given |
| Indic text tools | /v1/indic/aksharas?text=..., /v1/braille?text=..., /v1/keyboard/convert?layout=tamil99 |
Letters as readers count them, dictionary order, look-alike fixes, Bharati braille, InScript and Tamil99 keys |
| Helplines | /v1/helplines?q=cyber |
National emergency and helpline numbers |
| Index constituents | /v1/indices/nifty-50, /v1/indices?symbol=TCS |
Members of 31 NSE indices with industry, ISIN and logo; the indices a stock is in |
| Gold and silver rates | /v1/bullion, /v1/bullion/history?purity=916 |
IBJA's daily gold (24K to 14K), silver and platinum rates, per gram too, and their history |
| Mutual fund returns | /v1/mutual-funds/122639/returns, /history |
1 month to 10 year returns (CAGR), SIP XIRR, month-end NAV history |
| RBI rates and exchange rates | /v1/rates, /v1/fx?currency=USD |
Repo rate, CRR, SLR, MCLR range, bond yields; FBIL reference rates with history |
| Mandi prices | /v1/mandi?commodity=Tomato&state=Tamil%20Nadu, /v1/mandi/commodities |
Daily wholesale prices of farm produce in each market, from Agmarknet via data.gov.in |
| Air quality | /v1/air-quality?city=Chennai, ?near=lat,lon |
AQI and pollutants at CPCB's monitoring stations, hourly, via data.gov.in |
| Villages and LGD codes | /v1/lgd/states, /v1/lgd/villages?pincode=637001 |
Every state, district, sub-district and village with its LGD and Census 2011 codes, and village PIN codes, from the Local Government Directory |
| Hospitals | /v1/hospitals?pincode=637001, ?near=lat,lon |
About 30,000 hospitals with phone, specialties and position, from the National Hospital Directory (May 2016) |
| IPC to BNS | /v1/law/ipc/302, /v1/law/bns?q=murder |
Section correspondence between the new criminal laws and the old ones: BNS and IPC, BNSS and CrPC, BSA and the Evidence Act |
| Derivative expiries | /v1/expiries?exchange=nse&year=2026 |
NSE and BSE weekly and monthly expiry dates, moved for holidays |
| MICR and SWIFT | /v1/micr/400240003, /v1/swift/HDFCINBB |
The branch behind a cheque's MICR code or a SWIFT code |
| Sectors | /v1/sectors?sector=... |
Sectors and industries of listed companies, with counts and the largest companies |
| Search your own documents | POST /v1/rag, /documents, /query |
Upload text, ask questions, get the best passages back, embedded and reranked on the server |
| Agent notes | POST /v1/kv, /v1/kv/{id}/{key} |
A small private key-value store for agents, kept 30 days |
| MCP tools | /v1/mcp-tools?q=gold, /mcp?tools=money,dates |
Find a tool by task; connect to only the tool sets you need |
One shape everywhere
- Every JSON response is
{ "data": ..., "meta": { ... } }.datais an object, or an array for list endpoints, which addmeta.total,meta.limitandmeta.offset. meta.sourcenames the dataset, its version, its licence and the credit it asks for.- Errors are
{ "error": { "code", "message" } }with a matching HTTP status. - Each address has an allowance of 600 units a minute; a free API key
gives 3,000 a minute per key. A lookup costs 1; a request that takes real CPU work (image
rendering, astronomy, live DNS) costs 10, a file upload 15, and a neural network job
(speech, speech to text, translation, background removal, denoise) 30. Embeddings,
reranking and moderation count as CPU work. The
RateLimit-*headers say what is left. - The model endpoints (OCR, speech, translation, embeddings, reranking, moderation, Roman
typing, background removal, denoise, name detection) will need a free key after a notice
period; until then their answers carry an
X-Key-Noticeheader. Send a key asAuthorization: Bearer <key>orX-API-Key. - Text endpoints take
?text=, or a POST body astext/plainor JSON{"text": "..."}. - Image endpoints return the image itself, ready for an
<img>tag; PDF and audio endpoints return the file. - File endpoints take a POST of the file as the body, or as
multipart/form-data, up to 10 MB. Files are deleted when the answer is sent; nothing is kept.
Use it from AI assistants
One MCP server, one Agent Skill and one Claude Code plugin cover every API.
# Claude Code: the MCP server
claude mcp add --transport http india-api https://api.dharun.dev/mcp
# Claude Code: the plugin (skill and MCP server together)
/plugin marketplace add dharunashokkumar/api.dharun.dev
/plugin install india-api@dharun-dev
# Any agent that reads Agent Skills (Claude Code, Codex, Copilot, Cursor, Gemini CLI)
npx skills add dharunashokkumar/api.dharun.dev
- MCP server:
https://api.dharun.dev/mcp, Streamable HTTP, stateless, no authentication. Each tool returns exactly what the matching REST endpoint returns. Setup for Claude, ChatGPT, VS Code, Cursor, Windsurf, Gemini CLI and Codex: api.dharun.dev/ai. In the MCP Registry asio.github.dharunashokkumar/india-api. - Agent Skill:
skills/india-api. - Claude Code plugin:
plugins/india-api, with the marketplace in.claude-plugin/marketplace.json. - For crawlers and agents:
/llms.txt,/llms-full.txt, every page as Markdown (add.mdor sendAccept: text/markdown),/openapi.json, an MCP server card, an AI catalog and an API catalog under/.well-known/.
The skill, the plugin and server.json are generated from the catalog in
internal/api/catalog.go; a test fails when the committed copies are out of date.
Licence
- Calling the API puts no licence on your app.
- The code is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0-only). If you run a modified copy as a service for others, you must offer them your changes.
- Code examples, the guides' code, the Agent Skill and the Claude Code plugin are MIT-0: use them anywhere, no credit needed.
- Data keeps the licence of its source (below); every response repeats the credit.
- Third-party code and fonts compiled into the server keep their licences, such as the
SGP4 code in
internal/orbit(BSD-2-Clause) and the Noto fonts (OFL-1.1). The release bundle'sNOTICESlists every one. - Company, brand, stock and asset logos are trademarks of their owners. Brand artwork from Wikimedia Commons keeps its own free licence, named per brand; the crypto icons from spothq are CC0; the commodity icons were drawn for this project.
Security and privacy
Report vulnerabilities privately: see SECURITY.md. Client IP addresses are never logged, and endpoints that take personal values never log their input; the full list is at api.dharun.dev/privacy. Each release carries a build provenance attestation:
gh attestation verify dharun-api-linux-amd64.tar.gz --repo dharunashokkumar/api.dharun.dev
Contributing
Bug reports, corrections to data and requests for new APIs are welcome as issues. Pull requests are not accepted; see CONTRIBUTING.md.
India API MCP questions
How do I add India API MCP to Claude Code?
Run claude mcp add --transport http api-dharun-dev https://api.dharun.dev/mcp in your terminal. Add --scope user to make it available in every project.
How do I add India API MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
Do I need an API key to use India API?
No API key is needed for most endpoints, though a free key can be used to raise the limits.
What kind of Indian data can I access?
You can access pincodes, IFSC and bank branches, GSTIN and PAN checks, bank and market holidays, RTO codes, and more.
Can the API handle Indian languages?
Yes, it supports OCR in Indian languages, translation between English and 22 Indian languages, and speech-to-text/text-to-speech.