opedd-mcp 0.12.11 → 0.12.13

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. 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, pricing, or that it is not on Opedd yet |
+| `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,13 @@ 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.
+**No account? An agent can pay for one answer on the spot.** `POST https://api.opedd.com/agent-answer` with the same body as `search_passages` (`{"query": "..."}`). The response is HTTP 402 with the price (each article the answer uses, at its publication's own price), the licence and the buyer terms. Pay by card through the [Machine Payments Protocol](https://mpp.dev) (a Stripe shared payment token, at least 0.50 USD; the rest stays as credit on a search key returned with the answer) and retry. Machine-readable: [api.opedd.com/openapi.json](https://api.opedd.com/openapi.json).
+
+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 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.",
+            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. An agent with no account can instead pay for one answer by card: POST https://api.opedd.com/agent-answer with the same body (HTTP 402, Machine Payments Protocol).",
             inputSchema: {
                 type: "object",
                 required: ["query"],
@@ -480,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. " +
@@ -703,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: {
@@ -712,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)",
@@ -781,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"),
@@ -834,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` +
@@ -936,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;
@@ -1010,7 +911,9 @@ export async function dispatchTool(name, args, creds = ENV_CREDS) {
                     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 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).");
+                        "OPEDD_BUYER_TOKEN (local). Or, without an account, pay for this one answer by card: POST https://api.opedd.com/agent-answer " +
+                        "with {\"query\": \"...\"}; it answers HTTP 402 with the price and the licence, through the Machine Payments Protocol " +
+                        "(at least 0.50 USD; the rest stays as credit). To see what Opedd covers first, use search_content or publisher_directory (free, no key).");
                 }
                 const envelope = (await opeddFetch(creds, "/search", {
                     method: "POST",
@@ -1266,7 +1169,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.
@@ -1297,8 +1200,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.11",
+  "version": "0.12.13",
   "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",