Agentic Licensing Protocol

    Built for AI agents

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

    Every license issued is registered on-chain - Tempo · OpeddRegistry.sol

    License Types

    Three license categories, one API

    Editorial

    One-time per-article license for human republication and reuse - the only license_type sold on /agent-purchase and the Publisher API purchase actions.

    license_type: "human"
    Archive

    Full-catalog human access, time-bounded. Subscription-priced - purchased via Stripe Checkout, not the one-time purchase endpoints.

    human_full_archive
    Enterprise AI

    AI retrieval, training, RAG, and fine-tuning access is an enterprise subscription - self-serve metered plans from publisher pages and the buyer catalog, or POST /enterprise-license (requires terms_version, the accepted Master Services Agreement version).

    POST /enterprise-license

    AI access is an enterprise subscription - browse metered plans at /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

    Agent Purchase

    /agent-purchase

    Autonomous acquisition of one-time human per-article licenses. Pay via Stripe payment method; requires terms_accepted_at - fail-closed assent to opedd.com/terms. Returns a license key immediately - no human checkout flow.

    GET

    Verify License

    /verify-license?key={key}

    Cryptographic proof of license validity with on-chain verification via Tempo. Returns holder, covered content, license type, expiry, and blockchain proof.

    GET

    Registry of Proof

    /registry?license_key={key}

    Query the immutable on-chain license registry by key, article, publisher, or browse the global feed. Every issued license is registered on the Tempo blockchain.

    Bearer opedd_pub_

    Publisher API

    /api

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

    POST

    Buyer Webhooks

    /register-buyer-webhook

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

    Quick Start

    Discover, license, and verify in three calls

    Your agent discovers a publisher's catalog, acquires a license with Stripe, and gets cryptographic on-chain 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.articles[0] → { id, title, human_price, ai_price, ... }
    
    // 2. Purchase a license (Stripe payment method)
    const license = await fetch(
      "https://api.opedd.com/agent-purchase",
      {
        method: "POST",
        headers: { "Content-Type": "application/json" },
          body: JSON.stringify({
          article_id: manifest.articles[0].id,
          license_type: "human",          // one-time per-article human license -
                                          // the only type sold on this endpoint
                                          // (AI access = enterprise subscription)
          buyer_email: "pipeline@yourco.com",
          buyer_name: "RAG Pipeline v2",
          organization: "YourCo AI Labs",
          intended_use: "editorial",      // personal | editorial | commercial
                                          // ai_training | corporate
          // Fail-closed assent: the agent must FIRST obtain the buyer's genuine
          // acceptance of opedd.com/terms, then pass the acceptance timestamp.
          terms_accepted_at: new Date().toISOString(),
          payment: {
            method: "stripe_pm",
            payment_method_id: "pm_xxxxxxxxxxxx",
          },
        }),
      }
    ).then(r => r.json());
    
    console.log(license.data.license_key);
    // → "OPEDD-A7X9-K3M2" (registered on-chain on Tempo)
    
    // 3. Verify at any time
    const proof = await fetch(
      `https://api.opedd.com/verify-license?key=${license.data.license_key}`
    ).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_pub_ header to access your full catalog, run batch purchases, 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
    purchaseSingle-article license purchase
    batch_purchaseBulk license acquisition
    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_pub_your_key_here" },
      }
    ).then(r => r.json());
    
    // Batch purchase for a content pipeline
    const batch = await fetch("https://api.opedd.com/api", {
      method: "POST",
      headers: {
        "Content-Type": "application/json",
        Authorization: "Bearer opedd_pub_your_key_here",
      },
      body: JSON.stringify({
        action: "batch_purchase",
        items: [                          // max 50 items per batch
          { article_id: "id-1", license_type: "human" },
          { article_id: "id-2", license_type: "human" },
          { article_id: "id-3", license_type: "human" },
        ],
        buyer_email: "pipeline@yourco.com",
        // Fail-closed assent - record the buyer's genuine acceptance of
        // opedd.com/terms before purchasing.
        terms_accepted_at: new Date().toISOString(),
      }),
    }).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 on-chain registry without leaving the conversation.

    npx opedd-mcp

    17 tools — highlights

    lookup_contentSearch Opedd's catalog by topic, publisher, or URL
    purchase_licenseAcquire a license key for any article in one call
    verify_licenseCheck validity and on-chain 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_EMAIL": "you@yourco.com",
            "OPEDD_PAYMENT_METHOD_ID": "pm_xxxxxxxxxxxx",
            "OPEDD_BUYER_TOKEN": "opedd_buyer_live_..."
          }
        }
      }
    }
    On-Chain Registry

    Every license lives on Tempo

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

    0x647da2435b831f15f5e5f39c113cfb0a553f11b8
    Network
    Tempo
    Status
    Live
    Payment
    Stripe
    Proof
    On-chain

    Start licensing content today

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