# Ireland MCP

Ireland MCP is a public, read-only Model Context Protocol server for Irish public data. It needs no API key, account or login.

Endpoint: [Ireland MCP Streamable HTTP endpoint](https://mcp.irishopendata.ie/mcp)
Docs: [Ireland MCP documentation and playground](https://irishopendata.ie/)
Transport: Streamable HTTP JSON-RPC over POST
Auth: none
Default tool surface: 9 tools, 14,784 characters, about 3.7k tokens
Full surface: use ?toolsets=all only when a client needs all typed tools listed

Install:
- Claude connector: add a custom connector named Ireland MCP with the endpoint URL and no authentication.
- ChatGPT: in ChatGPT on the web, open Plugins → + → Add custom MCP server. Name it Ireland Open Data, use the endpoint URL and select No authentication. Review the warning, create and install the plugin. Switch to Work, start a new chat, type @ and select Ireland Open Data. Reuse the installed plugin if present. Account and workspace policies apply. See the [OpenAI plugin quickstart](https://developers.openai.com/plugins/quickstart).
- VS Code: vscode:mcp/install?%7B%22name%22%3A%22ireland%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.irishopendata.ie%2Fmcp%22%7D
- VS Code Insiders: vscode-insiders:mcp/install?%7B%22name%22%3A%22ireland%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.irishopendata.ie%2Fmcp%22%7D
- Cursor: cursor://anysphere.cursor-deeplink/mcp/install?name=ireland&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vbWNwLmlyaXNob3BlbmRhdGEuaWUvbWNwIn0=
- Copilot CLI: copilot mcp add --transport http ireland https://mcp.irishopendata.ie/mcp
- Claude Code: claude mcp add --transport http ireland https://mcp.irishopendata.ie/mcp
- Codex: codex mcp add ireland --url https://mcp.irishopendata.ie/mcp. Check with codex mcp get ireland; start a new session and call ireland_catalogue.
- Local stdio: npm package target `npx -y ireland-mcp` after npm publication; today use `npm ci && npm run build && node dist/src/cli.js` from source.

Default tools:
- ireland_catalogue: compact domain/source/operation catalogue.
- ireland_describe: arguments and metadata for one source/operation.
- ireland_call: execute an operation by source and operation name; cite returned source/licence metadata.
- ireland_query: filter, join, aggregate and rank whole tables on the server (table_id from ireland_call); returns only the answer rows with provenance.
- ireland_about: server, policy and citation guidance.
- search: cross-source search.
- fetch: fetch an ireland:// resource or search hit.
- nearby: place-aware shortcut.
- ireland_resolve_place: every geography code for a place (county, council, LEA, ED, constituency, NUTS3).

Toolsets:
- Default is lean.
- All tools: add ?toolsets=all.
- One source: /mcp/x/{source-id} or ?toolsets={source-id}.

Source domains: stats, law/politics, places/property, environment, transport, energy and economy. Data remains under each publisher licence; responses include source and licence metadata where available.

## Static data files

Plain JSON, no MCP client needed. Each file carries source URLs, SHA-256 checksums, an `as_of` date, licence and attribution. The MCP tools read these same files. Schema: [CIB and civic directory data](https://github.com/c-mongan/ireland-mcp/blob/main/docs/cib-and-civic-directory.md).

- [CIS callers and queries by year](https://irishopendata.ie/data/cib/cis-annual.json): Citizens Information Services, 2021–2025. CC BY 4.0, Citizens Information Board.
- [CIS queries by category](https://irishopendata.ie/data/cib/cis-query-categories.json): top-level query categories, 2021–2025. CC BY 4.0, Citizens Information Board.
- [CIPS contacts and call categories](https://irishopendata.ie/data/cib/cips-annual.json): Citizens Information Phone Service, 2021–2025. CC BY 4.0, Citizens Information Board.
- [Irish civic-tech directory](https://irishopendata.ie/data/civic-directory.json): projects listed in the Éire Civic Tech Directory behind CitizenData.ie, with each project's link and its CitizenData.ie listing. MIT, William Kennedy; status and links as listed, unverified.

## Documentation

For agent installation, read https://irishopendata.ie/AGENTS.md for the current
client instructions. Preserve all existing servers and settings. Reuse a matching
connection. Verify by calling ireland_catalogue through the installed connection.
Saved configuration alone does not prove that the connection works. If client
policy blocks setup, report the exact step and required user action.

- [Agent installation guide](https://irishopendata.ie/AGENTS.md): client configuration, compact tool workflow and citation guidance.
- [MCP server card](https://irishopendata.ie/.well-known/mcp/server-card.json): machine-readable service metadata.
- [API guide and source catalogue](https://github.com/c-mongan/ireland-mcp/blob/main/README.md): supported sources, operations and self-hosting.
- [Privacy policy](https://github.com/c-mongan/ireland-mcp/blob/main/PRIVACY.md): request handling and telemetry.
- [Source attribution](https://github.com/c-mongan/ireland-mcp/blob/main/NOTICE): publisher licences and reuse requirements.