opedd-mcp 0.1.0

package/README.md

@@ -0,0 +1,107 @@
+# opedd-mcp
+
+An [MCP (Model Context Protocol)](https://modelcontextprotocol.io) server for the [Opedd](https://opedd.com) licensing protocol. Lets AI assistants (Claude Desktop, Cursor, Windsurf, or any MCP-compatible host) discover, purchase, and verify content licenses autonomously — mid-conversation, without opening a browser.
+
+## What it does
+
+Exposes 4–5 tools to any AI assistant:
+
+| Tool | Description |
+|------|-------------|
+| `lookup_content` | Look up an article by URL — returns title, publisher, pricing |
+| `purchase_license` | Buy a license with a Stripe payment method — returns license key |
+| `verify_license` | Verify a license key — returns validity, article, publisher, blockchain proof |
+| `browse_registry` | Browse the public Opedd registry (global or by publisher) |
+| `list_publisher_content` | *(requires API key)* List your own articles with pricing and stats |
+
+## Install
+
+```bash
+npm install -g opedd-mcp
+```
+
+Or run directly with npx:
+
+```bash
+npx opedd-mcp
+```
+
+## Configuration
+
+Set environment variables to pre-configure the server:
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `OPEDD_BUYER_EMAIL` | Recommended | Your email — used as default for all purchases |
+| `OPEDD_PAYMENT_METHOD_ID` | Recommended | Stripe `pm_...` ID — used for autonomous purchasing |
+| `OPEDD_API_KEY` | Optional | Publisher API key (`op_...`) — enables `list_publisher_content` |
+| `OPEDD_API_URL` | Optional | Override the API base URL (default: Opedd production) |
+
+> **Getting a Stripe payment method ID**: Save a card in your Stripe account and retrieve the `pm_...` ID via the [Stripe API](https://stripe.com/docs/api/payment_methods).
+
+## Claude Desktop setup
+
+Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "opedd": {
+      "command": "npx",
+      "args": ["opedd-mcp"],
+      "env": {
+        "OPEDD_BUYER_EMAIL": "you@yourcompany.com",
+        "OPEDD_PAYMENT_METHOD_ID": "pm_..."
+      }
+    }
+  }
+}
+```
+
+## Cursor / Windsurf setup
+
+Add to your MCP settings:
+
+```json
+{
+  "opedd": {
+    "command": "npx opedd-mcp",
+    "env": {
+      "OPEDD_BUYER_EMAIL": "you@yourcompany.com",
+      "OPEDD_PAYMENT_METHOD_ID": "pm_..."
+    }
+  }
+}
+```
+
+## Example usage
+
+Once configured, you can ask your AI assistant:
+
+> "Look up the licensing options for this article: https://theinformation.com/articles/..."
+
+> "Purchase a human republication license for that article on my behalf."
+
+> "Verify license key OP-XXXX-XXXX and tell me what it covers."
+
+> "Browse the latest licenses from The Information publisher."
+
+The assistant will call the appropriate Opedd tools, show you the results, and—if you've pre-configured a payment method—can complete a purchase autonomously.
+
+## 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.
+
+## Development
+
+```bash
+git clone https://github.com/Opedd/opedd-mcp
+cd opedd-mcp
+npm install
+npm run dev   # runs with tsx (no build step)
+npm run build # compiles to dist/
+```
+
+## License
+
+MIT

package/dist/index.js

@@ -0,0 +1,255 @@
+#!/usr/bin/env node
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+// ─── Configuration ────────────────────────────────────────────────────────────
+const API_BASE = process.env.OPEDD_API_URL ??
+    "https://djdzcciayennqchjgybx.supabase.co/functions/v1";
+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_...)
+// ─── HTTP helpers ─────────────────────────────────────────────────────────────
+async function opeddFetch(path, options = {}) {
+    const url = `${API_BASE}${path}`;
+    const headers = {
+        "Content-Type": "application/json",
+        ...(API_KEY ? { "X-API-Key": API_KEY } : {}),
+        ...(options.headers ?? {}),
+    };
+    const res = await fetch(url, { ...options, headers });
+    return res.json();
+}
+function ok(data) {
+    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+}
+function err(msg) {
+    return { content: [{ type: "text", text: `Error: ${msg}` }], isError: true };
+}
+// ─── Tool definitions ─────────────────────────────────────────────────────────
+const TOOLS = [
+    {
+        name: "lookup_content",
+        description: "Look up a piece of content on the Opedd registry by URL. " +
+            "Returns the article title, publisher, available license types, and pricing " +
+            "(human republication price and AI training/inference price). " +
+            "Always call this first to check if content is licensable and what it costs.",
+        inputSchema: {
+            type: "object",
+            required: ["url"],
+            properties: {
+                url: {
+                    type: "string",
+                    description: "The canonical URL of the article or content to look up",
+                },
+            },
+        },
+    },
+    {
+        name: "purchase_license",
+        description: "Purchase a content license from the Opedd protocol using a Stripe payment method. " +
+            "Returns a license key (format: OP-XXXX-XXXX) and a certificate URL. " +
+            "The buyer receives a Handshake Email with their license key. " +
+            "Set OPEDD_BUYER_EMAIL and OPEDD_PAYMENT_METHOD_ID env vars to avoid passing them on every call. " +
+            "License types: 'human' = republication rights, 'ai' = training dataset rights, 'ai_inference' = inference/RAG rights.",
+        inputSchema: {
+            type: "object",
+            required: ["license_type"],
+            properties: {
+                article_url: {
+                    type: "string",
+                    description: "URL of the article to license (use this OR article_id)",
+                },
+                article_id: {
+                    type: "string",
+                    description: "Opedd article UUID (use this OR article_url)",
+                },
+                license_type: {
+                    type: "string",
+                    enum: ["human", "ai", "ai_inference"],
+                    description: "human = republication/editorial rights, ai = training dataset rights, ai_inference = inference/RAG rights",
+                },
+                buyer_email: {
+                    type: "string",
+                    description: "Email address for the license. Falls back to OPEDD_BUYER_EMAIL env var.",
+                },
+                buyer_name: {
+                    type: "string",
+                    description: "Full name of the buyer (for the license record and certificate)",
+                },
+                buyer_organization: {
+                    type: "string",
+                    description: "Organization or company name (for enterprise/editorial licenses)",
+                },
+                intended_use: {
+                    type: "string",
+                    enum: ["personal", "editorial", "commercial", "ai_training", "corporate"],
+                    description: "Intended use of the licensed content",
+                },
+                payment_method_id: {
+                    type: "string",
+                    description: "Stripe payment method ID (pm_...). Falls back to OPEDD_PAYMENT_METHOD_ID env var.",
+                },
+            },
+        },
+    },
+    {
+        name: "verify_license",
+        description: "Verify the authenticity of an Opedd license key. " +
+            "Returns license details including: article title, publisher, license type, " +
+            "issue date, amount paid, buyer info, and blockchain proof status. " +
+            "Use this to confirm a license is valid before using licensed content.",
+        inputSchema: {
+            type: "object",
+            required: ["license_key"],
+            properties: {
+                license_key: {
+                    type: "string",
+                    description: "The license key to verify (format: OP-XXXX-XXXX)",
+                },
+            },
+        },
+    },
+    {
+        name: "browse_registry",
+        description: "Browse the public Opedd license registry. " +
+            "Returns recently issued licenses and licensable content. " +
+            "Filter by publisher_id to explore all content from a specific publisher. " +
+            "Filter by article_id to see all licenses issued for a specific article.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                publisher_id: {
+                    type: "string",
+                    description: "Filter results to a specific publisher (UUID)",
+                },
+                article_id: {
+                    type: "string",
+                    description: "Filter results to a specific article (UUID)",
+                },
+                limit: {
+                    type: "number",
+                    description: "Number of results to return (default: 10, max: 50)",
+                },
+            },
+        },
+    },
+];
+// If a publisher API key is configured, expose publisher-specific tooling
+if (API_KEY) {
+    TOOLS.push({
+        name: "list_publisher_content",
+        description: "List all licensable articles for the authenticated publisher (requires OPEDD_API_KEY). " +
+            "Returns articles with titles, descriptions, pricing, and sales statistics. " +
+            "Use article IDs from this list to purchase licenses via purchase_license.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                limit: {
+                    type: "number",
+                    description: "Number of results (default: 20, max: 100)",
+                },
+                type: {
+                    type: "string",
+                    enum: ["human", "ai"],
+                    description: "Filter by license type availability",
+                },
+                offset: {
+                    type: "number",
+                    description: "Pagination offset (default: 0)",
+                },
+            },
+        },
+    });
+}
+// ─── MCP Server ───────────────────────────────────────────────────────────────
+const server = new Server({ name: "opedd-mcp", version: "0.1.0" }, { capabilities: { tools: {} } });
+server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: TOOLS }));
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args = {} } = request.params;
+    try {
+        switch (name) {
+            // ── lookup_content ─────────────────────────────────────────────────────
+            case "lookup_content": {
+                const { url } = args;
+                if (!url)
+                    return err("url is required");
+                const data = await opeddFetch(`/lookup-article?url=${encodeURIComponent(url)}`);
+                return ok(data);
+            }
+            // ── 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;
+                if (!article_url && !article_id) {
+                    return err("Either article_url or article_id is required");
+                }
+                const buyerEmail = argEmail || BUYER_EMAIL;
+                if (!buyerEmail) {
+                    return err("buyer_email is required (or set the OPEDD_BUYER_EMAIL env var)");
+                }
+                const paymentMethodId = argPm || PAYMENT_METHOD_ID;
+                if (!paymentMethodId) {
+                    return err("payment_method_id is required (or set the OPEDD_PAYMENT_METHOD_ID env var). " +
+                        "Get a Stripe payment method ID by saving a card at stripe.com/docs/api/payment_methods.");
+                }
+                const body = {
+                    license_type,
+                    buyer_email: buyerEmail,
+                    payment: { method: "stripe_pm", payment_method_id: paymentMethodId },
+                    ...(article_id ? { article_id } : { article_url }),
+                    ...(buyer_name ? { buyer_name } : {}),
+                    ...(buyer_organization ? { buyer_organization } : {}),
+                    ...(intended_use ? { intended_use } : {}),
+                };
+                const data = await opeddFetch("/agent-purchase", {
+                    method: "POST",
+                    body: JSON.stringify(body),
+                });
+                return ok(data);
+            }
+            // ── verify_license ─────────────────────────────────────────────────────
+            case "verify_license": {
+                const { license_key } = args;
+                if (!license_key)
+                    return err("license_key is required");
+                const data = await opeddFetch(`/verify-license?key=${encodeURIComponent(license_key)}`);
+                return ok(data);
+            }
+            // ── browse_registry ────────────────────────────────────────────────────
+            case "browse_registry": {
+                const { publisher_id, article_id, limit = 10 } = args;
+                const params = new URLSearchParams();
+                if (publisher_id)
+                    params.set("publisher_id", publisher_id);
+                if (article_id)
+                    params.set("article_id", article_id);
+                params.set("limit", String(Math.min(Number(limit), 50)));
+                const data = await opeddFetch(`/registry?${params.toString()}`);
+                return ok(data);
+            }
+            // ── list_publisher_content ─────────────────────────────────────────────
+            case "list_publisher_content": {
+                if (!API_KEY) {
+                    return err("OPEDD_API_KEY env var is required for this tool");
+                }
+                const { limit = 20, type, offset = 0 } = args;
+                const params = new URLSearchParams({ action: "articles" });
+                params.set("limit", String(Math.min(Number(limit), 100)));
+                params.set("offset", String(Number(offset)));
+                if (type)
+                    params.set("type", type);
+                const data = await opeddFetch(`/api?${params.toString()}`);
+                return ok(data);
+            }
+            default:
+                return err(`Unknown tool: ${name}`);
+        }
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        return err(`Request failed: ${msg}`);
+    }
+});
+// ─── Start ────────────────────────────────────────────────────────────────────
+const transport = new StdioServerTransport();
+await server.connect(transport);
+console.error("[opedd-mcp] Server running on stdio");

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "opedd-mcp",
+  "version": "0.1.0",
+  "description": "MCP server for Opedd — discover, purchase, and verify content licenses from AI assistants",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "opedd-mcp": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts"
+  },
+  "keywords": [
+    "mcp",
+    "opedd",
+    "licensing",
+    "content",
+    "ai",
+    "model-context-protocol"
+  ],
+  "author": "Opedd",
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.0.0"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}

package/src/index.ts

@@ -0,0 +1,336 @@
+#!/usr/bin/env node
+
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import {
+  CallToolRequestSchema,
+  ListToolsRequestSchema,
+  type Tool,
+} from "@modelcontextprotocol/sdk/types.js";
+
+// ─── Configuration ────────────────────────────────────────────────────────────
+
+const API_BASE =
+  process.env.OPEDD_API_URL ??
+  "https://djdzcciayennqchjgybx.supabase.co/functions/v1";
+
+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_...)
+
+// ─── HTTP helpers ─────────────────────────────────────────────────────────────
+
+async function opeddFetch(path: string, options: RequestInit = {}): Promise<unknown> {
+  const url = `${API_BASE}${path}`;
+  const headers: Record<string, string> = {
+    "Content-Type": "application/json",
+    ...(API_KEY ? { "X-API-Key": API_KEY } : {}),
+    ...(options.headers as Record<string, string> ?? {}),
+  };
+  const res = await fetch(url, { ...options, headers });
+  return res.json();
+}
+
+// ─── MCP response helpers ─────────────────────────────────────────────────────
+
+type TextContent = { type: "text"; text: string };
+type ToolResult = { content: TextContent[]; isError?: boolean };
+
+function ok(data: unknown): ToolResult {
+  return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+}
+
+function err(msg: string): ToolResult {
+  return { content: [{ type: "text", text: `Error: ${msg}` }], isError: true };
+}
+
+// ─── Tool definitions ─────────────────────────────────────────────────────────
+
+const TOOLS: Tool[] = [
+  {
+    name: "lookup_content",
+    description:
+      "Look up a piece of content on the Opedd registry by URL. " +
+      "Returns the article title, publisher, available license types, and pricing " +
+      "(human republication price and AI training/inference price). " +
+      "Always call this first to check if content is licensable and what it costs.",
+    inputSchema: {
+      type: "object",
+      required: ["url"],
+      properties: {
+        url: {
+          type: "string",
+          description: "The canonical URL of the article or content to look up",
+        },
+      },
+    },
+  },
+  {
+    name: "purchase_license",
+    description:
+      "Purchase a content license from the Opedd protocol using a Stripe payment method. " +
+      "Returns a license key (format: OP-XXXX-XXXX) and a certificate URL. " +
+      "The buyer receives a Handshake Email with their license key. " +
+      "Set OPEDD_BUYER_EMAIL and OPEDD_PAYMENT_METHOD_ID env vars to avoid passing them on every call. " +
+      "License types: 'human' = republication rights, 'ai' = training dataset rights, 'ai_inference' = inference/RAG rights.",
+    inputSchema: {
+      type: "object",
+      required: ["license_type"],
+      properties: {
+        article_url: {
+          type: "string",
+          description: "URL of the article to license (use this OR article_id)",
+        },
+        article_id: {
+          type: "string",
+          description: "Opedd article UUID (use this OR article_url)",
+        },
+        license_type: {
+          type: "string",
+          enum: ["human", "ai", "ai_inference"],
+          description:
+            "human = republication/editorial rights, ai = training dataset rights, ai_inference = inference/RAG rights",
+        },
+        buyer_email: {
+          type: "string",
+          description: "Email address for the license. Falls back to OPEDD_BUYER_EMAIL env var.",
+        },
+        buyer_name: {
+          type: "string",
+          description: "Full name of the buyer (for the license record and certificate)",
+        },
+        buyer_organization: {
+          type: "string",
+          description: "Organization or company name (for enterprise/editorial licenses)",
+        },
+        intended_use: {
+          type: "string",
+          enum: ["personal", "editorial", "commercial", "ai_training", "corporate"],
+          description: "Intended use of the licensed content",
+        },
+        payment_method_id: {
+          type: "string",
+          description:
+            "Stripe payment method ID (pm_...). Falls back to OPEDD_PAYMENT_METHOD_ID env var.",
+        },
+      },
+    },
+  },
+  {
+    name: "verify_license",
+    description:
+      "Verify the authenticity of an Opedd license key. " +
+      "Returns license details including: article title, publisher, license type, " +
+      "issue date, amount paid, buyer info, and blockchain proof status. " +
+      "Use this to confirm a license is valid before using licensed content.",
+    inputSchema: {
+      type: "object",
+      required: ["license_key"],
+      properties: {
+        license_key: {
+          type: "string",
+          description: "The license key to verify (format: OP-XXXX-XXXX)",
+        },
+      },
+    },
+  },
+  {
+    name: "browse_registry",
+    description:
+      "Browse the public Opedd license registry. " +
+      "Returns recently issued licenses and licensable content. " +
+      "Filter by publisher_id to explore all content from a specific publisher. " +
+      "Filter by article_id to see all licenses issued for a specific article.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        publisher_id: {
+          type: "string",
+          description: "Filter results to a specific publisher (UUID)",
+        },
+        article_id: {
+          type: "string",
+          description: "Filter results to a specific article (UUID)",
+        },
+        limit: {
+          type: "number",
+          description: "Number of results to return (default: 10, max: 50)",
+        },
+      },
+    },
+  },
+];
+
+// If a publisher API key is configured, expose publisher-specific tooling
+if (API_KEY) {
+  TOOLS.push({
+    name: "list_publisher_content",
+    description:
+      "List all licensable articles for the authenticated publisher (requires OPEDD_API_KEY). " +
+      "Returns articles with titles, descriptions, pricing, and sales statistics. " +
+      "Use article IDs from this list to purchase licenses via purchase_license.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        limit: {
+          type: "number",
+          description: "Number of results (default: 20, max: 100)",
+        },
+        type: {
+          type: "string",
+          enum: ["human", "ai"],
+          description: "Filter by license type availability",
+        },
+        offset: {
+          type: "number",
+          description: "Pagination offset (default: 0)",
+        },
+      },
+    },
+  });
+}
+
+// ─── MCP Server ───────────────────────────────────────────────────────────────
+
+const server = new Server(
+  { name: "opedd-mcp", version: "0.1.0" },
+  { capabilities: { tools: {} } }
+);
+
+server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: TOOLS }));
+
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+  const { name, arguments: args = {} } = request.params;
+
+  try {
+    switch (name) {
+      // ── lookup_content ─────────────────────────────────────────────────────
+      case "lookup_content": {
+        const { url } = args as { url: string };
+        if (!url) return err("url is required");
+
+        const data = await opeddFetch(
+          `/lookup-article?url=${encodeURIComponent(url)}`
+        );
+        return ok(data);
+      }
+
+      // ── 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 as {
+          article_url?: string;
+          article_id?: string;
+          license_type: string;
+          buyer_email?: string;
+          buyer_name?: string;
+          buyer_organization?: string;
+          intended_use?: string;
+          payment_method_id?: string;
+        };
+
+        if (!article_url && !article_id) {
+          return err("Either article_url or article_id is required");
+        }
+
+        const buyerEmail = argEmail || BUYER_EMAIL;
+        if (!buyerEmail) {
+          return err("buyer_email is required (or set the OPEDD_BUYER_EMAIL env var)");
+        }
+
+        const paymentMethodId = argPm || PAYMENT_METHOD_ID;
+        if (!paymentMethodId) {
+          return err(
+            "payment_method_id is required (or set the OPEDD_PAYMENT_METHOD_ID env var). " +
+            "Get a Stripe payment method ID by saving a card at stripe.com/docs/api/payment_methods."
+          );
+        }
+
+        const body: Record<string, unknown> = {
+          license_type,
+          buyer_email: buyerEmail,
+          payment: { method: "stripe_pm", payment_method_id: paymentMethodId },
+          ...(article_id ? { article_id } : { article_url }),
+          ...(buyer_name ? { buyer_name } : {}),
+          ...(buyer_organization ? { buyer_organization } : {}),
+          ...(intended_use ? { intended_use } : {}),
+        };
+
+        const data = await opeddFetch("/agent-purchase", {
+          method: "POST",
+          body: JSON.stringify(body),
+        });
+        return ok(data);
+      }
+
+      // ── verify_license ─────────────────────────────────────────────────────
+      case "verify_license": {
+        const { license_key } = args as { license_key: string };
+        if (!license_key) return err("license_key is required");
+
+        const data = await opeddFetch(
+          `/verify-license?key=${encodeURIComponent(license_key)}`
+        );
+        return ok(data);
+      }
+
+      // ── browse_registry ────────────────────────────────────────────────────
+      case "browse_registry": {
+        const { publisher_id, article_id, limit = 10 } = args as {
+          publisher_id?: string;
+          article_id?: string;
+          limit?: number;
+        };
+
+        const params = new URLSearchParams();
+        if (publisher_id) params.set("publisher_id", publisher_id);
+        if (article_id) params.set("article_id", article_id);
+        params.set("limit", String(Math.min(Number(limit), 50)));
+
+        const data = await opeddFetch(`/registry?${params.toString()}`);
+        return ok(data);
+      }
+
+      // ── list_publisher_content ─────────────────────────────────────────────
+      case "list_publisher_content": {
+        if (!API_KEY) {
+          return err("OPEDD_API_KEY env var is required for this tool");
+        }
+
+        const { limit = 20, type, offset = 0 } = args as {
+          limit?: number;
+          type?: string;
+          offset?: number;
+        };
+
+        const params = new URLSearchParams({ action: "articles" });
+        params.set("limit", String(Math.min(Number(limit), 100)));
+        params.set("offset", String(Number(offset)));
+        if (type) params.set("type", type);
+
+        const data = await opeddFetch(`/api?${params.toString()}`);
+        return ok(data);
+      }
+
+      default:
+        return err(`Unknown tool: ${name}`);
+    }
+  } catch (e) {
+    const msg = e instanceof Error ? e.message : String(e);
+    return err(`Request failed: ${msg}`);
+  }
+});
+
+// ─── Start ────────────────────────────────────────────────────────────────────
+
+const transport = new StdioServerTransport();
+await server.connect(transport);
+console.error("[opedd-mcp] Server running on stdio");

package/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "Node16",
+    "moduleResolution": "Node16",
+    "outDir": "dist",
+    "rootDir": "src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "resolveJsonModule": true
+  },
+  "include": ["src"],
+  "exclude": ["node_modules", "dist"]
+}