opedd-mcp

opedd-mcp

Licensed, rights-cleared content for AI agents — the alternative to unlicensed scraping for RAG, AI search, and LLM grounding.

Lets AI assistants (Claude Desktop, Cursor, Windsurf, or any MCP-compatible host) discover, purchase, and verify content licenses autonomously — mid-conversation, without opening a browser. Every license is registered on-chain (Tempo blockchain) with cryptographic proof.

Unlike generic search APIs, Opedd returns content with a verifiable license key — defensible under the EU AI Act and any copyright jurisdiction.

Quick start

npx opedd-mcp

Then add it to your MCP host (see Claude Desktop / Cursor / Windsurf setup below). Discovery + verification tools work with no configuration; purchasing and content retrieval use optional API keys from opedd.com.

Hosted endpoint — no install (mcp.opedd.com)

Prefer zero-install? The same 17 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):

{
  "mcp_servers": [{
    "type": "url",
    "url": "https://mcp.opedd.com/mcp",
    "name": "opedd",
    "authorization_token": "opedd_buyer_live_..."
  }]
}

OpenAI Responses API:

{
  "tools": [{
    "type": "mcp",
    "server_label": "opedd",
    "server_url": "https://mcp.opedd.com/mcp",
    "authorization": "opedd_buyer_live_..."
  }]
}

claude.ai / Claude Desktop custom connector (all plans): Settings → Connectors → Add custom connector → URL https://mcp.opedd.com/mcp; add a Authorization: Bearer <your key> request header for the credentialed tools.

Cursor (.cursor/mcp.json):

{
  "mcpServers": {
    "opedd": {
      "url": "https://mcp.opedd.com/mcp",
      "headers": { "Authorization": "Bearer ${env:OPEDD_KEY}" }
    }
  }
}

Key routing: opedd_pub_* → publisher tools · opedd_buyer_* → content retrieval · ent_* → bulk feeds · buyer-portal JWT → audit/compliance/EU-AI-Act tools. Your key is forwarded per request and never stored by the gateway.

What it does

Exposes up to 17 tools to any AI assistant (some are conditional on env vars):

Always available — discovery + per-article purchase + onboarding + rights signaling

Tool	Description
lookup_content	Look up an article by URL — returns title, publisher, pricing
purchase_license	Buy a single-article license 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, blockchain 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)
purchase_enterprise_license	Buy a bulk enterprise license covering multiple publishers (Phase 10) — returns Stripe client_secret. Requires terms_accepted: true; the current Master Services Agreement version label is recorded with the licence (the backend rejects superseded labels)
rsl_get	Fetch a publisher's RSL Standard manifest — public discovery surface; jsonld: true returns CDSM Article 4(3) signed receipt (Phase 12 W1.1)
detect_platform	Detect the content platform behind a URL — returns suggested onboarding workflow for Substack / Beehiiv / Ghost / Medium / Brevo / custom (Phase 12 W3.1)

Requires OPEDD_BUYER_TOKEN (opedd_buyer_live_*)

Tool	Description
get_content	Retrieve a licensed article — includes 7 Phase 11 M2 RAG metadata fields (author, language, word_count, content_hash, image_urls, canonical_url, tags)

Requires OPEDD_ACCESS_KEY (ent_*) — buyer-side feed surfaces

Tool	Description
list_feed	List articles from a buyer's licensed catalog with since delta-feed support (Phase 11 M5). Flat-fee scopes carry full content_body; metered (filtered-scope) keys get a discovery-only feed (content_body: null, content_access: "metered_per_call") — fetch text via get_content (billed per call)
stream_feed_ndjson	Bulk-export up to 1000 articles per call via NDJSON wire format (Phase 11 M3). Same per-scope content contract as list_feed — metered keys export metadata only

Requires OPEDD_BUYER_JWT (Supabase JWT) — buyer account + audit + compliance + EU AI Act surfaces

Tool	Description
get_buyer_account	Fetch buyer profile + masked API key list — buyer-dashboard mental model
get_audit_events	Per-event audit ledger with Tempo on-chain attestation inclusion proofs inline (Phase 9.x + 10 M5)
get_compliance_dossier	Procurement-defense compliance dossier mapping retrievals to license terms (Phase 11 M4)
article_53_attestation	Signed JWT attesting EU AI Act Article 53(1)(d) compliance for a license — the artifact AI labs hand to legal/procurement (Phase 12 W1.4)

Requires OPEDD_PUB_BEARER (opedd_pub_*) — publisher-side

Tool	Description
list_publisher_content	List your own articles with pricing and stats
push_content	Push your articles to Opedd so AI buyers can license them — 1–100 per call (title/url/html_body required, everything else optional). Onboard your back-catalogue or new posts with no code, straight from your AI assistant.

Regulatory framing (CDSM Article 4 vs EU AI Act Article 53 — never conflated)

Per Opedd's platform invariants (W1.6 amendment):

• rsl_get(publisher_id, jsonld=true) → publisher-side CDSM Article 4(3) opt-out declaration (signed JSON-LD receipt over the reservation state).
• article_53_attestation(license_id) → buyer-side EU AI Act Article 53 attestation (signed HS256 JWT scoped to one license).
• get_compliance_dossier(from, to) → comprehensive procurement-defense dossier covering BOTH frameworks (publisher CDSM reservation honored + buyer Article 53 evidence chain).

These serve different audit-defensibility modes and never share wire format. Tool descriptions cite the W1.6 invariant inline.

Install

npm install -g opedd-mcp

Or run directly with npx:

npx opedd-mcp

Configuration

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 token (opedd_buyer_live_* canonical; opedd_buyer_test_* for sandbox) — enables get_content
OPEDD_ACCESS_KEY	Optional	Enterprise access key (ent_*) — enables list_feed + stream_feed_ndjson
OPEDD_BUYER_JWT	Optional	Supabase session JWT from the buyer portal — enables get_buyer_account + get_audit_events + get_compliance_dossier + article_53_attestation
OPEDD_PUB_BEARER	Optional	Canonical Publisher API Bearer key (opedd_pub_<env>_<32-hex>; issued via POST /publishers-api-keys action=create_api_key) — enables list_publisher_content + push_content. v0.4.0 canonical.
OPEDD_API_KEY	Deprecated	Legacy Publisher API key (op_...) — fallback during the transition window; will stop working when opedd-backend Phase C deploys. Migrate to OPEDD_PUB_BEARER.
OPEDD_API_URL	Optional	Override the API base URL (default: Opedd production)
OPEDD_MCP_TELEMETRY	Optional	Set to 0 to disable anonymous usage telemetry (see below)

Getting a Stripe payment method ID: Save a card in your Stripe account and retrieve the pm_... ID via the Stripe API.

Anonymous usage telemetry

To understand how AI assistants use this server, opedd-mcp sends anonymous telemetry for each tool call: only the tool name, its duration, whether it succeeded, and the server version — plus a random per-process id. It never sends tool parameters, responses, your email, API keys, tokens, content, or your IP. Data goes to Opedd's PostHog (EU region).

To opt out, set either environment variable before starting the server:

OPEDD_MCP_TELEMETRY=0
# or the cross-tool standard:
DO_NOT_TRACK=1

When opted out, no telemetry client is created and nothing is sent.

Claude Desktop setup

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "opedd": {
      "command": "npx",
      "args": ["opedd-mcp"],
      "env": {
        "OPEDD_BUYER_EMAIL": "[e-mail]",
        "OPEDD_PAYMENT_METHOD_ID": "pm_..."
      }
    }
  }
}

Cursor / Windsurf setup

Add to your MCP settings:

{
  "opedd": {
    "command": "npx opedd-mcp",
    "env": {
      "OPEDD_BUYER_EMAIL": "[e-mail]",
      "OPEDD_PAYMENT_METHOD_ID": "pm_..."
    }
  }
}

Example usage

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

"Verify license key OP-XXXX-XXXX and tell me what it covers."

"Browse the latest licenses from The Information publisher."

Phase 12 Wave 1 + 3 surfaces (v0.3.0)

"What does publisher 8268c353-ffa3-4db3-bbb2-90ddbbb43e41 license? Pull the RSL manifest." — uses rsl_get

"Get me a CDSM Article 4(3) signed receipt for that publisher's reservation state — set jsonld: true." — uses rsl_get with content negotiation

"Generate an EU AI Act Article 53 attestation JWT for our license 11111111-... covering the last 90 days. I need the artifact for our procurement audit committee." — uses article_53_attestation (requires OPEDD_BUYER_JWT)

"This publisher just signed up: https://noahpinion.substack.com. Which onboarding workflow should we use?" — uses detect_platform

"Browse the finance category in the Opedd catalog — show me publishers with at least 50 articles." — uses publisher_directory

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

Payment methods

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.

Development

git clone https://github.com/Opedd/opedd-mcp
cd opedd-mcp
npm install
npm run dev   # runs with tsx (no build step)
npm run build # compiles to dist/

How Opedd compares to search APIs

	Opedd	Generic search APIs
What you get	Licensed content + license key + on-chain proof — all in one API call	Scraped web content, no rights
Content delivery	Full article text via API (JSON) — bulk on flat-fee licenses, per-call (metered) on filtered licenses; real-time feed via webhooks	Scraped snippets or full-page dumps
Content quality	Curated publisher content (niche B2B newsletters, expert analysis)	Whatever's on the open web
Rights	Verifiable license key per article, publisher-authorized	No rights clearance
Proof	On-chain (Tempo blockchain) — independently verifiable	None
EU AI Act	Compliant — full training data provenance chain	No provenance
Pricing	Publisher sets their own price per article	Platform decides
Delivery modes	Per-article API, bulk feed (JSON firehose), buyer webhooks (push)	Query-response only
Protocol	REST + MCP native	REST only

Opedd is the licensed content delivery layer for AI — not just a licensing wrapper. Publishers upload content, you retrieve it via API with a license attached. One integration gives your pipeline both the content and the legal right to use it.

Learn more

• Opedd for AI Agents — full documentation, code examples, endpoint reference
• API Docs — OpenAPI spec with agent endpoints
• Opedd Registry — browse on-chain license proofs

License

MIT