ckan-fynd MCP

AI assistant access to CKAN open data portals

This server implements the Model Context Protocol (MCP), allowing AI assistants like Claude, ChatGPT, and GitHub Copilot to search datasets, query DataStore records, and explore portal metadata on any CKAN instance.

Connect

Claude Code (CLI)

Add the server from your terminal:

Then ask Claude anything about the portal's data.

Claude Desktop

Add the following to your claude_desktop_config.json:

Config file location: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS), %APPDATA%\Claude\claude_desktop_config.json (Windows). Restart Claude Desktop after editing.

Other MCP Clients

Point any MCP-compatible client at the Streamable HTTP endpoint:

Test from Terminal

Available Tools

ToolDescription
dataset_searchSearch datasets by keyword, filter, or facet
dataset_showGet full metadata for a specific dataset
dataset_listList all dataset names/IDs
datastore_searchQuery records in a DataStore resource
datastore_fieldsGet field definitions for a DataStore resource
resource_showGet metadata for a specific resource
organization_listList all organisations
organization_showGet organisation details
group_listList all groups/themes
group_showGet group details
tag_listList all tags

How It Works

ckan-fynd connects to a CKAN portal's Action API over HTTP and translates MCP tool calls into CKAN API requests. No database, no state โ€” just a protocol bridge between AI assistants and open data.

For portals that run CKAN 2.10+, consider ckanext-fynd instead โ€” a CKAN extension that serves MCP from inside CKAN with native auth integration.