# io.github.xjodoin/rangefind (npm · rangefind-mcp)

Search rangefind static indexes: full-text, geo, autocomplete, facets - no server, just files.

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

## Components

- npm · `rangefind-mcp`: 76/100 (this document), [markdown](https://verifymcp.io/servers/xjodoin-rangefind/rangefind-mcp.md), [page](https://verifymcp.io/servers/xjodoin-rangefind/rangefind-mcp)

## Channel facts

- Registry: `npm`
- Package: `rangefind-mcp`
- Version: `0.3.2`
- 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 (96 of 100), 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 (96 of 100), so this covers what we could see, not the whole tree.
- **Provenance & Transparency**: 97/100
  - Source repository is publicly reachable at the declared URL.
  - Cryptographically verified build provenance (signed, bound to xjodoin/rangefind).
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 19 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 64/100
  - AI-judged instruction clarity (good).
  - Context-footprint check failed: tool/resource definitions use about 686 tokens (~171/item across 4 items; 4 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 23/100
  - Stability observed for 7 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 92/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 76% 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 xjodoin-rangefind -- npx -y rangefind-mcp
```

### Codex

```bash
codex mcp add xjodoin-rangefind -- npx -y rangefind-mcp
```

### opencode

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

### OpenClaw

```bash
openclaw mcp add xjodoin-rangefind --command npx --arg -y --arg rangefind-mcp
```

### Hermes

```yaml
mcp_servers:
  xjodoin-rangefind:
    command: "npx"
    args: ["-y", "rangefind-mcp"]
```

### Other

```json
{
  "mcpServers": {
    "xjodoin-rangefind": {
      "command": "npx",
      "args": [
        "-y",
        "rangefind-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-02 (score 76, +57)

- [security improvement] Install scripts: unverified → pass
- [security improvement] Provenance: unverified → pass
- [security improvement] Known CVEs: unverified → partial
- [security improvement] Malware scan: unverified → pass
- [security] The attested source repository moved: xjodoin/rangefind
- [functional improvement] License: unverified → pass
- [functional improvement] Dependency health: unverified → partial
- [functional improvement] Stability: unverified → 0.20
- [functional improvement] Maintenance: unverified → pass
- [functional improvement] MCP protocol: unverified → pass
- [functional improvement] Schema quality: unverified → good
- [functional] Licence: MIT

### 2026-07-31 (score 19, −24)

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

### 2026-07-28 (score 43, +19)

- [functional improvement] Tool coverage: unverified → 100
- [functional] First check of Tool coverage: 76
- [functional] First check of Schema quality: unverified
- [functional] First check of Schema quality: fail
- [functional] First check of Schema quality: fail

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

First indexed and scored.

## MCP tools (4)

### `rangefind_info` (~115 tokens)

Index metadata

Metadata about a rangefind index: document total, build time, provenance (source/attribution/license/data version), enabled features, and — for sharded indexes — the shard list with ids, groups, coverage bounding boxes, and totals. Call this first to learn what an index contains and how to scope queries.

Input parameters:

- `index` (string, required): Which index to query: a configured index name (see rangefind_list_indexes), or — in open mode — a local directory path or http(s) URL of any rangefind index.

### `rangefind_search` (~308 tokens)

Search an index

Full-text search over a rangefind index: BM25F relevance with typo correction, facet counts, facet/numeric filters, sorting, geo queries (radius, bounding box, nearest-first, distance boost), shard scoping, and pagination. Returns ranked results with their display fields and scores. `total` may be a fast lower bound flagged `approximate`; use rangefind_count for exact totals.

Input parameters:

- `facets` (array): Facet field names to count for this query.
- `filters` (object): Filters, e.g. {"facets":{"category":["restaurant"]},"numbers":{"year":{"min":1990,"max":2000}},"booleans":{"open":true}}.
- `geo` (object): Geo query over an index with geo fields.
- `index` (string, required): Which index to query: a configured index name (see rangefind_list_indexes), or — in open mode — a local directory path or http(s) URL of any rangefind index.
- `page` (integer)
- `q` (string): Query text. May be empty for pure geo/filter browsing.
- `shards` (array): Sharded indexes only: restrict to shard ids or group labels (e.g. ["quebec"] or ["canada"]). Unknown names fail listing the available options.
- `size` (integer)
- `sort` (string): Sort by a number/boolean field: "field" ascending or "-field" descending. Omit for relevance.

### `rangefind_suggest` (~139 tokens)

Autocomplete

Search-as-you-type autocomplete: prefix and mid-token suggestions ranked by weight. Useful to complete a partial place or entity name before a full search.

Input parameters:

- `index` (string, required): Which index to query: a configured index name (see rangefind_list_indexes), or — in open mode — a local directory path or http(s) URL of any rangefind index.
- `q` (string, required): The typed prefix.
- `shards` (array): Sharded indexes only: restrict to shard ids or group labels (e.g. ["quebec"] or ["canada"]). Unknown names fail listing the available options.
- `size` (integer)

### `rangefind_count` (~124 tokens)

Exact match count

Exact number of documents matching a text query, without fetching results. Cheaper than rangefind_search when only the total matters.

Input parameters:

- `index` (string, required): Which index to query: a configured index name (see rangefind_list_indexes), or — in open mode — a local directory path or http(s) URL of any rangefind index.
- `q` (string, required)
- `shards` (array): Sharded indexes only: restrict to shard ids or group labels (e.g. ["quebec"] or ["canada"]). Unknown names fail listing the available options.

## Diagnostics

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

## Score history

- 2026-08-03: 76
- 2026-08-02: 76
- 2026-08-01: 19
- 2026-07-31: 19
- 2026-07-30: 43
- 2026-07-28: 43
- 2026-07-27: 24

## Links

- npm package: https://www.npmjs.com/package/rangefind-mcp
- Socket report: https://socket.dev/npm/package/rangefind-mcp
- Repository: https://github.com/xjodoin/rangefind
- Website: https://rangefind.dev/docs/cli-mcp/
- Changelog RSS feed: https://verifymcp.io/servers/xjodoin-rangefind/rangefind-mcp/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/xjodoin-rangefind/rangefind-mcp/changelog.json
- HTML version of this page: https://verifymcp.io/servers/xjodoin-rangefind/rangefind-mcp