@dataville/dataville-mcp 0.1.2 → 0.1.4

package/README.md

@@ -2,6 +2,12 @@
 
 MCP server exposing Dataville's data source API as tools for MCP clients (Claude Desktop, Claude Code, etc.).
 
+[Dataville](https://dataville.com) is a unified REST API over ten public datasets —
+Wikipedia, arXiv, Project Gutenberg, US Census, USDA FoodData, Papers with Code,
+SEC EDGAR, OpenAlex, PyPI, and Stack Exchange — behind one interface and one API
+key, with CSV/Parquet export and SQL query support. This package lets an MCP
+client search any of those sources as a tool call.
+
 Requires a Dataville API key — get one from the [Dataville dashboard](https://app.dataville.com/api-keys).
 
 ## Tools

package/dist/client.js

@@ -1,6 +1,6 @@
 const DEFAULT_BASE_URL = "https://api.dataville.com";
 // Keep in sync with package.json version (enforced by a test).
-export const VERSION = "0.1.2";
+export const VERSION = "0.1.4";
 const USER_AGENT = `dataville-mcp/${VERSION}`;
 export class DatavilleApiError extends Error {
     status;
@@ -49,8 +49,16 @@ export async function searchDataSource(source, keywords, params) {
     });
     const body = await response.json().catch(() => undefined);
     if (!response.ok) {
-        const message = (body && typeof body === "object" && "error" in body && String(body.error)) ||
-            `Dataville API request failed with status ${response.status}`;
+        // Errors come back as { status: "error", data: { error: "..." } }. Those
+        // messages are useful to the model — "no results for X", or the full list
+        // of valid sources — so prefer them over a bare status code.
+        const apiMessage = body && typeof body === "object"
+            ? body.data?.error ??
+                body.error
+            : undefined;
+        const message = typeof apiMessage === "string" && apiMessage.length > 0
+            ? apiMessage
+            : `Dataville API request failed with status ${response.status}`;
         throw new DatavilleApiError(response.status, message);
     }
     // We always send an API key, so an "anonymous" account state means the key

package/dist/sources.js

@@ -1,14 +1,17 @@
 // Hand-maintained list of data sources supported by the Dataville API.
-// Update when Dataville adds or removes a supported source.
+// The `name` values must match the source names the API accepts — a mismatch
+// makes the source unreachable. To check against the live API, request an
+// unknown source (e.g. /nosuchsource/foo); the error lists every valid name.
 export const DATAVILLE_SOURCES = [
     { name: "wikipedia", description: "Wikipedia articles" },
     { name: "arxiv", description: "arXiv preprints" },
     { name: "gutenberg", description: "Project Gutenberg public-domain books" },
     { name: "census", description: "US Census Bureau data" },
     { name: "fooddata", description: "USDA FoodData Central" },
-    { name: "pwc", description: "Papers with Code — ML papers, code, and benchmarks" },
+    { name: "paperswithcode", description: "Papers with Code — ML papers, code, and benchmarks" },
     { name: "edgar", description: "SEC EDGAR filings" },
     { name: "openalex", description: "OpenAlex scholarly works" },
     { name: "pypi", description: "PyPI package metadata" },
     { name: "stackexchange", description: "Stack Exchange Q&A" },
+    { name: "news", description: "News front-page headlines and summaries" },
 ];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dataville/dataville-mcp",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "MCP server exposing Dataville's data source API as tools for MCP clients",
   "private": false,
   "license": "MIT",
@@ -22,7 +22,8 @@
     "prepublishOnly": "npm run build",
     "dev": "tsx watch src/index.ts",
     "start": "node dist/index.js",
-    "test": "tsx --test src/__tests__/*.test.ts"
+    "test": "tsx --test src/__tests__/*.test.ts",
+    "test:integration": "tsx --test src/__tests__/*.itest.ts"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.12.0",