-
released this
2026-10-29 14:41:47 +00:00 | 31 commits to main since this releaseFixed
search_resources/search_content: a zero-result response caused only by
licenseFilter(e.g. acreatorName/publisherNamefilter matching
resources that are all under a license outside the filter's scope) no
longer shows the "exact spelling" actor hint — it now reports how many
resources matched under other licenses and, when the operator ceiling
(LICENSE_FILTER_MAX) allows it, suggests retrying with a wider
licenseFilter; when the ceiling forbids widening, it says the matches
are under licenses this server doesn't return instead. The actor-spelling
hint is now shown only when the actor name truly matched nothing,
regardless of the license filter.- Relay queries (
search_resources,search_content, every other relay
read) no longer get silently truncated at nostr-tools' internal 4.4s
default EOSE timeout — our own, much longer, query timeout wasn't being
passed down (maxWait/eoseTimeout), so any relay slower than that was
cut off with notimedOutdiagnostic at all (the likely real cause of
sodixcoming back empty under reindex load, answering in 11-17s). On
top of that, the previous timeout fix (now corrected) also discarded
events already received when the deadline fired instead of returning
them, under-counted which relays actually timed out across multiple
relays, and could resolve a multi-relay query after only the first
relay's EOSE. The timeout is configurable viaRELAY_QUERY_TIMEOUT_MS
(default 25000, up from 10000) and closes the stalled subscription
instead of leaking it. Zero-result follow-up probes (the license hint
above,resolve_publisher's did-you-mean fallback) now use a short
5s budget instead of the full query timeout, so a worst-case empty
response doesn't chain into tens of seconds of added latency.
Downloads
-
Source code (ZIP)
0 downloads
-
Source code (TAR.GZ)
0 downloads
-
released this
2026-10-29 08:15:22 +00:00 | 35 commits to main since this releaseAdded
- License tiers for learning resources. Every learning resource (kind
30142) is now searchable, not only CC0/PD/BY/BY-SA. Each result carries
license({ id, label }, e.g. "CC BY-NC-SA 4.0", ornull) and
accessLevel:"full"for any Creative Commons license or Public Domain
(passages and snippets as before),"metadata-only"for all-rights-reserved,
unknown or missing licenses (metadata and link only, never fulltext). licenseFilterparameter onsearch_resources,search_contentand
search_passages:open(CC0/PD/BY/BY-SA),cc-any(all CC + PD) or
any(default). Responses report the appliedlicenseFilterand
licenseFilterClamped: truewhen narrowed.LICENSE_FILTER_MAXenv: operator ceiling forlicenseFilter(default
any); wider requests are clamped.search_passagesreturnsmetadataOnlyMatchesfor matching learning
resources whose license does not allow quoting (no text, with license and
attribution).get_resourcereturns top-levelaccessLevel.
Changed
- The license is read from
license:id, falling back to a plainlicense
tag (parity with amb-indexer). search_contentstrips snippet, page, heading, score and source URL from
metadata-only results even if the relay sent a snippet.
Deprecated
OPEN_LICENSES_ONLY(maps toLICENSE_FILTER_MAX=openwhentrue, with a
log line) andget_resource'sopenLicense(useaccessLevel).
Downloads
-
Source code (ZIP)
2 downloads
-
Source code (TAR.GZ)
2 downloads
- License tiers for learning resources. Every learning resource (kind
-
v0.4.0 — nope-mcp (formerly amb-mcp), agent-ready
StableAll checks were successfulbuild-image / build (push) Successful in 6sreleased this
2026-10-03 05:59:26 +00:00 | 61 commits to main since this releaseAdded
- MCP Registry manifest (
server.json): publishes nope-mcp to the
official MCP Registry as
org.edufeed/nope-mcp, pointing at thehttps://mcp.edufeed.org/mcp
remote. Itsversionalways matchespackage.json. - Per-connection default relays via the connector URL: the HTTP transport
reads a?relays=parameter off theinitializerequest, e.g.
https://mcp.amb.edufeed.org/mcp?relays=sodix. The named relays become that
session's default set; the rest of the deployment's relays stay selectable
per call. Connector UIs typically offer only a name and a URL field, so the
URL is the only place a connection can express which corpus it wants.
Relays answer to their full URL, their hostname, or the first label of their
hostname; a name the deployment does not serve failsinitializewith HTTP
400 rather than silently falling back to the server default. Arbitrary URLs
are refused — the endpoint never opens sockets to caller-chosen hosts. - SODIX relay (
wss://sodix.edufeed.org) documented as an
AMB_EXTRA_RELAYSmember alongside the OERSI aggregation relay. list_relaysreportsdefaultRelaysSource(server-configor
connector-url), so a model can tell a deliberately narrowed session from
the deployment's standard corpus.- Per-tool-call logging: every tool call emits one JSON line on stderr
(ts,tool,ms,ok,session, summarizedargs,erroron
failure).LOG_LEVELcontrols it:info(default) logs every call,
warn/erroronly failures,silentnothing. stdout stays reserved for
the stdio transport.
Typed error payloads ({"error":"relay_unreachable",…}returned as text) are logged asok:falsewith the code. - MCP served at
/as well as/mcp(same session map, both paths accept
POST/GET/DELETE): a plain browserGET /— noMcp-Session-Idheader, no
Accept: text/event-stream— returns a small JSON info document (name,
version,mcp,docs,transport) instead of the usual "unknown
session" 404;GET /mcpis unchanged and always behaves as an MCP session
request. - Host- and path-aware OAuth protected-resource metadata (RFC 9728): the
PRM is built per request from the forwarded scheme + host (trust proxy
is now on, since Traefik terminates TLS) and served at both
/.well-known/oauth-protected-resource(resource: https://<host>/)
and the new/.well-known/oauth-protected-resource/mcp(resource: https://<host>/mcp); a 401'sWWW-Authenticatepoints at whichever PRM
matches the request path (/mcpand/mcp/alike). A host outside
HTTP_ALLOWED_HOSTS(when configured) falls back toOAUTH_RESOURCE_URL.
Behaviour change for existing connector owners: the root PRM's
resourcevalue changed fromhttps://<host>/mcptohttps://<host>/;
a connector that cached the old root PRM document needs to re-fetch it.
Connectors addressing/mcpdirectly are unaffected — that path now has
its own PRM at/.well-known/oauth-protected-resource/mcp. OAUTH_AUDIENCEis now a comma-separated list (default
nope-mcp,amb-mcp); a token whoseaudcontains any of them validates,
so tokens Keycloak still issues withaud: amb-mcpkeep working under the
new name.- MCP tool annotations (
readOnlyHint,destructiveHint, etc.) on every
registered tool, so clients that surface them (e.g. consent prompts)
classify each call correctly;signer_statusis annotated as the pure
read it is, not as a mutator. - English opening paragraph in the server
instructions:
buildServerInstructions({ openLicensesOnly })now leads with a
config-aware paragraph describing nope-mcp for any MCP client — not only
edufeed's German teacher base, since this server is listed in public MCP
directories — before the existing German routing guidance; it never claims
the open-license policy is active whenOPEN_LICENSES_ONLY=false.
Deploy notes
- Production's
HTTP_ALLOWED_HOSTSmust includemcp.edufeed.org— the
SDK's DNS-rebinding protection rejects any request whose Host is outside
this list once the list is set.
Changed
- Open-licensed results only:
search_resources,search_contentand
search_passagesreturn learning resources (kind 30142) only under CC0,
the Public Domain Mark, CC BY or CC BY-SA — the allowlist amb-indexer uses
for fulltext. NC/ND, all-rights-reserved and unlicensed resources are left
out; articles, wikis, publications, projects, measures and calendar events
carry no license and stay unfiltered. Searches with free text over-fetch and filter
client-side, because any relay field filter would disable amb-relay's
passage rerank; only asearch_resourcescall without free text (pure
metadata filters or a browse) addslicense.idfilters for every stored
open spelling to the relay query.get_resourcestill resolves any resource
and reportsopenLicense.OPEN_LICENSES_ONLY=falserestores unfiltered
results. - Renamed to
nope-mcp(formerlyamb-mcp). The package name, MCP
server name, HTTPWWW-Authenticaterealm, and docs now saynope-mcp.
amb-mcpremains a documented alias and a valid OAuth audience; existing
deployments and URLs (https://mcp.amb.edufeed.org/mcp) keep working
unchanged. search_passagesranking: requests vector weightalpha: 0.7from the
indexer instead of its keyword-leaning default 0.3, over-fetches
min(limit × 3, 100)chunks, keeps at most two passages per document and
drops hits below 10 % of the top score before truncating tolimit. A
Christmas escape game no longer tops a peace-education question on the
strength of the words "GRUNDSCHULE" and "Kinder", and one document no
longer fills three of ten slots.search_passagesguidance: the tool description and the server
instructions now tell the model to phrasequestionas a topical statement
naming subject and target group rather than the user's literal sentence,
and to say so instead of guessing when a passage carries only a snippet.
The reason given is flag-aware: withOPEN_LICENSES_ONLYon, a text-less
learning-resource passage simply has no fulltext yet, since license-gated
hits are already dropped before the model sees them; with it off, the
license-gated possibility is still named.
Downloads
-
Source code (ZIP)
1 download
-
Source code (TAR.GZ)
4 downloads
- MCP Registry manifest (
-
v0.3.0 — reliable actor search
StableSome checks failedbuild-image / build (push) Failing after 6sreleased this
2026-08-19 12:20:22 +00:00 | 113 commits to main since this releaseActor-name search made reliable: multi-word metadata filters were silently broken (unquoted spaces), and there was no way to discover the exact publisher spelling the corpus uses.
Added
resolve_publishertool: resolves an actor name to the exact publisher/creator spelling used in the AMB metadata (e.g. "Lehreladen" → "LEHRE LADEN"), since the metadata filters are exact full-string matches. Complementsresolve_author, which covers Nostr signing accounts only.- Did-you-mean on empty actor filters: when
publisherName/creatorNamematches nothing,search_resourcesnow returnsactorCandidates(similar spellings found in the corpus) and ahintexplaining the exact-match semantics, so agents can self-correct instead of dead-ending.
Fixed
- Field-filter values containing spaces (
publisherName,creatorName,subjectLabel,resourceTypeLabel,educationalLevelLabel) are now quoted in the NIP-50 search string. Unquoted, the relay tokenizer split them into a filter on the first word plus stray free-text terms, so e.g.publisherName: "LEHRE LADEN"oreducationalLevelLabel: "Sekundarstufe I"returned unrelated results instead of the filtered set.
Changed
- Tool descriptions now state that the metadata filters are exact, case-insensitive full-string matches, and
search_contentadvises keeping the topic query free of actor names (constrain actors viaauthorsor publisher filters instead).
Related relay-side fix: edufeed/amb-relay#22 (field filters were dropped when combined with free text) — merged separately.
Downloads
-
Source code (ZIP)
0 downloads
-
Source code (TAR.GZ)
4 downloads
-
v0.2.1 — extra-relay discoverability
StableAll checks were successfulbuild-image / build (push) Successful in 2m25sreleased this
2026-08-18 11:37:29 +00:00 | 117 commits to main since this releaseDiscoverability follow-up to 0.2.0: LLM clients assumed "configured ⇒
searched" and misread the extra relay as unreachable.Changed
relay_statsnow covers all selectable relays (default and extra), each
marked with arolefield, so per-call-only relays are visibly alive.list_relaysincludes anoteexplaining thatextraRelaysare only
queried via therelaysparameter.- Search responses list the selectable relays a search skipped as
relaysNotSearched, next torelaysSearched.
Downloads
-
Source code (ZIP)
1 download
-
Source code (TAR.GZ)
4 downloads
-
v0.2.0 — per-call relay selection
StableAll checks were successfulbuild-image / build (push) Successful in 2m34sreleased this
2026-08-18 06:57:52 +00:00 | 118 commits to main since this releaseAdded
- Per-call relay selection:
search_content,search_resources, and
get_resourceaccept an optionalrelaysparameter naming relays from the
selectable set (default ∪ extra); unknown relays are rejected with the list
of valid ones. Search responses report the queried relays as
relaysSearched. AMB_EXTRA_RELAYSenvironment variable: relays that are selectable per
call but not part of the default search set (e.g. the OERSI aggregation
relay,wss://oersi.edufeed.org).
Changed
- Breaking:
list_relaysnow returnsdefaultRelaysandextraRelays
instead of a singlerelaysarray.
Downloads
-
Source code (ZIP)
1 download
-
Source code (TAR.GZ)
2 downloads
- Per-call relay selection: