opedd-mcp 0.7.0 → 0.8.0

package/README.md

@@ -88,6 +88,7 @@ Exposes up to 17 tools to any AI assistant (some are conditional on env vars):
 
 | Tool | Description |
 |------|-------------|
+| `search_content` | Full-text search across everything licensable (v0.8.0) — ranked matches with publisher, prices, word count and a description snippet; quotes for phrases, `-word` to exclude |
 | `lookup_content` | Look up an article by URL — returns title, publisher, pricing |
 | `purchase_license` | Buy a single-article license via Stripe — returns OP-XXXX-XXXX key. Requires `terms_accepted: true` (genuine buyer assent to opedd.com/terms; recorded with the licence) |
 | `verify_license` | Verify a license key — returns validity, article, publisher, blockchain proof |

package/dist/index.js

@@ -170,6 +170,22 @@ function buildTools(has) {
                 },
             },
         },
+        {
+            name: "search_content",
+            description: "Full-text search across everything licensable on Opedd (public, no key needed). " +
+                "Ask in plain words or use quotes for phrases and -word to exclude. Returns ranked matches with the publisher, " +
+                "prices, word count and a short description snippet (never the body). Use it to answer 'does Opedd have coverage on X', " +
+                "then lookup_content or get_content for a specific article.",
+            inputSchema: {
+                type: "object",
+                required: ["query"],
+                properties: {
+                    query: { type: "string", description: "Search words (max 200 characters)." },
+                    limit: { type: "number", description: "Max results (default 20, max 50)." },
+                    publisher: { type: "string", description: "Optional publisher slug to search within." },
+                },
+            },
+        },
         {
             name: "purchase_license",
             description: "Purchase a content license from the Opedd protocol using a Stripe payment method. " +
@@ -768,6 +784,22 @@ export async function dispatchTool(name, args, creds = ENV_CREDS) {
                 const data = await opeddFetch(creds, `/lookup-article?url=${encodeURIComponent(url)}`);
                 return ok(data);
             }
+            // ── search_content ─────────────────────────────────────────────────────
+            case "search_content": {
+                const { query, limit, publisher } = args;
+                const q = (query ?? "").replace(/\s+/g, " ").trim();
+                if (!q)
+                    return err("query is required");
+                if (q.length > 200)
+                    return err("query must be at most 200 characters");
+                const params = new URLSearchParams({ action: "search", q });
+                if (typeof limit === "number" && Number.isFinite(limit))
+                    params.set("limit", String(Math.min(Math.max(Math.trunc(limit), 1), 50)));
+                if (typeof publisher === "string" && publisher.trim())
+                    params.set("publisher", publisher.trim());
+                const envelope = (await opeddFetch(creds, `/api?${params.toString()}`));
+                return ok(envelope.data ?? envelope);
+            }
             // ── purchase_license ───────────────────────────────────────────────────
             case "purchase_license": {
                 const { article_url, article_id, license_type, buyer_email: argEmail, buyer_name, buyer_organization, intended_use, payment_method_id: argPm, } = args;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opedd-mcp",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "Licensed, rights-cleared content for AI agents \u2014 verifiable license keys, on-chain proof, and EU AI Act attestation. The MCP alternative to unlicensed scraping for RAG and AI search.",
   "type": "module",
   "main": "dist/index.js",