# 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.

MCP server: `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: https://vscode.dev/redirect/mcp/install?name=india-api&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fapi.dharun.dev%2Fmcp%22%7D

## Cursor

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

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

Install in Cursor: https://cursor.com/en/install-mcp?name=india-api&config=eyJ1cmwiOiJodHRwczovL2FwaS5kaGFydW4uZGV2L21jcCJ9

## 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.

```
npx skills add dharunashokkumar/api.dharun.dev
```

Or download https://api.dharun.dev/skills/india-api.zip and upload it where your assistant takes skills. Read it at https://api.dharun.dev/.well-known/agent-skills/india-api/SKILL.md. The skill is MIT-0.

## Tools

- `get_company_logo`: Get 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_companies`: Search Indian listed companies by ticker, name, sector, industry, ISIN or index name (for example 'Nifty 50'). Returns details with logo URLs.
- `lookup_pincode`: Look up an Indian pincode: its district, state and every post office that uses it.
- `search_post_offices`: Find Indian post offices and their pincodes by the start of the office name, optionally within a state or district.
- `lookup_ifsc`: Look up an Indian bank branch by its IFSC: bank, branch, address, MICR and supported payment systems.
- `search_bank_branches`: Find 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_banks`: Find Indian banks and their four-letter codes by name.
- `lookup_rto`: Find which Regional Transport Office an Indian vehicle registration belongs to. Accepts a code (TN-28) or a full number plate (TN28AB1234).
- `list_holidays`: List 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_words`: Spell a number or rupee amount in words using the Indian system (lakh, crore), in English, Hindi or Tamil.
- `validate_identifier`: Check the format of an Indian GSTIN, PAN or IFSC. Format only: it does not confirm the identifier was issued.
- `lookup_airport`: Look up an airport by IATA code (MAA) or ICAO code (VOMM): name, city, state, country, coordinates and whether it has scheduled flights.
- `search_airports`: Search 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_link`: Build 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_constituency`: Find the assembly (MLA) and parliamentary (MP, Lok Sabha) constituency of a place in India, by pincode or by latitude and longitude.
- `check_dns`: Look 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_address`: Check 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_data`: Generate 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_code`: Look 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_codes`: Find Indian HSN (goods) or SAC (services) codes by words of their description, such as 'green tea' or 'construction'.
- `lookup_ip_address`: Find the country, region (Indian state), city and network operator of a public IPv4 or IPv6 address.
- `traceroute_from_india`: Trace 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_nav`: Get 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_funds`: Search 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_panchang`: Hindu 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_number`: Check 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_propagation`: Current 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_regex`: Run 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_passes`: When 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_satellites`: List or search the tracked space stations and amateur radio satellites, with catalogue numbers, orbital periods and inclinations.
- `where_is_satellite`: Where 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_station`: Look up an Indian Railways station by its code (MAS, NDLS): name, state, railway zone and elevation.
- `search_railway_stations`: Find Indian railway stations and their codes by name, state or railway zone.
- `get_sun_and_moon`: Sunrise, 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_tokens`: Count 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_identifiers`: Mask 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_language`: Detect the language and script of a text, including Indian languages.
- `get_thirukkural`: Get 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_thirukkural`: Search the Thirukkural in Tamil or English, or list a chapter (1-133) or a paal (1 virtue, 2 wealth, 3 love).
- `transliterate_indian_text`: Rewrite 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_day`: Check 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_days`: Count Indian working days between two dates (both included) for a calendar, and list each day off with its reason.
- `indian_market_status`: Is 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_near`: Find Indian post offices and their pincodes near a latitude and longitude, nearest first.

## For other programs

- OpenAPI 3.1: https://api.dharun.dev/openapi.json
- llms.txt: https://api.dharun.dev/llms.txt, and everything in one file: https://api.dharun.dev/llms-full.txt
- MCP server card: https://api.dharun.dev/mcp/server-card
- AI catalog: https://api.dharun.dev/.well-known/ai-catalog.json
- API catalog: https://api.dharun.dev/.well-known/api-catalog
- Every page is also Markdown: add `.md` to its address or send `Accept: text/markdown`.