India API

Use India API from your AI assistant

Connect the MCP server and your assistant can look up pincodes, IFSC codes, holidays and more by itself. No key, no sign-up, nothing to install.

https://api.dharun.dev/mcp

Streamable HTTP, stateless, no authentication. Each of the 44 tools returns exactly what the matching REST endpoint returns.

Claude Code

Add the server, or install the plugin, which brings the skill as well.

claude mcp add --transport http india-api https://api.dharun.dev/mcp

# or the plugin (skill and MCP server together)
/plugin marketplace add dharunashokkumar/api.dharun.dev
/plugin install india-api@dharun-dev

Claude (claude.ai and Claude Desktop)

Settings, Connectors, Add custom connector. Name it India API and paste the address. No authentication is needed.

https://api.dharun.dev/mcp

ChatGPT

Where your plan allows custom connectors: turn on developer mode in Settings, then create a connector with this address and no authentication.

https://api.dharun.dev/mcp

VS Code (GitHub Copilot)

Use the button, or add this to .vscode/mcp.json.

{
  "servers": {
    "india-api": { "type": "http", "url": "https://api.dharun.dev/mcp" }
  }
}
Install in VS Code

Cursor

Use the button, or add this to ~/.cursor/mcp.json.

{
  "mcpServers": {
    "india-api": { "url": "https://api.dharun.dev/mcp" }
  }
}
Install in Cursor

Windsurf

Add this to ~/.codeium/windsurf/mcp_config.json.

{
  "mcpServers": {
    "india-api": { "serverUrl": "https://api.dharun.dev/mcp" }
  }
}

Gemini CLI

Add this to ~/.gemini/settings.json.

{
  "mcpServers": {
    "india-api": { "httpUrl": "https://api.dharun.dev/mcp" }
  }
}

OpenAI Codex

Add this to ~/.codex/config.toml.

[mcp_servers.india-api]
url = "https://api.dharun.dev/mcp"

Teach your coding agent the API

The Agent Skill tells Claude Code, Codex, Copilot, Cursor, Gemini CLI and other agents when to use this API and how to call it. It is generated from the same catalog as these pages.

npx skills add dharunashokkumar/api.dharun.dev

Or download it and upload it where your assistant takes skills, such as claude.ai: india-api.zip. Read it first at SKILL.md. The skill is MIT-0.

Try asking

Tools

ToolWhat it does
get_company_logoGet the logo URLs (SVG and PNG) and details of a company listed on India's NSE or BSE. Accepts a ticker (TCS), exchange-qualified ticker (NSE:TCS), Yahoo symbol (TCS.NS) or ISIN.
search_companiesSearch Indian listed companies by ticker, name, sector, industry, ISIN or index name (for example 'Nifty 50'). Returns details with logo URLs.
lookup_pincodeLook up an Indian pincode: its district, state and every post office that uses it.
search_post_officesFind Indian post offices and their pincodes by the start of the office name, optionally within a state or district.
lookup_ifscLook up an Indian bank branch by its IFSC: bank, branch, address, MICR and supported payment systems.
search_bank_branchesFind branches of one Indian bank by state, city or text in the branch name or address. Needs the four-letter bank code; use search_banks to find it.
search_banksFind Indian banks and their four-letter codes by name.
lookup_rtoFind which Regional Transport Office an Indian vehicle registration belongs to. Accepts a code (TN-28) or a full number plate (TN28AB1234).
list_holidaysList Indian holidays for a year: bank holidays, central government holidays, and stock market trading and clearing holidays. Filter by type, state or month.
number_to_wordsSpell a number or rupee amount in words using the Indian system (lakh, crore), in English, Hindi or Tamil.
validate_identifierCheck the format of an Indian GSTIN, PAN or IFSC. Format only: it does not confirm the identifier was issued.
lookup_airportLook up an airport by IATA code (MAA) or ICAO code (VOMM): name, city, state, country, coordinates and whether it has scheduled flights.
search_airportsSearch airports by name or city, worldwide (those with IATA codes) and every Indian airfield and heliport. Filter by country (ISO code) or Indian state.
make_upi_payment_linkBuild a UPI payment link (upi://pay) for an Indian UPI ID, with optional payee name, amount and note, plus the URL of a QR code image for it. Generate only; nothing is checked with a bank.
find_constituencyFind the assembly (MLA) and parliamentary (MP, Lok Sabha) constituency of a place in India, by pincode or by latitude and longitude.
check_dnsLook up a domain's DNS records (A, AAAA, MX, TXT, NS, CNAME, CAA, SOA, SRV, or PTR for an IP) at Cloudflare, Google, Quad9 and OpenDNS at once, and say whether they agree.
check_email_addressCheck an email address without contacting its mail server: valid form, disposable (throwaway) domain, free provider, role account, and whether the domain has mail servers.
make_fake_indian_dataGenerate made-up Indian test data for building apps: people (name, gender, birth date, email, phone, PAN, address) or companies (name, PAN, GSTIN with a valid check character, address) or addresses, at real pincodes. Never real people.
lookup_hsn_codeLook up an Indian HSN code (goods) or SAC code (services) used in GST invoices: its description, the chapter and heading above it, and the codes below it. No GST rates.
search_hsn_codesFind Indian HSN (goods) or SAC (services) codes by words of their description, such as 'green tea' or 'construction'.
lookup_ip_addressFind the country, region (Indian state), city and network operator of a public IPv4 or IPv6 address.
traceroute_from_indiaTrace the network path from a server in India to a host, MTR style: every hop with its address, name, network (AS) and country, packet loss and round-trip times. Shows how Indian networks reach a site.
get_mutual_fund_navGet the latest NAV of an Indian mutual fund scheme by AMFI scheme code or ISIN, with its fund house, category, plan and option.
search_mutual_fundsSearch Indian mutual fund schemes by name words, fund house or category, filtered by direct/regular plan and growth/IDCW option, with their latest NAVs.
get_panchangHindu almanac (panchang) for a date and place: tithi, nakshatra, yoga, karana with their end times, sunrise, sunset, moonrise, moonset, Rahu kalam, Yamagandam, Gulika kalam, Abhijit muhurta, Tamil month and day, lunar month, Shaka and Vikram years.
check_indian_phone_numberCheck an Indian phone number's form and type (mobile, toll-free, fixed line), format it, and name the operator and telecom circle its series was originally given to.
get_hf_propagationCurrent space weather from NOAA (solar flux, sunspot number, K and A indices, X-ray class, NOAA R/S/G scales) and a rule of thumb good/fair/poor rating of HF amateur radio bands by day and night.
test_regexRun a regular expression (JavaScript or RE2/Go syntax) against a text: every match with its groups and character offsets, an optional replacement, and a token by token explanation of the pattern.
get_satellite_passesWhen the ISS, the Chinese space station or an amateur radio satellite passes over a place in the next days: rise, highest point and set times with compass directions and elevations, and when the pass can be seen with the eye.
find_satellitesList or search the tracked space stations and amateur radio satellites, with catalogue numbers, orbital periods and inclinations.
where_is_satelliteWhere a tracked satellite such as the ISS is right now: the point on Earth below it, its altitude and speed, and whether it is in sunlight.
lookup_railway_stationLook up an Indian Railways station by its code (MAS, NDLS): name, state, railway zone and elevation.
search_railway_stationsFind Indian railway stations and their codes by name, state or railway zone.
get_sun_and_moonSunrise, sunset, solar noon, day length, civil, nautical and astronomical twilight, moonrise, moonset, moon phase, illumination, age and the next new, first quarter, full and last quarter moons, for a date at an Indian pincode or any latitude and longitude.
count_tokensCount the tokens a text uses for an OpenAI model or encoding (o200k_base for GPT-4o and later, cl100k_base for GPT-4).
redact_indian_identifiersMask Aadhaar, PAN, GSTIN, card, phone, email, UPI ID, vehicle, voter ID, passport and IP numbers in a text, checking check digits where they exist.
detect_languageDetect the language and script of a text, including Indian languages.
get_thirukkuralGet a Thirukkural couplet by number (1-1330) in Tamil, with transliteration, English translations by G.U. Pope and by Drew and Lazarus, and its chapter.
search_thirukkuralSearch the Thirukkural in Tamil or English, or list a chapter (1-133) or a paal (1 virtue, 2 wealth, 3 love).
transliterate_indian_textRewrite text from one Indian script in another (Devanagari, Bengali, Gurmukhi, Gujarati, Odia, Tamil, Telugu, Kannada, Malayalam), or in Roman letters (ISO 15919, IAST, plain ASCII), or from ISO 15919 / IAST into a script. Spelling only, not translation.
check_working_dayCheck whether a date is a working day in India for banks in a state, NSE trading, NSE settlement or central government offices; get the previous and next working days, or the date N working days away (T+1 settlement: calendar settlement, add 1).
count_working_daysCount Indian working days between two dates (both included) for a calendar, and list each day off with its reason.
indian_market_statusIs the Indian stock market (NSE equities) open now or at a given moment: session, reason if closed, and when it next opens.
find_post_offices_nearFind Indian post offices and their pincodes near a latitude and longitude, nearest first.

For other programs