opedd-mcp 0.1.0 → 0.1.1

package/README.md

@@ -90,7 +90,7 @@ The assistant will call the appropriate Opedd tools, show you the results, and
 
 ## Payment methods
 
-Purchases use **Stripe** by default (via `pm_...` payment method IDs). USDC on Base is also supported by the Opedd API — pass `payment: { method: 'usdc', tx_hash: '0x...' }` directly to `agent-purchase` if building a custom integration.
+Purchases use **Stripe** by default (via `pm_...` payment method IDs). USDC on Tempo is also supported by the Opedd API — pass `payment: { method: 'usdc', tx_hash: '0x...' }` directly to `agent-purchase` if building a custom integration.
 
 ## Development
 

package/dist/index.js

@@ -8,6 +8,7 @@ const API_BASE = process.env.OPEDD_API_URL ??
 const BUYER_EMAIL = process.env.OPEDD_BUYER_EMAIL;
 const PAYMENT_METHOD_ID = process.env.OPEDD_PAYMENT_METHOD_ID;
 const API_KEY = process.env.OPEDD_API_KEY; // publisher API key (op_...)
+const BUYER_TOKEN = process.env.OPEDD_BUYER_TOKEN; // buyer API token (bk_live_...)
 // ─── HTTP helpers ─────────────────────────────────────────────────────────────
 async function opeddFetch(path, options = {}) {
     const url = `${API_BASE}${path}`;
@@ -17,7 +18,12 @@ async function opeddFetch(path, options = {}) {
         ...(options.headers ?? {}),
     };
     const res = await fetch(url, { ...options, headers });
-    return res.json();
+    const body = await res.json();
+    if (!res.ok) {
+        const msg = body?.error || body?.message || `HTTP ${res.status}`;
+        throw new Error(msg);
+    }
+    return body;
 }
 function ok(data) {
     return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
@@ -134,6 +140,30 @@ const TOOLS = [
         },
     },
 ];
+// If a buyer token is configured, expose content delivery tooling
+if (BUYER_TOKEN) {
+    TOOLS.push({
+        name: "get_content",
+        description: "Retrieve the full body of a licensed article using a buyer API token (bk_live_...). " +
+            "Requires OPEDD_BUYER_TOKEN env var (create one at opedd.com/licenses after purchasing). " +
+            "Works for per-article licenses (token scoped to that article) and archive licenses (token covers all publisher content). " +
+            "The publisher must have content delivery enabled and must have pushed content for the article.",
+        inputSchema: {
+            type: "object",
+            required: ["article_id"],
+            properties: {
+                article_id: {
+                    type: "string",
+                    description: "The Opedd article UUID to retrieve content for",
+                },
+                buyer_token: {
+                    type: "string",
+                    description: "Buyer API token (bk_live_...). Falls back to OPEDD_BUYER_TOKEN env var.",
+                },
+            },
+        },
+    });
+}
 // If a publisher API key is configured, expose publisher-specific tooling
 if (API_KEY) {
     TOOLS.push({
@@ -226,6 +256,19 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 const data = await opeddFetch(`/registry?${params.toString()}`);
                 return ok(data);
             }
+            // ── get_content ────────────────────────────────────────────────────────
+            case "get_content": {
+                const { article_id, buyer_token: argToken } = args;
+                if (!article_id)
+                    return err("article_id is required");
+                const token = argToken || BUYER_TOKEN;
+                if (!token) {
+                    return err("buyer_token is required (or set the OPEDD_BUYER_TOKEN env var). " +
+                        "Create a token at opedd.com/licenses after purchasing a license.");
+                }
+                const data = await opeddFetch(`/content-delivery?article_id=${encodeURIComponent(article_id)}`, { headers: { Authorization: `Bearer ${token}` } });
+                return ok(data);
+            }
             // ── list_publisher_content ─────────────────────────────────────────────
             case "list_publisher_content": {
                 if (!API_KEY) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opedd-mcp",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "MCP server for Opedd — discover, purchase, and verify content licenses from AI assistants",
   "type": "module",
   "main": "dist/index.js",

package/src/index.ts

@@ -17,6 +17,7 @@ const API_BASE =
 const BUYER_EMAIL = process.env.OPEDD_BUYER_EMAIL;
 const PAYMENT_METHOD_ID = process.env.OPEDD_PAYMENT_METHOD_ID;
 const API_KEY = process.env.OPEDD_API_KEY; // publisher API key (op_...)
+const BUYER_TOKEN = process.env.OPEDD_BUYER_TOKEN; // buyer API token (bk_live_...)
 
 // ─── HTTP helpers ─────────────────────────────────────────────────────────────
 
@@ -28,7 +29,12 @@ async function opeddFetch(path: string, options: RequestInit = {}): Promise<unkn
     ...(options.headers as Record<string, string> ?? {}),
   };
   const res = await fetch(url, { ...options, headers });
-  return res.json();
+  const body = await res.json();
+  if (!res.ok) {
+    const msg = (body as any)?.error || (body as any)?.message || `HTTP ${res.status}`;
+    throw new Error(msg);
+  }
+  return body;
 }
 
 // ─── MCP response helpers ─────────────────────────────────────────────────────
@@ -161,6 +167,32 @@ const TOOLS: Tool[] = [
   },
 ];
 
+// If a buyer token is configured, expose content delivery tooling
+if (BUYER_TOKEN) {
+  TOOLS.push({
+    name: "get_content",
+    description:
+      "Retrieve the full body of a licensed article using a buyer API token (bk_live_...). " +
+      "Requires OPEDD_BUYER_TOKEN env var (create one at opedd.com/licenses after purchasing). " +
+      "Works for per-article licenses (token scoped to that article) and archive licenses (token covers all publisher content). " +
+      "The publisher must have content delivery enabled and must have pushed content for the article.",
+    inputSchema: {
+      type: "object",
+      required: ["article_id"],
+      properties: {
+        article_id: {
+          type: "string",
+          description: "The Opedd article UUID to retrieve content for",
+        },
+        buyer_token: {
+          type: "string",
+          description: "Buyer API token (bk_live_...). Falls back to OPEDD_BUYER_TOKEN env var.",
+        },
+      },
+    },
+  });
+}
+
 // If a publisher API key is configured, expose publisher-specific tooling
 if (API_KEY) {
   TOOLS.push({
@@ -299,6 +331,29 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         return ok(data);
       }
 
+      // ── get_content ────────────────────────────────────────────────────────
+      case "get_content": {
+        const { article_id, buyer_token: argToken } = args as {
+          article_id: string;
+          buyer_token?: string;
+        };
+        if (!article_id) return err("article_id is required");
+
+        const token = argToken || BUYER_TOKEN;
+        if (!token) {
+          return err(
+            "buyer_token is required (or set the OPEDD_BUYER_TOKEN env var). " +
+            "Create a token at opedd.com/licenses after purchasing a license."
+          );
+        }
+
+        const data = await opeddFetch(
+          `/content-delivery?article_id=${encodeURIComponent(article_id)}`,
+          { headers: { Authorization: `Bearer ${token}` } }
+        );
+        return ok(data);
+      }
+
       // ── list_publisher_content ─────────────────────────────────────────────
       case "list_publisher_content": {
         if (!API_KEY) {