# Nifra docs (remote · mcp.nifra.dev)

Nifra docs, runnable examples, and API types as an MCP server for any AI assistant.

- Trust score: 64/100 (medium)
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- remote · `mcp.nifra.dev`: 64/100 (this document), [markdown](https://verifymcp.io/servers/nifrajs-nifra-docs/mcp.md), [page](https://verifymcp.io/servers/nifrajs-nifra-docs/mcp)

## Channel facts

- Endpoint: `https://mcp.nifra.dev`
- Transports: `streamable-http`
- Auth: `none`
- Version: `2.8.1`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, 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.

- **Endpoint Security**: 57/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - Authorisation not fully verified: no authorisation is required to call this server, and 5 tool(s) never declared a destructiveHint. The MCP spec treats an absent hint as destructive by default, so we cannot call this surface safe.
  - HTTPS is enforced; there's no plaintext access path.
  - HSTS check failed: the Strict-Transport-Security header is absent.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 82/100
  - 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 894 tokens (~149/item across 6 items; 5 tools + 1 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 0/100
  - Stability check failed: schema churn in the 1 day we've observed: 1 tool removals, 0 breaking changes, 0 auth/transport breaks, 1 additions.
- **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 current MCP spec version (2026-07-28).
  - Supports UI / widget rendering.

## Install

### Claude

```bash
claude mcp add --transport http nifrajs-nifra-docs https://mcp.nifra.dev/
```

### Codex

```toml
[mcp_servers.nifrajs-nifra-docs]
url = "https://mcp.nifra.dev/"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "nifrajs-nifra-docs": {
      "type": "remote",
      "url": "https://mcp.nifra.dev/",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add nifrajs-nifra-docs --url https://mcp.nifra.dev/ --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  nifrajs-nifra-docs:
    url: "https://mcp.nifra.dev/"
```

### Other

```json
{
  "mcpServers": {
    "nifrajs-nifra-docs": {
      "type": "http",
      "url": "https://mcp.nifra.dev/"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## 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 64, 0)

- [security regression] Stability: unverified → fail
- [security regression] Tool “nifra_examples_app” was removed
- [security] Tool “nifra_example” rewrote its description, which is the text the model reads
- [functional improvement] Stability: unverified → 0.03
- [functional] Schema quality: good → excellent
- [functional] Server version: 2.8.0 → 2.8.1
- [functional] Server version: 2.6.1 → 2.8.0
- [functional] Server version: 2.5.0 → 2.6.1
- [functional] New tool “nifra_gallery”

### 2026-08-02 (score 64)

First indexed and scored.

## MCP tools (5)

### `nifra_docs` (~142 tokens)

Search nifra's framework documentation and get back ONLY the matching sections - auth, uploads, ISR, WebSockets, loaders, deployment, anything. Call with no query for the cheap section index; pass query (e.g. "isr revalidate") for the top matching sections. Use this instead of reading llms-full.txt (~150 KB) whole. For the EXACT TypeScript of a type/interface/function, call nifra_types instead (don't read .d.ts files).

Input parameters:

- `limit` (number): Max sections to return (default 3, max 5).
- `query` (string): Keywords to match against doc sections (omit for the index).

### `nifra_example` (~172 tokens)

Get a VERIFIED, copy-pasteable nifra code example for a task - auth route, file upload, ISR page, loader/action, typed client, SSE, deployment, etc. Every snippet is typechecked against the installed nifra version, so it compiles as-is. PREFER THIS over writing nifra code from memory (training data drifts). Returns code as TEXT for direct use; to visually browse the whole example set instead, use nifra_gallery. Call with no query for the grouped index; pass query (e.g. "protected route", "upload", "isr revalidate") for matching snippets.

Input parameters:

- `limit` (number): Max examples to return (default 3, max 5).
- `query` (string): What you want an example of (omit for the index).

### `nifra_types` (~286 tokens)

Get the EXACT TypeScript declaration of any exported @nifrajs/* symbol - interface, type, class, function, const. Each signature is generated from the package's built .d.ts, so it is the LITERAL declaration: complete, authoritative, never prose and never truncated. THIS IS THE SOURCE OF TRUTH for nifra's types - do NOT read node_modules/@nifrajs/**/*.d.ts; call this instead. Pass `name` for an exact symbol (e.g. "RateLimitStore", "RouteSchema", "Context", "rateLimit"); pass `query` to search by keyword; omit both for the per-package index of names. A `name` lookup is always the complete declaration; a `query` returns a one-line summary plus the signature, collapsing an oversized body - pass `full: true` to override.

Input parameters:

- `full` (boolean): Query mode only: return whole declarations instead of collapsed ones. Off by default - a search is for picking a symbol, and one match can be tens of thousands of characters.
- `limit` (number): Max results for a query/search (default 5, max 8).
- `name` (string): Exact symbol name - returns its literal declaration (e.g. RateLimitStore).
- `query` (string): Keyword search over names + signatures (when you don't know the exact name).

### `nifra_learn` (~146 tokens)

Walk the guided path to build a nifra app end to end - an ORDERED sequence (create → page route → loader → typed API → typed client → auth → background jobs → deploy), not the random-access search of nifra_docs/nifra_example. Call with no args for the step index; pass `step: N` for that step's goal, how to do it (which tool emits the correct artifact), and how to verify it. Use it when scaffolding a new app or learning nifra's flow - each step composes the other nifra_* tools.

Input parameters:

- `step` (number): 1-based step number to expand (omit for the index).

### `nifra_gallery` (~79 tokens)

Open an interactive, filterable gallery of ALL of nifra's verified code examples (MCP Apps widget) - for browsing and discovering what exists. NOT for fetching one snippet as text: use nifra_example for that. Pass query to pre-filter; the widget also filters client-side.

Input parameters:

- `query` (string): Pre-filter examples by keyword.

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/nifrajs-nifra-docs/mcp#diagnostics

## Score history

- 2026-08-03: 64
- 2026-08-02: 64

## Links

- Remote endpoint: https://mcp.nifra.dev/
- Repository: https://github.com/nifrajs/nifra
- Website: https://nifra.dev/
- Changelog RSS feed: https://verifymcp.io/servers/nifrajs-nifra-docs/mcp/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/nifrajs-nifra-docs/mcp/changelog.json
- HTML version of this page: https://verifymcp.io/servers/nifrajs-nifra-docs/mcp
