opedd-mcp 0.5.1 → 0.6.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Opedd Ltd
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -8,7 +8,7 @@ Lets AI assistants (Claude Desktop, Cursor, Windsurf, or any MCP-compatible host
 
 ## What it does
 
-Exposes up to 16 tools to any AI assistant (some are conditional on env vars):
+Exposes up to 17 tools to any AI assistant (some are conditional on env vars):
 
 **Always available — discovery + per-article purchase + onboarding + rights signaling**
 
@@ -50,6 +50,7 @@ Exposes up to 16 tools to any AI assistant (some are conditional on env vars):
 | Tool | Description |
 |------|-------------|
 | `list_publisher_content` | List your own articles with pricing and stats |
+| `push_content` | Push your articles to Opedd so AI buyers can license them — 1–100 per call (`title`/`url`/`html_body` required, everything else optional). Onboard your back-catalogue or new posts with no code, straight from your AI assistant. |
 
 ### Regulatory framing (CDSM Article 4 vs EU AI Act Article 53 — never conflated)
 
@@ -83,8 +84,8 @@ Set environment variables to pre-configure the server:
 | `OPEDD_PAYMENT_METHOD_ID` | Recommended | Stripe `pm_...` ID — used for autonomous per-article purchasing |
 | `OPEDD_BUYER_TOKEN` | Optional | Buyer API token (`opedd_buyer_live_*` canonical; `opedd_buyer_test_*` for sandbox) — enables `get_content` |
 | `OPEDD_ACCESS_KEY` | Optional | Enterprise access key (`ent_*`) — enables `list_feed` + `stream_feed_ndjson` |
-| `OPEDD_BUYER_JWT` | Optional | Supabase session JWT from the buyer portal — enables `get_audit_events` + `get_compliance_dossier` |
-| `OPEDD_PUB_BEARER` | Optional | Canonical Publisher API Bearer key (`opedd_pub_<env>_<32-hex>`; issued via `POST /publishers-api-keys action=create_api_key`) — enables `list_publisher_content`. **v0.4.0 canonical.** |
+| `OPEDD_BUYER_JWT` | Optional | Supabase session JWT from the buyer portal — enables `get_buyer_account` + `get_audit_events` + `get_compliance_dossier` + `article_53_attestation` |
+| `OPEDD_PUB_BEARER` | Optional | Canonical Publisher API Bearer key (`opedd_pub_<env>_<32-hex>`; issued via `POST /publishers-api-keys action=create_api_key`) — enables `list_publisher_content` + `push_content`. **v0.4.0 canonical.** |
 | `OPEDD_API_KEY` | Deprecated | Legacy Publisher API key (`op_...`) — fallback during the transition window; will stop working when opedd-backend Phase C deploys. Migrate to `OPEDD_PUB_BEARER`. |
 | `OPEDD_API_URL` | Optional | Override the API base URL (default: Opedd production) |
 | `OPEDD_MCP_TELEMETRY` | Optional | Set to `0` to disable anonymous usage telemetry (see below) |

package/dist/index.js

@@ -4,6 +4,7 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
 import { pathToFileURL } from "node:url";
 import { initTelemetry, captureToolCall, shutdownTelemetry } from "./telemetry.js";
+import { SERVER_VERSION } from "./version.js";
 // ─── Configuration ────────────────────────────────────────────────────────────
 const API_BASE = process.env.OPEDD_API_URL ??
     "https://api.opedd.com";
@@ -565,9 +566,49 @@ if (PUB_BEARER || API_KEY) {
             },
         },
     });
+    // Supply-side push: onboard a back-catalogue or send new posts directly from
+    // the AI assistant — the native companion to the /publishers-content API.
+    TOOLS.push({
+        name: "push_content",
+        description: "Push your published articles to Opedd so they can be licensed to AI buyers (requires OPEDD_PUB_BEARER — your opedd_pub_ publisher key). " +
+            "Send 1–100 articles per call; batch larger back-catalogues into multiple calls. Each article needs title, url, and html_body — everything else is optional (published_at defaults to now). " +
+            "This is the supply-side companion to list_publisher_content: use it to onboard your archive or push new content with no code, straight from your AI assistant.",
+        inputSchema: {
+            type: "object",
+            required: ["articles"],
+            properties: {
+                articles: {
+                    type: "array",
+                    minItems: 1,
+                    maxItems: 100,
+                    description: "1–100 articles to push in this call.",
+                    items: {
+                        type: "object",
+                        required: ["title", "url", "html_body"],
+                        properties: {
+                            title: { type: "string", description: "Article title (required, ≤500 chars)." },
+                            url: { type: "string", description: "The article's canonical web address (required)." },
+                            html_body: { type: "string", description: "Full article content, HTML or plain text (required, ≤200,000 chars)." },
+                            published_at: { type: "string", description: "ISO-8601 datetime (e.g. 2026-01-15T09:30:00Z). Defaults to now if omitted." },
+                            description: { type: "string", description: "Short summary (≤500 chars)." },
+                            author: { type: "string", description: "Author name (≤200 chars)." },
+                            language: { type: "string", description: "Language code, e.g. \"en\"." },
+                            tags: { type: "array", items: { type: "string" }, description: "Up to 20 tags." },
+                            image_urls: { type: "array", items: { type: "string" }, description: "Up to 10 body-image URLs." },
+                            thumbnail_url: { type: "string", description: "https cover-image URL for the catalog." },
+                            canonical_url: { type: "string", description: "Canonical URL if different from url." },
+                            category: { type: "string", description: "Content category." },
+                            is_paid: { type: "boolean", description: "Whether the article is behind a paywall." },
+                            audience: { type: "string", enum: ["everyone", "only_free", "only_paid"], description: "Intended audience." },
+                        },
+                    },
+                },
+            },
+        },
+    });
 }
 // ─── MCP Server ───────────────────────────────────────────────────────────────
-const server = new Server({ name: "opedd-mcp", version: "0.3.0" }, { capabilities: { tools: {} } });
+const server = new Server({ name: "opedd-mcp", version: SERVER_VERSION }, { capabilities: { tools: {} } });
 server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: TOOLS }));
 server.setRequestHandler(CallToolRequestSchema, async (request) => {
     // Anonymous usage telemetry — captures only the tool name, duration, and
@@ -809,7 +850,12 @@ export async function dispatchTool(name, args) {
                     params.set("window_start", window_start);
                 if (window_end)
                     params.set("window_end", window_end);
-                const data = await opeddFetch(`/eu-ai-act/article-53-attestation?${params.toString()}`, { headers: { Authorization: `Bearer ${BUYER_JWT}` } });
+                // Function name is DASH-separated end to end: the api.opedd.com proxy
+                // rewrites /:path* verbatim into /functions/v1/:path*, so the prior
+                // slashed "/eu-ai-act/article-53-attestation" resolved to a
+                // nonexistent function named "eu-ai-act" and 404'd — this tool had
+                // NEVER worked in production until the 2026-07-10 fix (live-probed).
+                const data = await opeddFetch(`/eu-ai-act-article-53-attestation?${params.toString()}`, { headers: { Authorization: `Bearer ${BUYER_JWT}` } });
                 return ok(data);
             }
             // ── get_compliance_dossier (Phase 11 M4) ───────────────────────────────
@@ -848,6 +894,26 @@ export async function dispatchTool(name, args) {
                 const data = await opeddFetch(`/api?${params.toString()}`);
                 return ok(data);
             }
+            // ── push_content ───────────────────────────────────────────────────────
+            case "push_content": {
+                if (!PUB_BEARER && !API_KEY) {
+                    return err("OPEDD_PUB_BEARER env var is required for this tool (your opedd_pub_ publisher key).");
+                }
+                const { articles } = args;
+                if (!Array.isArray(articles) || articles.length === 0) {
+                    return err("`articles` must be a non-empty array (1–100 items).");
+                }
+                if (articles.length > 100) {
+                    return err(`Too many articles in one call (${articles.length}). Send at most 100 per call and batch the rest.`);
+                }
+                // Backend /publishers-content enforces the full strict schema + returns
+                // clear per-article errors; we pass through so the assistant can relay them.
+                const data = await opeddFetch("/publishers-content", {
+                    method: "POST",
+                    body: JSON.stringify({ articles }),
+                });
+                return ok(data);
+            }
             default:
                 return err(`Unknown tool: ${name}`);
         }

package/dist/telemetry.js

@@ -14,11 +14,13 @@
 // so telemetry can never affect a tool call or the server.
 import { PostHog } from "posthog-node";
 import { randomUUID } from "node:crypto";
+// Version sourced from package.json (src/version.ts) — the previous hardcode
+// drifted within one release (reported 0.5.1 while 0.6.0 shipped).
+import { SERVER_VERSION } from "./version.js";
 // Public, write-only PostHog project key (EU cloud, project 218295). Safe to
 // embed — it can only send events, not read data.
 const POSTHOG_KEY = "phc_yfyXBNsf5nZncZBiZNQBBs5RWC3mtWNWpUJv5EfzfBir";
 const POSTHOG_HOST = "https://eu.i.posthog.com";
-const SERVER_VERSION = "0.5.1";
 /** Whether telemetry is allowed (respects OPEDD_MCP_TELEMETRY + DO_NOT_TRACK). Pure — exported for tests. */
 export function isTelemetryEnabled() {
     const t = process.env.OPEDD_MCP_TELEMETRY?.toLowerCase();

package/dist/version.js

@@ -0,0 +1,6 @@
+// Single source of truth for the server version: package.json. The prior
+// pattern (hardcoded string in telemetry.ts) drifted within one release
+// (0.5.1 reported while 0.6.0 shipped) — never hardcode the version again.
+import { createRequire } from "node:module";
+const require = createRequire(import.meta.url);
+export const SERVER_VERSION = require("../package.json").version;

package/package.json

@@ -1,9 +1,18 @@
 {
   "name": "opedd-mcp",
-  "version": "0.5.1",
-  "description": "MCP server for Opedd — discover, purchase, verify, and audit content licenses from AI assistants. Covers Phase 11 buyer-side surfaces + Phase 12 Wave 1 + 3 regulatory surfaces (CDSM Article 4(3) RSL + EU AI Act Article 53 attestation + platform onboarding helper).",
+  "version": "0.6.1",
+  "description": "Licensed content for AI agents \u2014 discover, purchase, verify, and retrieve rights-cleared expert analysis with a verifiable license key per article, on-chain proof, and EU AI Act Article 53 attestation. The alternative to unlicensed scraping for RAG, AI search, and training pipelines.",
   "type": "module",
   "main": "dist/index.js",
+  "mcpName": "io.github.opedd/opedd-mcp",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Opedd/opedd-mcp.git"
+  },
+  "homepage": "https://opedd.com/for-ai-agents",
+  "bugs": {
+    "url": "https://github.com/Opedd/opedd-mcp/issues"
+  },
   "bin": {
     "opedd-mcp": "dist/index.js"
   },
@@ -17,11 +26,17 @@
   },
   "keywords": [
     "mcp",
+    "model-context-protocol",
     "opedd",
-    "licensing",
+    "content-licensing",
+    "licensed-content",
+    "rag",
+    "ai-agents",
+    "eu-ai-act",
+    "copyright",
+    "rights-management",
     "content",
-    "ai",
-    "model-context-protocol"
+    "ai"
   ],
   "author": "Opedd",
   "license": "MIT",
@@ -41,4 +56,4 @@
   "files": [
     "dist"
   ]
-}
+}