Metadata-Version: 2.4
Name: mcp-eircode
Version: 0.2.0
Summary: MCP server for Irish address and Eircode lookup
Requires-Python: >=3.13
Description-Content-Type: text/markdown
Requires-Dist: httpx>=0.28.1
Requires-Dist: mcp[cli]>=1.26.0

# mcp-eircode

An MCP (Model Context Protocol) server that provides Irish address and Eircode lookup functionality via the Eircode API.

## Disclaimer

This software interacts with the Eircode Finder API. **It is your responsibility** to ensure that your usage of this software complies with the [Eircode API terms of service](https://www.eircode.ie/) and any applicable usage guidelines. The authors of this software accept no liability for misuse or any violation of the Eircode API terms.

## Features

- Look up Irish addresses or Eircodes
- Returns full addresses with Eircodes and geographic coordinates
- Automatically resolves drilldown results for multi-match queries

## Installation

```bash
pip install mcp-eircode
```

Or with [uv](https://docs.astral.sh/uv/):

```bash
uv pip install mcp-eircode
```

## Usage

### Claude Desktop / Claude Code

Add to your MCP configuration:

```json
{
  "mcpServers": {
    "eircode": {
      "command": "mcp-eircode"
    }
  }
}
```

### Available Tools

#### `lookup_eircode`

Look up an Irish address or Eircode. Returns full addresses with Eircodes and coordinates.

**Parameters:**
- `address` (string) - The address or Eircode to look up

**Returns:** A list of matching addresses, each containing:
- `label` - Address lines
- `eircode` - The Eircode
- `latitude` / `longitude` - Geographic coordinates
