opedd-mcp 0.12.8 → 0.12.9

package/dist/index.js

@@ -53,6 +53,7 @@ async function opeddFetch(creds, path, options = {}) {
     // proxy must surface as "HTTP 502", not a JSON SyntaxError.
     if (!res.ok) {
         let msg = `HTTP ${res.status}`;
+        let details;
         try {
             const errBody = await res.json();
             // Backend envelope upgraded to structured errors ({ error: { code,
@@ -60,6 +61,8 @@ async function opeddFetch(creds, path, options = {}) {
             // object into Error() rendered "[object Object]" — every agent-facing
             // failure was unreadable (launch-gaps follow-on, 2026-07-17).
             const e = errBody?.error;
+            if (typeof e === "object" && e !== null)
+                details = e.details;
             msg =
                 (typeof e === "object" && e !== null ? [e.code, e.message].filter(Boolean).join(": ") : e) ||
                     errBody?.message ||
@@ -69,8 +72,9 @@ async function opeddFetch(creds, path, options = {}) {
             // non-JSON error body — keep the HTTP-status default
         }
         // The status rides on the error so a caller can treat one status as an
-        // answer (lookup_content: 404 = not on Opedd yet) without parsing text.
-        throw Object.assign(new Error(msg), { status: res.status });
+        // answer (lookup_content: 404 = not on Opedd yet) without parsing text;
+        // error.details rides too (lookup_content: the publication at that site).
+        throw Object.assign(new Error(msg), { status: res.status, details });
     }
     return await res.json();
 }
@@ -184,7 +188,7 @@ function buildTools(has) {
     const TOOLS = [
         {
             name: "lookup_content",
-            description: "Looks up an article on Opedd by its web address. Returns the title, publication, available licence types and prices, or that it is not on Opedd yet (then request_publication records the request).",
+            description: "Looks up an article on Opedd by its web address. Returns the title, publication, available licence types and prices; for a publication's homepage, the publication and its licensing page; or that it is not on Opedd yet (then request_publication records the request).",
             inputSchema: {
                 type: "object",
                 required: ["url"],
@@ -878,6 +882,20 @@ export async function dispatchTool(name, args, creds = ENV_CREDS) {
                     // servers on error rates, and the honest reply is "not on Opedd yet"
                     // with a way to ask for it, never "coming soon".
                     if (e.status === 404) {
+                        // No article at this address, but the address is a publication on
+                        // Opedd (its homepage, or a piece not imported yet): say so, and
+                        // where to license it (2026-10-24). Agents that looked up a
+                        // publication's homepage were told it was not on Opedd.
+                        const details = e.details;
+                        if (details?.on_opedd === true && details.publication) {
+                            return ok({
+                                on_opedd: true,
+                                url,
+                                publication: details.publication,
+                                message: `There is no single article at this address, but ${details.publication.name ?? "this publication"} is on Opedd. ` +
+                                    "Its licences and prices are on its licensing page; use search_content or search_passages to find its articles.",
+                            });
+                        }
                         return ok({
                             on_opedd: false,
                             url,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opedd-mcp",
-  "version": "0.12.8",
+  "version": "0.12.9",
   "description": "Content licensing for the AI era. Licensed, rights-cleared content for AI agents, with a verifiable license key for every article. The MCP alternative to unlicensed scraping for RAG and AI search.",
   "type": "module",
   "main": "dist/index.js",