Noru FlowDocs
Navigation menu

Docs  ·  Connect your AI

MCP resources

Advanced clients can list curated pinned captures and read any valid addressable capture through a local, read-only noru-capture URI.

Read-only resource capability

Noru advertises MCP resources with an empty capability object. It implementsresources/list andresources/read under thenoru-capture:// scheme. There are no write methods, subscriptions, or listChangednotifications.

resources/list

Lists up to 100 pinned capture_* bundles, newest first. It does not list unpinned captures, and onlycapture_* bundles are addressable. If history access is revoked, it returns an empty array.

JSON-RPC request
{
  "jsonrpc": "2.0",
  "id": 12,
  "method": "resources/list"
}
illustrative result
{
  "jsonrpc": "2.0",
  "id": 12,
  "result": {
    "resources": [
      {
        "uri": "noru-capture://capture_2026-08-12_141502",
        "name": "capture_2026-08-12_141502",
        "description": "Pinned Noru capture (1 item)",
        "mimeType": "image/png"
      }
    ]
  }
}
uri
noru-capture://<capture id>, safe to pass to resources/read.
name
The stable capture id.
description
The user's one-line note when present, otherwise an honest item-count summary.
mimeType
image/png when the bundle carries an image layer; otherwise text/plain.

resources/read

Resolves one valid noru-capture://<id>URI to the same model-sized bundle renderer used by the tools. Reading is repeatable and never requests a new screenshot.

The capture does not need to be pinned. A successfulget_latest_capture orget_capture result includes a URI in itsstructuredContent, andresources/read can resolve that address directly.

JSON-RPC request
{
  "jsonrpc": "2.0",
  "id": 13,
  "method": "resources/read",
  "params": {
    "uri": "noru-capture://capture_2026-08-12_141502"
  }
}
illustrative result
{
  "jsonrpc": "2.0",
  "id": 13,
  "result": {
    "contents": [
      {
        "uri": "noru-capture://capture_2026-08-12_141502",
        "mimeType": "text/plain",
        "text": "Image 1: 1568 x 980 ..."
      },
      {
        "uri": "noru-capture://capture_2026-08-12_141502",
        "mimeType": "image/png",
        "blob": "<base64 PNG>"
      }
    ]
  }
}

Text content becomes a text/plain item with atext field. Image content becomes animage/png item with a base64blob.

Access and errors

History revoked
Listing returns no resources. Reading returns JSON-RPC error -32001 and directs the user to authorize observations in Noru.
Invalid URI
A missing, malformed, non-capture, traversal, or unknown address returns -32602.
No update stream
Clients must call list or read when needed. Noru does not advertise resource subscriptions or list-change events.

macOS 13+ · Apple Silicon

Noru for Mac.

Download free

v0.3.1 · Signed & notarized by Apple

Installation guide