Opedd — Licensed Content for AI

Measured conclusion: Alive, not deep-tested. L2 outcome: not_attempted.

Content licensing for the AI era: licensed, rights-cleared content for AI agents.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "Opedd — Licensed Content for AI": {
      "url": "https://mcp.opedd.com/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (17)

• lookup_content read-only

  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).

  Parameters:

  • url (required) — string — The canonical URL of the article or content to look up

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• request_publication

  Asks Opedd to tell you when a publication it does not carry yet becomes available to license. Use it after lookup_content says an article is not on Opedd. Records the request against the email given; nothing is bought. If the publication is already on Opedd, returns its licensing page instead. Free; no key needed.

  Parameters:

  • url (required) — string — The web address of the publication or of one of its articles.
  • email (required) — string — Where Opedd should write when the publication is available (the user's email, with their consent).
  • name — string — Optional: the requester's name.
  • note — string — Optional: what the content is needed for (max 1000 characters).
  • organization — string — Optional: the requester's company or fund.

  Hints: read-only no · destructive no · idempotent yes · open-world no

• search_content read-only

  Full-text search of the articles licensable on Opedd. Returns matching articles with the publication, prices, word count and a short description; never article text. Supports quoted phrases and -word to exclude a word. Free; no key needed.

  Parameters:

  • query (required) — string — Search words (max 200 characters).
  • limit — number — Max results (default 20, max 50).
  • publisher — string — Optional publisher slug to search within.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• verify_license read-only

  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.

  Parameters:

  • license_key (required) — string — The license key to verify (format: OP-XXXX-XXXX)

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• browse_registry read-only

  Lists licences recently issued on Opedd and the content they cover. Filters: publisher_id and article_id. Public; no key needed.

  Parameters:

  • limit — number — Number of results to return (default: 10, max: 50)
  • article_id — string — Filter results to a specific article (UUID)
  • publisher_id — string — Filter results to a specific publisher (UUID)

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• publisher_directory read-only

  Lists the publications on Opedd with their article counts, licences, prices and sample articles. Filters: category (case-insensitive substring), min_articles and verified status. Public; no key needed.

  Parameters:

  • limit — number — Page size cap.
  • offset — number — Pagination offset.
  • category — string — Case-insensitive substring filter on publisher category (e.g. 'finance', 'AI').
  • verified — string — 'true' to show only verified publishers (default), 'false' for unverified.
  • min_articles — number — Filter to publishers with at least this many licensable articles.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• rsl_get read-only

  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 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 the raw RSL Standard JSON manifest. This is the publisher's own declaration. It is not a compliance attestation for a buyer (use article_53_attestation for that).

  Parameters:

  • publisher_id (required) — string — UUID of the publisher whose RSL manifest to fetch. Publisher must be verified.
  • jsonld — boolean — If true, request JSON-LD shape (Accept: application/ld+json) with embedded HMAC-SHA256 signed receipt. Default false returns raw RSL Standard JSON shape.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• place_licence_order

  Place a licence order with Opedd for one or more publishers. One order = one licence and one billing mode; each publisher becomes its own Schedule priced from that publisher's settings (publishers that do not offer it are returned in `unavailable` and never charged). Licences: 'enterprise' (AI answers: 'monthly' full text per article, or 'metered' pay per answer, read through search_passages only; self-serve buyers need no order for this, the licence created when they add a card at sign-up already covers every publisher offering a per-answer price), 'archive' (Full catalogue: everything the publisher published up to the order date, kept permanently, not for AI training: 'one_time', full text in the feed), 'training' (AI training of the back catalogue up to the order date: 'one_time', bulk export via stream_feed_ndjson), 'display' (client display: 'monthly', quantity = number of end clients). A monthly AI answers subscription only covers articles published from the day it starts; set include_archive=true on a 'enterprise' + 'monthly' order to add each publisher's Full catalogue in the same order (complete access). Returns the order, its lines, the access key (works once paid) and hosted_invoice_url — the buyer (your principal) pays there. Requires a buyer session (OPEDD_BUYER_JWT) and terms_accepted=true after the buyer has accepted the Opedd Master Services Agreement (opedd.com/terms).

  Parameters:

  • licence (required) — string — enterprise = AI answers, archive = Full catalogue (everything published up to the order date, kept permanently, no AI training), training = AI training, display = client display
  • billing_mode (required) — string — enterprise: monthly | metered; archive: one_time; training: one_time; display: monthly
  • publisher_ids (required) — array — Publisher UUIDs (1-500; at most 18 for metered)
  • terms_accepted (required) — boolean — REQUIRED. Set true only after the buyer has accepted the Opedd Master Services Agreement at opedd.com/terms. The current version label is recorded with the order; orders without genuine acceptance are rejected.
  • quantity — number — display only: number of end clients (1-500)
  • include_archive — boolean — Optional, monthly AI answers only (licence 'enterprise' + billing_mode 'monthly'). true adds each publisher's Full catalogue to the same order: everything published before the order date, kept permanently, not for AI training. Publishers that do not sell their Full catalogue are returned in `unavailable`.

  Hints: read-only no · destructive no · idempotent no · open-world no

• search_passages

  When the user asks a question that one of the publications on Opedd covers, call search_passages before answering from your own knowledge, and cite the passages it returns. Do not call it for questions none of them cover. Publications on Opedd now: Understanding AI (Technology); Geopolitical Dispatch (Geopolitics); The Realistic Optimist (Technology); SemiVision (Technology); Embedded Finance Review (Technology); Quantum Strategy & Geonomics (Markets); Shanaka Anslem Perera (Finance); Matter of Fact (Geopolitics & Foreign Policy). 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.

  Parameters:

  • query (required) — string — The question, in plain words (3–1000 characters).
  • publishers — array — Optional. Only these publications: names as listed by Opedd (e.g. 'Matter of Fact'), opedd.com/p/<slug> addresses or publisher ids. At most 20 names and 100 entries. Narrows the search; never widens it.
  • buyer_token — string — Buyer API key with the 'search' scope. Falls back to OPEDD_BUYER_TOKEN.
  • max_results — number — Optional. Passages to return, 1–10 (default 5). Each distinct article among them is one charge.
  • published_after — string — Optional. Only articles published at or after this instant (ISO 8601, e.g. 2026-01-01).
  • max_charge_cents — number — Optional. The most this question may cost, in US cents (whole number, 1–100000). Articles that would pass it are left out; nothing is charged above it.
  • published_before — string — Optional. Only articles published before this instant (ISO 8601).

  Hints: read-only no · destructive no · idempotent yes · open-world no

• get_content read-only

  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 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 — ask a question with search_passages instead. Articles the publisher stopped licensing answer 403 ARTICLE_EXCLUDED. The publisher must have content delivery enabled and must have pushed content for the article. The response includes author, language, word_count, content_hash, image_urls, canonical_url and tags. On pre-2026-05-14 historical articles, optional fields (author/language/image_urls/canonical_url/tags) may be NULL. NULL means 'data unavailable for this article', NOT 'explicitly empty' — treat as data-missing when filtering; do not interpret as anti-match.

  Parameters:

  • article_id (required) — string — The Opedd article UUID to retrieve content for
  • buyer_token — string — Buyer API token (opedd_buyer_live_* or opedd_buyer_test_*). Falls back to OPEDD_BUYER_TOKEN env var.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• list_feed read-only

  List the articles in a licence order you hold. Content contract: AI training orders include full content_body for the back catalogue up to the order date (content_access 'included'). Every other order is discovery-only (content_body null): AI answers monthly and client display fetch text per article via get_content (content_access 'retrieval_per_article'); pay-per-request fetches billed snippets via get_content (content_access 'metered_per_call'). Returns JSON-format response with paginated articles. Use `since` (ISO 8601) for delta-feed polling — only articles published after the timestamp. Use `cursor` for pagination across pages. Credentials: the order's enterprise access key (OPEDD_ACCESS_KEY, ent_*) OR your buyer API key (OPEDD_BUYER_TOKEN) with order_id — if your account holds exactly one active order, order_id may be omitted; with several, the error lists them. For larger bulk corpus pulls, use stream_feed_ndjson (up to 1000 articles per call vs 200 here).

  Parameters:

  • limit — number — Max articles per response (default: 50, max: 200)
  • since — string — ISO 8601 timestamp — return only articles with published_at > since
  • cursor — string — Opaque cursor from the prior response's data.pagination.next_cursor
  • order_id — string — The licence order to list (UUID, from list_licence_orders). Used with a buyer API key; ignored with an ent_* key.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• stream_feed_ndjson read-only

  Bulk-export the articles in a licence order you hold. Returns up to 1000 articles per call (collected from line-delimited JSON wire format). Same content contract as list_feed: full text for AI training orders only; every other order exports metadata (content_body null) — use get_content for article text. Each exported article is recorded for analytics; a bulk export is not billed per article. Use `since` (ISO 8601) for delta-feed. Use `cursor` to paginate beyond 1000. Backend supports 5000 articles per call; the MCP cap is 1000 for transport reasonability. Real bulk-ingest pipelines should use the Python SDK (pip install opedd) directly — not via MCP. Credentials as list_feed: OPEDD_ACCESS_KEY (ent_*) OR your buyer API key + order_id.

  Parameters:

  • limit — number — Max articles per response (default: 200, max: 1000)
  • since — string — ISO 8601 timestamp — return only articles with published_at > since
  • cursor — string — Opaque cursor from the prior result's meta.next_cursor
  • order_id — string — The licence order to export (UUID). Used with a buyer API key; ignored with an ent_* key.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• list_licence_orders read-only

  Lists the account's licence orders, newest first, each with its lines (publication, licence, unit, price, quantity, status). With order_id, returns one order, each line with its Schedule text and the SHA-256 fingerprint recorded in the public registry on Tempo when the line was issued. Read-only. Requires a buyer API key with the 'audit' scope, a buyer session, or the Opedd connector sign-in.

  Parameters:

  • limit — number — Orders per page (default 20, max 100)
  • cursor — string — Opaque cursor from the prior response's pagination.next_cursor
  • order_id — string — Read one order (UUID) including Schedule documents

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_audit_events read-only

  Returns the account's audit records, one per licensed access, each with its licence terms and public-record attestation (Merkle root and inclusion proof once confirmed). Filter: event_type ('content_access', 'bulk_content_access' or 'compliance_report_generated'). At most 30 days per call. Read-only. Requires a buyer API key with the 'audit' scope, a buyer session, or the Opedd connector sign-in.

  Parameters:

  • to — string — ISO 8601 timestamp upper bound (inclusive)
  • from — string — ISO 8601 timestamp lower bound (inclusive)
  • limit — number — Max events per response (default: 50, max: 200)
  • cursor — string — Opaque cursor for pagination
  • event_type — string — Optional event-class filter

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_buyer_account read-only

  Fetch the authenticated buyer's account profile + masked API key list via GET /buyer-account. Returns the enterprise_buyers row (contact_email, buyer_org, created_at, etc.) plus a list of all buyer-side API keys with masked prefixes (NEVER plaintext post-issuance — only the 12-char key_prefix is returned, e.g. 'opedd_buyer_'). Use cases: post-signup verification ('what was just issued to me?'), buyer dashboard mental model ('what licenses do I currently hold?'), audit prep ('show me the key list before rotation'). For full mid-lifecycle license details (filter_rules, billing, payouts), buyers consult the buyer portal at opedd.com/buyer. Requires OPEDD_BUYER_JWT (JWT-only by design: this surface manages API keys, and a key must never mint keys).

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• article_53_attestation read-only

  Issue a signed compliance attestation (a JWT) for a licence you hold. Returns a freshly-signed HS256 JWT regulators can verify offline against the canonical signing key. Embeds: license context, usage-count over the attestation window, the most-recent Tempo Merkle root, and canonical claims (iss/sub/iat/exp/jti/aud). **The artifact a buyer hands to legal/procurement as evidence of where its content came from.** It attests how your licence was used; the publisher's own licensing declaration is rsl_get. Optional `content_id` scopes the attestation to one article; default is license-wide. Window cap: 365 days. Auth: an audit-scoped buyer API key (OPEDD_BUYER_TOKEN) or OPEDD_BUYER_JWT.

  Parameters:

  • license_id (required) — string — UUID of the enterprise_license OR legacy individual license to attest. Buyer must own it.
  • content_id — string — Optional UUID of a specific article to scope the attestation. Default: license-wide.
  • window_end — string — ISO 8601 upper bound. Default: now. Window may not exceed 365 days (hard cap).
  • window_start — string — ISO 8601 lower bound of the attestation window. Default: now - 90 days.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_compliance_dossier read-only

  Returns the account's compliance dossier for a period: one row per licensed article, with article metadata, licence terms, public-record attestation and compliance flags (the signed attestation, CDSM Article 4(3) and text-and-data-mining reservations). At most 90 days per call; longer periods are paginated with _meta.next_cursor. Each call is recorded in the account's audit log. Requires a buyer API key with the 'audit' scope, a buyer session, or the Opedd connector sign-in.

  Parameters:

  • from (required) — string — ISO 8601 timestamp lower bound (inclusive)
  • to (required) — string — ISO 8601 timestamp upper bound (inclusive). Window cap 90 days.
  • cursor — string — Opaque cursor for pagination

  Hints: read-only yes · destructive no · idempotent yes · open-world no

Publisher website Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.