Agentic Licensing Protocol

    Built for AI agents

    Discover, purchase, and verify content licenses programmatically - with public-record proof on Tempo and a native MCP server for Claude and Cursor.

    Every license issued is recorded in a public registry - Tempo · OpeddRegistry.sol

    License Types

    Three license categories, one API

    Full catalogue

    Everything the publisher published up to the purchase date, kept permanently. One-off price, not for AI training. Ordered via POST /enterprise-license.

    licence: "archive"
    Enterprise AI

    AI answers (monthly full text, or pay per answer through search), AI training (one-off, back catalogue up to the order date) and client display (monthly, per client). Ordered via POST /enterprise-license with a buyer session and terms_version; pay per answer is self-serve once a card is on file.

    POST /enterprise-license

    Pay per answer is self-serve: sign up, add a card, pay only for answers you receive. Monthly, training and client-display licences are ordered from /buyer/browse, or for platform-wide coverage contact sales.

    Core Endpoints

    Purpose-built for autonomous workflows

    Every content licensing operation your agent needs - discovery, acquisition, verification, and proof - maps to a clean REST call.

    GET

    License Discovery

    /.well-known/opedd.json

    Agents discover a publisher's full content catalog - pricing, license types, available articles, and agent instructions - from a single machine-readable manifest.

    POST

    Search

    /search

    Ask a question across licensed publications and get cited passages. Pay per answer: each article an answer uses is charged once, at its publication's price. Buyer API key with the search scope; max_charge_cents caps any one question.

    GET

    Verify License

    /verify-license?key={key}

    Cryptographic proof of license validity, verifiable in the public record on Tempo. Returns holder, covered content, license type, expiry, and the public-record proof.

    GET

    Registry of Proof

    /registry?license_key={key}

    Query the public license registry by key, article, publisher, or browse the global feed. Every issued license is recorded in the public registry on Tempo.

    Bearer opedd_sk_

    Publisher API

    /api

    Server-to-server API for programmatic catalog access. List articles, verify keys, and query usage - all authenticated with your canonical Bearer key (issued via POST /publishers-api-keys).

    POST

    Buyer Webhooks

    /register-buyer-webhook

    Full-catalogue licence holders register a webhook to receive content.published events when new articles are added - enabling live, push-based content delivery pipelines.

    Quick Start

    Discover, search, and verify in three calls

    Your agent discovers a publisher's catalog, acquires a license with Stripe, and gets cryptographic, publicly verifiable proof - all programmatically.

    agent.ts
    // 1. Discover the publisher's catalog
    const manifest = await fetch(
      "https://publisher.com/.well-known/opedd.json"
    ).then(r => r.json());
    
    // manifest.licensing.licences → what this publisher offers, with prices
    
    // 2. Ask a question: cited passages, paid per article used
    const answer = await fetch("https://api.opedd.com/search", {
      method: "POST",
      headers: {
        "Content-Type": "application/json",
        Authorization: "Bearer opedd_buyer_your_key_here",
      },
      body: JSON.stringify({
        query: "Why did EU chip subsidies change in 2026?",
        max_results: 5,                   // 5 by default, up to 10
        max_charge_cents: 100,            // optional cap for this question
      }),
    }).then(r => r.json());
    
    console.log(answer.data.passages[0]);
    // → a licensed passage, with its article and publication
    console.log(answer.data.billing.charged_cents);
    
    // 3. Verify any licence at any time
    const proof = await fetch(
      `https://api.opedd.com/verify-license?key=${licenceKey}`
    ).then(r => r.json());
    
    console.log(proof.data.blockchain_status);
    // → "confirmed" - immutable proof on Tempo
    Publisher API

    Server-to-server integration

    Authenticate with your Authorization: Bearer opedd_sk_ header to access your full catalog, verify keys at scale, and query usage - all server-to-server. Issue your key via POST /publishers-api-keys from Settings → API Keys.

    articlesList and search your article catalog
    verifyVerify any license key
    usageQuery license usage and analytics
    publisher-api.ts
    // Server-to-server: list your articles
    const articles = await fetch(
      "https://api.opedd.com/api?action=articles&limit=50",
      {
        headers: { Authorization: "Bearer opedd_sk_your_key_here" },
      }
    ).then(r => r.json());
    MCP Server

    Native tool for Claude, Cursor & any MCP client

    Install the Opedd MCP server and your AI assistant gains direct access to content licensing - discovering articles, purchasing licenses, verifying proofs, and browsing the public registry without leaving the conversation.

    npx opedd-mcp

    17 tools - highlights

    lookup_contentSearch Opedd's catalog by topic, publisher, or URL
    search_passagesAsk a question and get cited, licensed passages (pay per answer)
    verify_licenseCheck validity and public-record proof of any license key
    browse_registryQuery the global immutable license registry
    list_publisher_contentList all articles from a specific publisher
    claude_desktop_config.json
    // Hosted (zero install) - works in claude.ai, Cursor,
    // Claude Messages API, OpenAI Responses API:
    {
      "mcpServers": {
        "opedd": {
          "url": "https://mcp.opedd.com/mcp",
          "headers": { "Authorization": "Bearer opedd_buyer_live_..." }
        }
      }
    }
    
    // Or local via npm (stdio):
    {
      "mcpServers": {
        "opedd": {
          "command": "npx",
          "args": ["-y", "opedd-mcp"],
          "env": {
            "OPEDD_BUYER_TOKEN": "opedd_buyer_live_..."
          }
        }
      }
    }
    Public Registry

    Every license lives on Tempo

    Every license Opedd issues - AI, full catalogue - is registered on the OpeddRegistry smart contract deployed on Tempo. Verify any license key independently of Opedd's infrastructure.

    0x647da2435b831f15f5e5f39c113cfb0a553f11b8
    Network
    Tempo
    Status
    Live
    Payment
    Stripe
    Proof
    Public record

    Start licensing content today

    Read the full API reference, explore all endpoints, and integrate Opedd into your AI pipeline in minutes.