# Lookup: India PIN codes and districts, public holidays

> Lookup: India PIN codes and districts, public holidays is a free MCP server for public data. India PIN code, district and public holiday lookups for agents. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API
- **Website:** https://api.at01.io
- **MCP Registry name:** io.at01.api/lookup
- **Categories:** [public data](https://ai-powered.com/categories/public-data), [legal and government](https://ai-powered.com/categories/legal-and-government)
- **Listing updated:** 2026-11-22

## About

Resolves an Indian PIN code to its post offices, taluk, district and state, and maps a place name to its district. A second set of tools returns public holidays for the US, UK, Australia and Canada, including regional calendars such as NSW, Scotland or Ontario.

The server is remote and needs no key. Every result carries its data licences and an attribution line, and the same data is available as a free JSON REST API with open CORS at roughly 60 requests a minute per IP.

Holiday coverage runs from 2026 to 2028, and not every region has every year. It suits agents that handle Indian addresses or need to know whether a given date is a holiday.

## Features

- **PIN code lookup:** Returns post offices, taluk, district and state for an Indian PIN code.
- **Place to district:** Finds the district and state for an Indian place name, optionally narrowed by state.
- **Holiday by date:** Checks public holidays for a date in the US, UK, Australia or Canada.
- **Next holiday:** Returns the next holiday on or after a given date.
- **Regional calendars:** Supports regions such as NSW, Scotland and Ontario.
- **Licence in results:** Each result includes data licences and an attribution line.

## Good for

- Fill in district and state from a PIN code on address forms
- Resolve a village or town name to its district
- Check whether a delivery date falls on a public holiday
- Find the next US holiday for scheduling
- Validate Indian addresses inside an agent workflow

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http lookup https://api.at01.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://api.at01.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "lookup": {
      "url": "https://api.at01.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "lookup": {
      "type": "http",
      "url": "https://api.at01.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "lookup": {
      "serverUrl": "https://api.at01.io/mcp"
    }
  }
}
```

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
https://api.at01.io/mcp
```

Enter a Name (for example "Lookup: India PIN codes and districts, public holidays"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "lookup": {
      "type": "http",
      "url": "https://api.at01.io/mcp"
    }
  }
}
```

## Tools

- `lookup_pin`: Post offices, district and state for a PIN code
- `lookup_place`: District and state for an Indian place name
- `holidays_on`: Public holidays on a date or year for a country and region
- `next_holiday`: The next holiday on or after a date

## FAQ

### Does Lookup: India PIN codes and districts, public holidays need an API key?

No. The remote MCP server and the REST API both work without a key.

### Which countries have holiday data?

The United States, United Kingdom, Australia and Canada, for 2026 to 2028; not every region has every year.

### What is the rate limit?

About 60 requests a minute per IP, and the limiter is approximate.

### How do I add Lookup: India PIN codes and districts, public holidays to Claude Code?

Run: claude mcp add --transport http lookup https://api.at01.io/mcp

### Is Lookup: India PIN codes and districts, public holidays free?

Yes. Lookup: India PIN codes and districts, public holidays is free to use.

### What are the best alternatives to Lookup: India PIN codes and districts, public holidays?

The closest alternatives to Lookup: India PIN codes and districts, public holidays are BRAINIAC Agent Execution Contract Intelligence, Lithuania Public Procurement, Torhy, EU TED Tenders Scraper and VEOSKILL.

## Where this comes from

- Description: written from the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [BRAINIAC Agent Execution Contract Intelligence](https://ai-powered.com/mcp/brainiac-agent-execution-contract-intelligence): BRAINIAC Agent Execution Contract Intelligence is a paid MCP server for legal and government.
- [Lithuania Public Procurement](https://ai-powered.com/mcp/lithuania-public-procurement): Lithuania Public Procurement is a freemium MCP server for legal and government.
- [Torhy](https://ai-powered.com/mcp/torhy): Torhy is a freemium MCP server for legal and government.
- [EU TED Tenders Scraper](https://ai-powered.com/mcp/eu-ted-tenders-scraper): EU TED Tenders Scraper is a paid MCP server for web search and scraping.
- [VEOSKILL](https://ai-powered.com/mcp/veoskill): VEOSKILL is a freemium MCP server for education and exams.
- [tenderkit](https://ai-powered.com/mcp/tenderkit): tenderkit is an open-source MCP server for public data.
- [Reachout recovery meetings](https://ai-powered.com/mcp/reachout-recovery-meetings): Reachout recovery meetings is a free MCP server for community directories.
- [Tvarka Proof](https://ai-powered.com/mcp/tvarka-proof): Tvarka Proof is a paid MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/lookup-india-pin-codes-and-districts-public-holidays
