# io.github.Noderail/noderail (npm · @noderail/mcp)

Provenance and governance layer for AI-readable knowledge. NodeRail answers what AI should trust.

- Trust score: 62/100 (medium)
- Change this week: +22
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- npm · `@noderail/mcp`: 62/100 (this document), [markdown](https://verifymcp.io/servers/noderail-noderail/noderail-mcp.md), [page](https://verifymcp.io/servers/noderail-noderail/noderail-mcp)

## Channel facts

- Registry: `npm`
- Package: `@noderail/mcp`
- Version: `1.0.1`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Supply Chain Security**: 87/100
  - No malware found by supply-chain analysis.
  - Only part of the dependency tree could be resolved (144 of 146), so this covers what we could see, not the whole tree.
  - No install/post-install scripts declared.
  - Only part of the dependency tree could be resolved (144 of 146), so this covers what we could see, not the whole tree.
- **Provenance & Transparency**: 6/100
  - Repository check failed: no source repository is declared.
  - Provenance check failed: no build-provenance attestation is published.
  - License check failed: no license is declared.
  - Actively maintained (last published 116 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 77/100
  - AI-judged instruction clarity (excellent).
  - Tool/resource definitions use about 636 tokens (~106/item across 6 items; 6 tools + 0 resources), lean.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 27/100
  - Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### Claude

```bash
claude mcp add noderail-noderail -- npx -y @noderail/mcp
```

### Codex

```bash
codex mcp add noderail-noderail -- npx -y @noderail/mcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "noderail-noderail": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@noderail/mcp"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add noderail-noderail --command npx --arg -y --arg @noderail/mcp
```

### Hermes

```yaml
mcp_servers:
  noderail-noderail:
    command: "npx"
    args: ["-y", "@noderail/mcp"]
```

### Other

```json
{
  "mcpServers": {
    "noderail-noderail": {
      "command": "npx",
      "args": [
        "-y",
        "@noderail/mcp"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-03 (score 62, +4)

- [functional improvement] Stability: unverified → 0.27

### 2026-08-02 (score 58, +42)

- [security regression] Provenance: unverified → fail
- [security improvement] Install scripts: unverified → pass
- [security improvement] Known CVEs: unverified → partial
- [security improvement] Malware scan: unverified → pass
- [security] Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window).
- [functional regression] License: unverified → fail
- [functional regression] Security disclosure: unverified → fail
- [functional improvement] Schema quality: unverified → excellent
- [functional improvement] Dependency health: unverified → partial
- [functional improvement] Maintenance: unverified → pass
- [functional improvement] MCP protocol: unverified → pass

### 2026-07-31 (score 16, −6)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-30 (score 22, −18)

- [security regression] Malware scan: pass → unverified

### 2026-07-27 (score 40)

First indexed and scored.

## MCP tools (6)

### `noderail_get_field` (~102 tokens)

Get a Field node by ID or name with full provenance. Returns scope, governance, canonical registry, lineage, citation, and a content preview. If neither field_id nor field_name is provided, lists all available fields.

Input parameters:

- `field_id` (string): node_id of the Field node (e.g. NR-20260224-HCS-001)
- `field_name` (string): Human-readable field name (e.g. "Human Capacity Science")

### `noderail_list_nodes` (~76 tokens)

List all nodes in the NodeRail knowledge graph with status and version. Filter by field, node_type, or status.

Input parameters:

- `field` (string): Filter by field name (e.g. "Human Capacity Science")
- `node_type` (string): Filter by node type
- `status` (string): Filter by status

### `noderail_get_node` (~71 tokens)

Get any node by ID with full content — all frontmatter fields and the complete Markdown body.

Input parameters:

- `include_body` (boolean): Include full Markdown body (default: true)
- `node_id` (string, required): The unique node_id (e.g. NR-20260224-HCS-001)

### `noderail_get_lineage` (~71 tokens)

Get the version history and full lineage chain for a node. Returns declared parents, forked_from, adopted_from, declared children, and nodes discovered by reverse-lookup that reference this node as a parent or fork source.

Input parameters:

- `node_id` (string, required): The node_id to trace lineage for

### `noderail_search_nodes` (~137 tokens)

Search NodeRail nodes by keyword (scans title, tags, body text, and node_id) or filter by author/maintainer name. At least one parameter must be provided.

Input parameters:

- `author` (string): Filter by creator, maintainer, or contributor name
- `field` (string): Restrict search to a specific field
- `limit` (integer): Maximum results to return (default: 10, max: 50)
- `node_type` (string): Restrict search to a node type
- `query` (string): Keyword or phrase to search in title, tags, body, and node_id

### `noderail_get_trust_status` (~179 tokens)

Provenance gate: generate a full trust report for a node.

Returns:
  • evidence_level     — HIGH / MEDIUM / LOW / CONTESTED / DEPRECATED
  • canonical_status   — whether the node is registered in its field's canonical registry
  • permitted_use      — license, citation requirements, and use guidance
  • warnings           — ordered list of trust concerns
  • recommendation     — clear AI action guidance (SUITABLE / PILOT / DRAFT / CAUTION / DO NOT USE)
  • provenance         — DOI, lineage, maintainer, and validation coverage

MCP answers: what can AI access?
NodeRail answers: what should AI trust?
Always call this tool before citing a node in authoritative AI outputs.

Input parameters:

- `node_id` (string, required): The node_id to evaluate

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/noderail-noderail/noderail-mcp#diagnostics

## Score history

- 2026-08-03: 62
- 2026-08-02: 58
- 2026-08-01: 16
- 2026-07-31: 16
- 2026-07-30: 22
- 2026-07-28: 40
- 2026-07-27: 40

## Links

- npm package: https://www.npmjs.com/package/@noderail/mcp
- Socket report: https://socket.dev/npm/package/@noderail/mcp
- Changelog RSS feed: https://verifymcp.io/servers/noderail-noderail/noderail-mcp/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/noderail-noderail/noderail-mcp/changelog.json
- HTML version of this page: https://verifymcp.io/servers/noderail-noderail/noderail-mcp