Opedd/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
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 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):
**OpenAI Responses API**:
**claude.ai / Claude Desktop custom connector** (all plans): Settings → Connectors → *Add custom connector* → URL https://mcp.opedd.com/mcp; add a Authorization: Bearer request header for the credentialed tools.
**Cursor** (.cursor/mcp.json):
Key routing: opedd_sk_* (legacy 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 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**
| 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. Per-question licences: charged once per publisher per question at that publisher's own price, 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–25). 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 |
| 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, 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) |
| place_licence_order | Place a licence order for one or more publishers: AI answers (monthly full text, or metered pay-per-request snippets ≤300 words / 25%), Full catalogue (archive, one_time: everything published up to the order date, kept permanently, no AI training), AI training (one_time, back catalogue), client display (monthly × end clients). Optional include_archive: true on a monthly AI answers order adds each publisher's Full catalogue for complete access. Each publisher is its own Schedule at its own price; returns the order, lines, unavailable publishers and hosted_invoice_url. Needs OPEDD_BUYER_JWT and terms_accepted: true |