opedd-mcp 0.12.10 → 0.12.12

package/README.md

@@ -35,7 +35,7 @@ Then add it to your MCP host (see [Claude Desktop / Cursor / Windsurf setup](#cl
 
 ## Hosted endpoint — no install (mcp.opedd.com)
 
-Prefer zero-install? The same 21 tools are served hosted at **`https://mcp.opedd.com/mcp`** (Streamable HTTP). Auth is an `Authorization: Bearer` header with any Opedd key — public discovery tools need no auth at all.
+Prefer zero-install? The same 20 tools are served hosted at **`https://mcp.opedd.com/mcp`** (Streamable HTTP). Auth is an `Authorization: Bearer` header with any Opedd key — public discovery tools need no auth at all.
 
 **Claude Messages API** (production agents):
 
@@ -82,19 +82,18 @@ Key routing: `opedd_sk_*` (legacy `opedd_pub_*`) → publisher tools · `opedd_b
 
 ## What it does
 
-Exposes up to 21 tools to any AI assistant (some are conditional on env vars):
+Exposes up to 20 tools to any AI assistant (some are conditional on env vars):
 
 Every tool carries a `title` and MCP annotations (`readOnlyHint`, `destructiveHint`, `idempotentHint`, `openWorldHint`) so an assistant can tell which tools only read and which spend money or write (v0.12.0).
 
-**Always available — discovery + per-article purchase + onboarding + rights signaling**
+**Always available — discovery + onboarding + rights signaling**
 
 | Tool | Description |
 |------|-------------|
 | `search_content` | **Free discovery.** 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. Returns **no article text** — use `search_passages` to actually read |
-| `search_passages` | **Paid per answer, or included in a monthly subscription.** Ask a question, get licensed passages that answer it, with citations. Per-question licences: charged once per publisher per question at that publisher's own price, capped at 300 words or 25% of the article, counted cumulatively. Monthly AI answers subscriptions (v0.12.0): included, not capped, from the subscription's start. Narrow with `publishers`, `published_after`, `published_before`, `max_results` (1–25). Needs a buyer key with the `search` scope. Re-asking within 24h is free |
-| `lookup_content` | Look up an article by URL — returns title, publisher, pricing, or that it is not on Opedd yet |
+| `search_passages` | **Paid per answer, or included in a monthly subscription.** Ask a question, get licensed passages that answer it, with citations. Pay per answer: charged once per article the answer uses, at that publication's own price per article, each passage capped at 300 words or 25% of the article, counted cumulatively. Monthly AI answers subscriptions (v0.12.0): included, not capped, from the subscription's start. Narrow with `publishers`, `published_after`, `published_before`, `max_results` (1–10, default 5) and cap a question's cost with `max_charge_cents`. Needs a buyer key with the `search` scope. Re-asking within 24h is free |
+| `lookup_content` | Look up an article by URL — returns title, publisher and how to license it, or that it is not on Opedd yet |
 | `request_publication` | Ask to be told when a publication Opedd does not carry yet becomes available (url + email; no key) |
-| `purchase_license` | Buy a Human republication licence for one article 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, public-record proof |
 | `browse_registry` | Browse the public Opedd registry — lists issued LICENSES (use `publisher_directory` to browse publishers themselves) |
 | `publisher_directory` | Browse the public Opedd publisher catalog — paginated publishers with article counts + pricing + sample articles (primary buyer-discovery surface for AI labs) |
@@ -160,8 +159,6 @@ 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 per-article purchasing |
 | `OPEDD_BUYER_TOKEN` | Optional | Buyer API key (`opedd_buyer_live_*`; `opedd_buyer_test_*` for sandbox) — enables `search_passages` (with the `search` scope), `get_content`, `list_feed` + `stream_feed_ndjson` (with `order_id`) |
 | `OPEDD_ACCESS_KEY` | Optional | An order's enterprise access key (`ent_*`) — alternative credential for `list_feed` + `stream_feed_ndjson` |
 | `OPEDD_BUYER_JWT` | Optional | Supabase session JWT from the buyer portal — enables `place_licence_order` + `list_licence_orders` + `get_buyer_account` + `get_audit_events` + `get_compliance_dossier` + `article_53_attestation` |
@@ -201,8 +198,7 @@ Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
       "command": "npx",
       "args": ["opedd-mcp"],
       "env": {
-        "OPEDD_BUYER_EMAIL": "you@yourcompany.com",
-        "OPEDD_PAYMENT_METHOD_ID": "pm_..."
+        "OPEDD_BUYER_TOKEN": "opedd_buyer_live_..."
       }
     }
   }
@@ -218,8 +214,7 @@ Add to your MCP settings:
   "opedd": {
     "command": "npx opedd-mcp",
     "env": {
-      "OPEDD_BUYER_EMAIL": "you@yourcompany.com",
-      "OPEDD_PAYMENT_METHOD_ID": "pm_..."
+      "OPEDD_BUYER_TOKEN": "opedd_buyer_live_..."
     }
   }
 }
@@ -231,7 +226,7 @@ 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."
+> "What do Opedd's publications say about EU chip subsidies? Cite the passages." — uses `search_passages`
 
 > "Verify license key OP-XXXX-XXXX and tell me what it covers."
 
@@ -251,11 +246,11 @@ Once configured, you can ask your AI assistant:
 
 > "What's in my buyer account? Show me my active API keys." — uses `get_buyer_account` (requires `OPEDD_BUYER_JWT`)
 
-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.
+The assistant will call the appropriate Opedd tools and show you the results.
 
-## Payment methods
+## Payment
 
-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.
+Pay-per-answer search is billed to the card on your buyer account (opedd.com/buyer/billing); licence orders are paid through Stripe. Single-article purchases (Human republication, `purchase_license`) were retired on 2026-10-26.
 
 ## Development
 

package/dist/index.d.ts

@@ -2,8 +2,6 @@
 import { type Tool } from "@modelcontextprotocol/sdk/types.js";
 export interface Credentials {
     apiBase: string;
-    buyerEmail?: string;
-    paymentMethodId?: string;
     /** canonical opedd_sk_<32-hex> key (legacy opedd_pub_ accepted) */
     pubBearer?: string;
     /** LEGACY op_<32-hex> — retiring per backend Phase C */

package/dist/index.js

@@ -22,8 +22,6 @@ async function currentTermsVersion(creds) {
 export function envCredentials() {
     return {
         apiBase: process.env.OPEDD_API_URL ?? "https://api.opedd.com",
-        buyerEmail: process.env.OPEDD_BUYER_EMAIL,
-        paymentMethodId: process.env.OPEDD_PAYMENT_METHOD_ID,
         // B91 v0.4.0 (2026-05-26): OPEDD_PUB_BEARER canonical; OPEDD_API_KEY is
         // the legacy op_ alias during the dual-mode transition window.
         pubBearer: process.env.OPEDD_PUB_BEARER,
@@ -188,7 +186,7 @@ function buildTools(has) {
     const TOOLS = [
         {
             name: "lookup_content",
-            description: "Looks up an article on Opedd by its web address. Returns the title, publication, available licence types and prices; for a publication's homepage, the publication and its licensing page; or that it is not on Opedd yet (then request_publication records the request).",
+            description: "Looks up an article on Opedd by its web address. Returns the title, publication and how to license it (pay-per-answer search or a licence order); for a publication's homepage, the publication and its licensing page; or that it is not on Opedd yet (then request_publication records the request).",
             inputSchema: {
                 type: "object",
                 required: ["url"],
@@ -228,60 +226,6 @@ function buildTools(has) {
                 },
             },
         },
-        {
-            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. " +
-                "Single-article purchases are Human republication licences only (license_type 'human'). " +
-                "AI licences (AI answers, AI training, client display) are bought as licence orders: see place_licence_order.",
-            inputSchema: {
-                type: "object",
-                required: ["license_type", "terms_accepted"],
-                properties: {
-                    terms_accepted: {
-                        type: "boolean",
-                        description: "REQUIRED. Set true only after the buyer (your principal) has accepted the Opedd licence terms at opedd.com/terms. " +
-                            "The acceptance timestamp is recorded with the licence; purchases without genuine acceptance are rejected.",
-                    },
-                    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"],
-                        description: "human = Human republication (editorial republication of one article)",
-                    },
-                    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: "Checks an Opedd licence key. Returns the licence details (article title, publication, licence type, issue date, amount paid, buyer and public-record proof status), or that the key was not found.",
@@ -376,8 +320,8 @@ function buildTools(has) {
             description: "Fetch a publisher's RSL Standard manifest (machine-readable licensing terms). " +
                 "Public no-auth endpoint — discovery surface for AI agents/crawlers wanting to know what's licensable " +
                 "from a publisher BEFORE going through the buyer-account signup flow. " +
-                "Returns the 4 canonical license types (ai_retrieval, ai_training, human_per_article, human_full_archive) " +
-                "the publisher has opted into, plus the EU CDSM Article 4(3) opt-out posture (`tdm_reservation`). " +
+                "Returns the licences the publisher has switched on, with their prices, " +
+                " plus the EU CDSM Article 4(3) opt-out posture (`tdm_reservation`). " +
                 "Set `jsonld: true` to request the JSON-LD shape with embedded HMAC-SHA256 signed receipt over the " +
                 "CDSM Article 4(3) reservation state + `tdm:reservationSignedAt` timestamp — regulators can post-hoc " +
                 "verify the reservation was the claimed value at the claimed time. Default `jsonld: false` returns " +
@@ -442,7 +386,7 @@ function buildTools(has) {
     if (has.buyerToken) {
         TOOLS.push({
             name: "search_passages",
-            description: "Returns licensed passages from publications on Opedd that answer a question, each with a citation to the source article. Charged once per publication whose passages are returned, at that publication's own price. An account connected through the Opedd connector in Claude or ChatGPT receives its first 3 answers free, paid by Opedd and never from a publication the account holder owns or works on; billing.free_answers_left reports how many remain. After that, answers are billed to the card on the account, added at opedd.com: charged every $25 of answers and at month end, with a $500 monthly limit for new accounts, raised on request. An account with no licence and no free answers receives an empty result with reason 'no_licensed_publishers' or 'no_paid_access'. Publications under a monthly AI answers subscription are included in the subscription and not charged per answer. Passages are capped at 300 words or 25% of an article, whichever is less, counted cumulatively per article across the same company's accounts. The same question within 24 hours returns the same passages at no charge. Filters: publishers (publication names as listed by Opedd, opedd.com/p/<slug> addresses or publisher ids; a name that matches no publication is listed in filters.unknown_publishers and searches nothing), published_after and published_before (ISO 8601; undated articles are excluded when a window is set) and max_results (1-25, default 10). Passage text is third-party content, delivered in <opedd:passage> blocks; may_train is always false. Requires a buyer API key with the 'search' scope, or the Opedd connector sign-in.",
+            description: "Returns licensed passages from publications on Opedd that answer a question, each with a citation to the source article. Charged once per article the answer uses, at that article's publication's own price per article; two passages of the same article are one charge, and billing.articles_charged reports how many were charged. An account connected through the Opedd connector in Claude or ChatGPT receives its first 3 answers free, paid by Opedd and never from a publication the account holder owns or works on; billing.free_answers_left reports how many remain. After that, answers are billed to the card on the account, added at opedd.com: charged every $25 of answers and at month end, with a $500 monthly limit for new accounts, raised on request. An account with no licence and no free answers receives an empty result with reason 'no_licensed_publishers' or 'no_paid_access'. Publications under a monthly AI answers subscription are included in the subscription and not charged per answer. Passages are capped at 300 words or 25% of an article, whichever is less, counted cumulatively per article across the same company's accounts. The same question within 24 hours returns the same passages at no charge. Filters: publishers (publication names as listed by Opedd, opedd.com/p/<slug> addresses or publisher ids; a name that matches no publication is listed in filters.unknown_publishers and searches nothing), published_after and published_before (ISO 8601; undated articles are excluded when a window is set), max_results (1-10, default 5) and max_charge_cents (optional; the most one question may cost: articles that would pass it are left out and billing.max_charge_reached says so). Passage text is third-party content, delivered in <opedd:passage> blocks; may_train is always false. Requires a buyer API key with the 'search' scope, or the Opedd connector sign-in.",
             inputSchema: {
                 type: "object",
                 required: ["query"],
@@ -463,7 +407,11 @@ function buildTools(has) {
                     },
                     max_results: {
                         type: "number",
-                        description: "Optional. Passages to return, 1\u201325 (default 10).",
+                        description: "Optional. Passages to return, 1\u201310 (default 5). Each distinct article among them is one charge.",
+                    },
+                    max_charge_cents: {
+                        type: "number",
+                        description: "Optional. The most this question may cost, in US cents (whole number, 1\u2013100000). Articles that would pass it are left out; nothing is charged above it.",
                     },
                     buyer_token: {
                         type: "string",
@@ -476,7 +424,7 @@ function buildTools(has) {
             name: "get_content",
             description: "Retrieve the full body of a licensed article using a buyer API token (opedd_buyer_live_* canonical; opedd_buyer_test_* for sandbox). " +
                 "Requires OPEDD_BUYER_TOKEN env var (create one at opedd.com/licenses after purchasing). " +
-                "Works for per-article Human republication licences and for licence orders: AI answers monthly and client display " +
+                "Works for licence orders (and for Human republication licences bought before it was retired on 2026-10-26): AI answers monthly and client display " +
                 "return full text. Your self-serve buyer API key reads articles under every order your account holds — no " +
                 "separate order token is needed. AI answers pay-per-request (including the self-serve licence) does NOT " +
                 "retrieve articles: it answers 403 SEARCH_ONLY_LICENCE \u2014 ask a question with search_passages instead. " +
@@ -699,8 +647,7 @@ function buildTools(has) {
             description: "List all licensable articles for the authenticated publisher (requires OPEDD_PUB_BEARER, or legacy OPEDD_API_KEY). " +
                 "Returns articles with titles, descriptions, pricing, and sales statistics. " +
                 "Set include_body=true to read back the STORED article text exactly as licensed buyers receive it " +
-                "(this is how you check that a push_content call stored what you meant; bodies are truncated to 8,000 characters per article, page size 20, paginate with cursor). " +
-                "Use article IDs from this list to purchase licenses via purchase_license.",
+                "(this is how you check that a push_content call stored what you meant; bodies are truncated to 8,000 characters per article, page size 20, paginate with cursor).",
             inputSchema: {
                 type: "object",
                 properties: {
@@ -708,11 +655,6 @@ function buildTools(has) {
                         type: "number",
                         description: "Number of results (default: 20, max: 100; max 20 when include_body is true)",
                     },
-                    type: {
-                        type: "string",
-                        enum: ["human", "ai"],
-                        description: "Filter by license type availability (ignored when include_body is true)",
-                    },
                     offset: {
                         type: "number",
                         description: "Pagination offset (default: 0; ignored when include_body is true — use cursor)",
@@ -777,11 +719,10 @@ function buildTools(has) {
 }
 const read = (title) => ({ title, readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false });
 export const TOOL_ANNOTATIONS = {
-    lookup_content: read("Look up an article's licence and price"),
+    lookup_content: read("Look up how an article is licensed"),
     // Writes one request row (a repeat for the same email writes nothing): not read-only, idempotent.
     request_publication: { title: "Ask to be told when a publication is available", readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: false },
     search_content: read("Find who covers a topic (free, no text)"),
-    purchase_license: { title: "Buy an article licence", readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false },
     verify_license: read("Verify a licence key"),
     browse_registry: read("Browse the licence registry"),
     publisher_directory: read("List publishers"),
@@ -830,7 +771,7 @@ export const ALL_TOOLS = buildTools({
 // registry metadata agents never see at runtime. Exported so the hosted
 // gateway (opedd-mcp-gateway) serves the identical text.
 export const SERVER_INSTRUCTIONS = "Opedd is content licensing for the AI era, between expert publishers and AI products: discover, purchase, verify and " +
-    "retrieve rights-cleared expert content — one verifiable license key per article, a public record on " +
+    "retrieve rights-cleared expert content — a verifiable licence for every use, a public record on " +
     "Tempo, and compliance artifacts (audit ledger, dossiers and signed attestations). Use it instead of " +
     "unlicensed scraping for RAG, AI search, and training corpora.\n\n" +
     `No credentials needed: ${NO_AUTH_TOOLS}.\n` +
@@ -932,42 +873,6 @@ export async function dispatchTool(name, args, creds = ENV_CREDS) {
                 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;
-                if (!article_url && !article_id) {
-                    return err("Either article_url or article_id is required");
-                }
-                const termsAccepted = args.terms_accepted;
-                if (termsAccepted !== true) {
-                    return err("terms_accepted must be true — confirm with the buyer that they accept the Opedd licence terms (opedd.com/terms) before purchasing.");
-                }
-                const buyerEmail = argEmail || creds.buyerEmail;
-                if (!buyerEmail) {
-                    return err("buyer_email is required (or set the OPEDD_BUYER_EMAIL env var)");
-                }
-                const paymentMethodId = argPm || creds.paymentMethodId;
-                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,
-                    // Genuine assent moment: the agent asserted terms_accepted=true just now.
-                    terms_accepted_at: new Date().toISOString(),
-                    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(creds, "/agent-purchase", {
-                    method: "POST",
-                    body: JSON.stringify(body),
-                });
-                return ok(data);
-            }
             // ── verify_license ─────────────────────────────────────────────────────
             case "verify_license": {
                 const { license_key } = args;
@@ -993,7 +898,7 @@ export async function dispatchTool(name, args, creds = ENV_CREDS) {
             }
             // ── get_content ────────────────────────────────────────────────────────
             case "search_passages": {
-                const { query, buyer_token: argToken, publishers, published_after, published_before, max_results } = args;
+                const { query, buyer_token: argToken, publishers, published_after, published_before, max_results, max_charge_cents } = args;
                 const q = (query ?? "").replace(/\s+/g, " ").trim();
                 if (!q)
                     return err("query is required");
@@ -1004,7 +909,7 @@ export async function dispatchTool(name, args, creds = ENV_CREDS) {
                 const token = argToken || creds.buyerToken;
                 if (!token) {
                     return err("This needs an Opedd buyer key. Sign up at https://opedd.com/buyer/signup (about two minutes): " +
-                        "new accounts start with up to 3 free answers, then each answer is billed at the publication's own price. " +
+                        "new accounts start with up to 3 free answers, then each article an answer uses is billed at its publication's own price. " +
                         "Then pass the key as Authorization: Bearer <key> (hosted server https://mcp.opedd.com/mcp) or " +
                         "OPEDD_BUYER_TOKEN (local). To see what Opedd covers first, use search_content or publisher_directory (free, no key).");
                 }
@@ -1019,6 +924,7 @@ export async function dispatchTool(name, args, creds = ENV_CREDS) {
                         ...(published_after !== undefined ? { published_after } : {}),
                         ...(published_before !== undefined ? { published_before } : {}),
                         ...(max_results !== undefined ? { max_results } : {}),
+                        ...(max_charge_cents !== undefined ? { max_charge_cents } : {}),
                     }),
                 }));
                 return ok(envelope.data ?? envelope);
@@ -1261,7 +1167,7 @@ export async function dispatchTool(name, args, creds = ENV_CREDS) {
                 if (!creds.pubBearer && !creds.apiKey) {
                     return credErr("A publisher key (opedd_sk_*) is required for this tool", "OPEDD_PUB_BEARER", HOW_PUB_BEARER);
                 }
-                const { limit = 20, type, offset = 0, include_body, cursor, id } = args;
+                const { limit = 20, offset = 0, include_body, cursor, id } = args;
                 // include_body (2026-09-14): the OWNER read model — GET /publishers-content
                 // returns the stored body for the key's own rows. Bodies are truncated
                 // here to keep the assistant's context bounded; ?id= returns one in full.
@@ -1292,8 +1198,6 @@ export async function dispatchTool(name, args, creds = ENV_CREDS) {
                 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(creds, `/api?${params.toString()}`);
                 return ok(data);
             }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opedd-mcp",
-  "version": "0.12.10",
+  "version": "0.12.12",
   "description": "Content licensing for the AI era. Licensed, rights-cleared content for AI agents, with a verifiable license key for every article. The MCP alternative to unlicensed scraping for RAG and AI search.",
   "type": "module",
   "main": "dist/index.js",
@@ -48,7 +48,7 @@
     "@types/node": "^22.19.19",
     "tsx": "^4.0.0",
     "typescript": "^5.0.0",
-    "vitest": "^4.1.7"
+    "vitest": "^5.0.5"
   },
   "engines": {
     "node": ">=20"