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

pip install mcp-eircode

Or with uv:

uv pip install mcp-eircode

Usage

Claude Desktop / Claude Code

Add to your MCP configuration:

{
  "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