@aborruso/ckan-mcp-server 0.4.51 → 0.4.52

package/LOG.md

@@ -1,5 +1,11 @@
 # LOG
 
+## 2026-02-28 (v0.4.52)
+
+- fix: HTTP transport — `/.well-known/oauth-authorization-server` now returns JSON 404 instead of HTML; fixes Claude Code HTTP transport connection failure
+- fix: `ckan_datastore_search` — `limit` min changed 1→0; allows column discovery without fetching data
+- docs: `ckan_datastore_search` description updated — fields always returned, `limit=0` pattern documented
+
 ## 2026-02-27 (v0.4.51)
 
 - refactor: domain types for all tool files — `CkanTag`, `CkanResource`, `CkanPackage`, `CkanOrganization`, `CkanField`, `CkanDatastoreResult` in `src/types.ts`; `any` reduced 32 → 1

package/dist/index.js

@@ -2043,6 +2043,10 @@ function registerDatastoreTools(server2) {
 
 The DataStore allows SQL-like queries on tabular data. Not all resources have DataStore enabled.
 
+The response always includes a Fields section listing all available column names and types.
+Use limit=0 to discover column names without fetching data \u2014 do this before using filters
+to avoid guessing column names and getting HTTP 400 errors.
+
 Args:
   - server_url (string): Base URL of CKAN server
   - resource_id (string): ID of the DataStore resource
@@ -2056,20 +2060,21 @@ Args:
   - response_format ('markdown' | 'json'): Output format
 
 Returns:
-  DataStore records matching query
+  DataStore records matching query, always including available column names and types
 
 Examples:
+  - { server_url: "...", resource_id: "abc-123", limit: 0 }  \u2190 discover columns first
   - { server_url: "...", resource_id: "abc-123", limit: 50 }
   - { server_url: "...", resource_id: "...", filters: { "regione": "Sicilia" } }
   - { server_url: "...", resource_id: "...", sort: "anno desc", limit: 100 }
 
-Typical workflow: ckan_package_search \u2192 ckan_package_show (find resource_id with datastore_active=true) \u2192 ckan_datastore_search`,
+Typical workflow: ckan_package_search \u2192 ckan_package_show (find resource_id with datastore_active=true) \u2192 ckan_datastore_search (limit=0 to get columns) \u2192 ckan_datastore_search (with filters)`,
       inputSchema: z4.object({
         server_url: z4.string().url().describe("Base URL of the CKAN server (e.g., https://dati.gov.it/opendata)"),
         resource_id: z4.string().min(1).describe("UUID of the DataStore resource (from ckan_package_show resource.id where datastore_active is true)"),
         q: z4.string().optional().describe("Full-text search across all fields"),
         filters: z4.record(z4.any()).optional().describe('Key-value filters for exact matches (e.g., { "regione": "Sicilia", "anno": 2023 })'),
-        limit: z4.number().int().min(1).max(32e3).optional().default(100).describe("Max rows to return (default 100, max 32000)"),
+        limit: z4.number().int().min(0).max(32e3).optional().default(100).describe("Max rows to return (default 100, max 32000); use 0 to get only column names without data"),
         offset: z4.number().int().min(0).optional().default(0).describe("Pagination offset"),
         fields: z4.array(z4.string()).optional().describe("Specific field names to return; omit to return all fields"),
         sort: z4.string().optional().describe("Sort expression (e.g., 'anno desc', 'nome asc')"),
@@ -4004,7 +4009,7 @@ var registerAllPrompts = (server2) => {
 function createServer() {
   return new McpServer({
     name: "ckan-mcp-server",
-    version: "0.4.50"
+    version: "0.4.52"
   });
 }
 function registerAll(server2) {
@@ -4038,6 +4043,9 @@ async function runHTTP(server2) {
     enableJsonResponse: true
   });
   await server2.connect(transport2);
+  app.get("/.well-known/oauth-authorization-server", (_req, res) => {
+    res.status(404).json({ error: "authorization_not_supported", error_description: "This server does not require authentication" });
+  });
   app.post("/mcp", async (req, res) => {
     await transport2.handleRequest(req, res, req.body);
   });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aborruso/ckan-mcp-server",
-  "version": "0.4.51",
+  "version": "0.4.52",
   "description": "MCP server for interacting with CKAN open data portals",
   "main": "dist/index.js",
   "type": "module",