opedd-mcp 0.5.0 → 0.6.0

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)
 
@@ -84,7 +85,7 @@ Set environment variables to pre-configure the server:
 | `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_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

@@ -565,9 +565,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: "0.6.0" }, { capabilities: { tools: {} } });
 server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: TOOLS }));
 server.setRequestHandler(CallToolRequestSchema, async (request) => {
     // Anonymous usage telemetry — captures only the tool name, duration, and
@@ -848,6 +888,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

@@ -16,9 +16,9 @@ import { PostHog } from "posthog-node";
 import { randomUUID } from "node:crypto";
 // 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_zrKQzZLUZikynMWJWMHUiQBgRsJa2fLzDFMdh6HxGU6c";
+const POSTHOG_KEY = "phc_yfyXBNsf5nZncZBiZNQBBs5RWC3mtWNWpUJv5EfzfBir";
 const POSTHOG_HOST = "https://eu.i.posthog.com";
-const SERVER_VERSION = "0.5.0";
+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/package.json

@@ -1,7 +1,7 @@
 {
   "name": "opedd-mcp",
-  "version": "0.5.0",
-  "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.0",
+  "description": "MCP server for Opedd \u2014 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).",
   "type": "module",
   "main": "dist/index.js",
   "bin": {
@@ -41,4 +41,4 @@
   "files": [
     "dist"
   ]
-}
+}