# nope-mcp — Open Educational Resources search [Health: Active]

**Category:** 🎓 Education  
**Repository:** https://github.com/edufeed-org/nope-mcp  
**GitHub Stars:** 1  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/nope-mcp-open-educational-resources-search

## Description
Search German open educational resources (OER) via AMB/schema.org metadata, open licenses only.

## Tools
Capabilities this server exposes over MCP:

- **search_resources** — Search for educational resources (learning materials, courses, videos, etc.) using full-text search and metadata filters. Returns resources matching the query from the AMB relay. Only openly licensed resources are returned (CC0, Public Domain, CC BY, CC BY-SA); NC/ND, all-rights-reserved and unlicensed resources are left out. NOTE: the metadata filters (publisherName, creatorName, subjectLabel, resourceTypeLabel, educationalLevelLabel) are EXACT full-string matches against the stored metadata (case-insensitive) — not fuzzy or substring searches. A guessed spelling silently returns 0 results; use resolve_publisher to find the canonical actor spelling first. On a zero-match actor filter the response includes actorCandidates with similar spellings to retry with.
- **search_content** — Topic search across ALL content types on the relay in one ranked call: educational resources (kind 30142), long-form articles/blogs (30023), wikis (30818), projects (30143), measures (30144), and NKBIP-01 publications (30040 indices + 30041 sections — scientific articles, books). Results are interleaved and ranked by semantic passage match, and each carries the matched passage ("snippet") when available — use it to answer the user, not just list links. Educational resources are returned only when openly licensed (CC0, Public Domain, CC BY, CC BY-SA); the other content types carry no license and are all included. This is the tool for DISCOVERY intent — the user wants materials to browse ("finde/suche/empfiehl Materialien zu X"): present the items. For QUESTION intent — the user wants an answer built from the content ("wie/warum/was hilft bei X?") — prefer search_passages, which returns quotable fulltext passages with citations; this tool then supplements the answer with browsable links. Each result carries eventAuthor (the Nostr signer who uploaded the event — often an aggregator) plus, for resources, creator/publisher (who actually made and published the resource); these can differ, so do not treat eventAuthor as the publisher. For full metadata (license, dates, complete entity lists) pass a result's naddr to get_resource. Publication facets ride inside the query string as NIP-50 field filters: append type:academic, doi:10.1234/abcd.5678, keywords:<term>, or partOf:30143:<pubkey>:<d> ("publications of a project") to the query — the relay resolves them server-side. When presenting results to the user, render each as a markdown link so they can open it directly — prefer sourcePage (the original external source page, present on most resources and on projects/measures/publications), then url, then naddr. For upcoming events on the same topic, follow up with search_calendar_events.
- **get_resource** — Retrieve a single piece of content by naddr (preferred — pass a search_content result's naddr), d-tag identifier, or event ID. naddrs of ANY content type from search_content work (resources, articles, wikis, projects, measures, publications); non-resource kinds return the same shape as their search results. Bare identifier/eventId lookups (no naddr) always resolve the full educational-resource metadata (kind 30142), including creator/publisher and educational properties. Lookups are not license-filtered: a learning resource carries openLicense (true for CC0, Public Domain, CC BY, CC BY-SA — the open licenses that search results are currently limited to). When presenting the resource, render a markdown link the user can open: prefer its sourcePage (the original source page); fall back to url (the edufeed viewer) only when sourcePage is absent.
- **browse_subjects** — List available subjects/topics in the educational resource collection. Returns subjects with their labels and resource counts.
- **browse_resource_types** — List available learning resource types (Video, Course, Worksheet, etc.) with resource counts.
- **browse_educational_levels** — List available educational levels (Primary, Secondary, Higher Education, etc.) with resource counts.
- **relay_stats** — Get information about all selectable AMB relays (default and extra), including supported NIPs, relay name, and description.
- **list_relays** — List the configured AMB relays. defaultRelays are searched on every query; extraRelays hold different corpora (e.g. the OERSI aggregation) and are only searched when a search/get tool call passes them in its relays parameter.
- **relay_list_get** — Get a user's NIP-65 relay list (kind 10002). Returns read and write relays for the specified pubkey. If no pubkey provided, uses the connected signer's pubkey.
- **skos_get_vocabulary** — Fetch and parse a SKOS vocabulary from its URI. Returns the concept scheme with all concepts organized hierarchically.
- **skos_get_concept** — Get details of a single SKOS concept by its URI, including broader, narrower, and related concepts.
- **skos_search** — Search for concepts in a SKOS vocabulary. By default searches prefLabel, altLabel, hiddenLabel, and definition.
- **list_known_authors** — List known educational resource authors loaded from configured follow sets (NIP-51 kind 30000). Returns author names, pubkeys, and NIP-05 identifiers. Use the returned pubkeys with search_resources(authors: [...]) to filter resources by author.
- **resolve_author** — Resolve an org or person NAME to candidate pubkeys using the relay's kind-0 author-profile index (NIP-50 search). Use this to answer name-driven content questions like "recent articles and resources of Jörg Lohrer": call resolve_author(name), pick the best candidate, then pass its pubkey to search_content({ authors: [pubkey], ... }) (and/or search_calendar_events) to fetch that author's content. Returns several candidates ranked by relevance so you can disambiguate. This indexes authors who have published content here — distinct from list_known_authors, which lists hand-curated follow sets. NOTE: this resolves only kind-0 author profiles. It does NOT resolve a community's identifying pubkey — a community is defined by a kind-10222 event and frequently has no kind-0 at all. To list content shared into a community you need that community pubkey (a Nostr identifier, e.g. from the community's spec/naddr), which you pass to the `community` param of search_content / search_calendar_events. resolve_author CAN, however, find a community's posting account (e.g. a "…-Termine-Bot") when that account has a kind-0; querying that pubkey via authors:[...] returns the content it published. A wrong pick simply yields empty results.
- **resolve_publisher** — Resolve an actor name (organization or person) to the EXACT spelling used in the AMB metadata, so it can be passed to the publisherName/creatorName filters of search_resources. Those filters are exact full-string matches (case-insensitive), so a guessed spelling like "Lehreladen" silently misses the stored "LEHRE LADEN". This tool free-text searches the name and returns the similar publisher/creator names found in the corpus, with the field they appear in and a resource count. Distinct from resolve_author, which resolves Nostr signing accounts (kind-0 profiles) to pubkeys — metadata publishers usually have no Nostr account at all.
- **search_calendar_events** — Search for NIP-52 calendar events (date-based and time-based). Supports temporal filters (start/end time ranges), geohash location filtering, and hashtag filtering. Returns events from the configured calendar relay. When presenting an event to the user, render it as a markdown link: prefer the event `url` (the edufeed-app viewer at <base>/<naddr>, which shows fuller details) over `sourcePage` (the original external event page). Never construct an naddr or viewer URL yourself — use the `naddr`/`url` fields as returned.
- **list_calendar_authors** — List known calendar event authors loaded from configured follow sets (NIP-51 kind 30000). Returns author names, pubkeys, and NIP-05 identifiers. Use the returned pubkeys with search_calendar_events(authors: [...]) to filter events by author.
- **search_passages** — THE DEFAULT TOOL FOR QUESTION-SHAPED QUERIES ("wie/warum/was hilft bei X?", "how do I…?"): retrieves the best-matching fulltext passages from the corpus and returns them with citations (source resource, page, heading, source URL) — answer the user FROM the passages and cite each source. (For discovery intent — "finde/empfiehl Materialien" — use search_content instead, or afterwards to offer browsable links.) Keep `question` topic-only. Ranking is hybrid keyword+vector, so phrase the question as a topical statement that names the subject and the target group ("Friedenserziehung in der Grundschule: Einstieg in das Thema Frieden mit Kindern"), not as the user's literal sentence ("Wie kann ich …?"). Results are capped at two passages per document; a passage with only a snippet and no text has no fulltext yet — say so instead of guessing. Educational-resource passages come only from openly licensed resources (CC0, Public Domain, CC BY, CC BY-SA); other content types are not license-filtered. Scope is required but simple: with no source restriction from the user, pass the content kinds (e.g. kinds:[30142] for educational resources, [30040,30041] for publications, [30023] for articles). Route source restrictions ("nur Content von X") into the scope parameters: a metadata publisher (most organisations — resolve_publisher finds the exact spelling) goes into `search` as a QUOTED field filter, e.g. search:'publisher.name:"LEHRE LADEN"' (unquoted multi-word names match nothing); a Nostr signing account (resolve_author → pubkey) goes into `authors`. A published grimoire spell (kind 777, nevent or event id) can replace inline scope entirely; the response carries the canonical spell for whatever scope was used — publish it (e.g. via grimoire) to make the scope reusable. Spells may use $me/$contacts; they resolve to the calling user (pass `me` if the transport is anonymous). Fails rather than widening scope: an empty scope, unreachable relay (relay_unreachable — tell the user to retry), or unreachable index is a typed error, never a silently unscoped search.

## Claude Desktop Quick Installation
No confirmed install details yet, so no config is published. Follow the setup steps in the repository above.

## Documentation

## What nope-mcp — Open Educational Resources search does

nope-mcp — Open Educational Resources search exposes educational content and related Nostr data through the Model Context Protocol. Its main collection is based on AMB metadata and contains learning materials such as courses, videos, and worksheets. Resource search results are limited by default to CC0, Public Domain, CC BY, and CC BY-SA materials; resources with NC, ND, all-rights-reserved, or missing licenses are excluded from searches.

The server also searches articles, wikis, projects, measures, and NKBIP-01 publications. `search_content` is suited to discovery, while `search_passages` retrieves full-text excerpts with source details for question-shaped requests. Individual items can be opened with `get_resource`, using a returned naddr, event ID, or other supported identifier.

## How it works

Queries run against configured AMB relays. `search_resources` combines full-text search with filters for publisher, creator, subject, resource type, and educational level. These metadata filters use case-insensitive exact full-string matching, so applications should call `resolve_publisher` before filtering by an organisation or person when the stored spelling is unknown.

`search_content` interleaves supported content types and can return a matched snippet. For answers grounded in source text, `search_passages` uses an indexer and returns passages with citations such as the source, page, heading, and URL. Its scope must be specified through content kinds, metadata filters, authors, or a published scope spell; it does not silently broaden an empty or unavailable scope.

Additional tools list subjects, resource types, educational levels, configured relays, relay statistics, known authors, and calendar authors. Author resolution and publisher resolution serve different purposes: the former finds Nostr signing accounts, while the latter finds exact AMB metadata names. SKOS tools fetch vocabularies, concepts, and labels for controlled-term lookup.

## Setup and configuration

Install the project with Bun using `bun install`, then copy `.env.example` to `.env`. `AMB_RELAYS` sets the default AMB relay list and defaults to `wss://relay.edufeed.org`. `AMB_EXTRA_RELAYS` makes additional corpora selectable without adding them to every search. `OPEN_LICENSES_ONLY` defaults to enabled and can be disabled when unfiltered resource results are required.

Passage search is disabled unless `INDEXER_ENDPOINTS` is configured. The indexer authentication can use `INDEXER_API_TOKEN` or per-relay values in `INDEXER_API_TOKENS`. Calendar queries use `CALENDAR_RELAYS`. `EDUFEED_APP_BASE_URL` optionally adds viewer links to returned content and event records.

The repository supports stdio, HTTP, and Nostr-related operation. `SERVER_PRIVATE_KEY` is required for the Nostr transport, but is not read by stdio or HTTP transports. `RELAYS` configures ContextVM announcements and traffic for that transport. Other settings control logging, author follow sets, vocabulary relays, and optional metadata extraction behavior.

## Limitations and notes

The collection is focused on German open educational resources and the configured relay corpora, not the entire public web. Exact metadata filters can return zero results for a spelling that differs from the stored value; actor candidates may be returned to help retry the query. `search_passages` depends on an available indexer, and passages without full text should not be treated as evidence.

Results can distinguish the Nostr event signer from the resource creator or publisher. Applications should present the latter as the content owner when that metadata is available. When rendering links, prefer a returned original source page, then a supplied viewer URL or resource URL; clients should not construct naddr-based links themselves.

_Full upstream README: https://allmcps.com/mcp/nope-mcp-open-educational-resources-search/readme_