# Clervo Connect (npm · @clervo/mcp)

Free-first Clervo tools and bounded opt-in commerce through one local wallet.

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

## Components

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

## Channel facts

- Registry: `npm`
- Package: `@clervo/mcp`
- Version: `0.5.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-15.

- **Supply Chain Security**: 99/100
  - No malware found by supply-chain analysis.
  - No known CVEs affecting this package version or its production dependencies.
  - No install/post-install scripts declared.
  - 30 of 116 dependencies flagged as unhealthy.
- **Provenance & Transparency**: 100/100
  - Source repository is publicly reachable at the declared URL.
  - Cryptographically verified build provenance (signed, bound to clervo/clervo).
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 3 days ago).
  - Publishes a security disclosure policy (SECURITY.md).
- **Schema Quality & AI Usability**: 59/100
  - AI-judged instruction clarity (fair).
  - Tool/resource definitions use about 394 tokens (~43/item across 9 items; 9 tools + 0 resources), lean.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **Tool Coverage**: 78/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 33% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

**Unverified: 1 category.** A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

## Install

### Claude

```bash
claude mcp add clervo-connect -- npx -y @clervo/mcp
```

### Codex

```bash
codex mcp add clervo-connect -- npx -y @clervo/mcp
```

### opencode

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

### OpenClaw

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

### Hermes

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

### Other

```json
{
  "mcpServers": {
    "clervo-connect": {
      "command": "npx",
      "args": [
        "-y",
        "@clervo/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-12 (score 74, +15)

- [security improvement] Malware scan: unverified → pass

### 2026-08-11 (score 59)

First indexed and scored.

## MCP tools (9)

### `search_web` (~92 tokens)

Clervo web evidence preview

Runs the live bounded free Search route or obtains its exact paid challenge without signing.

Input parameters:

- `idempotencyKey` (string)
- `language` (string)
- `maxResults` (integer)
- `mode` (string): Preview calls the live free route. Challenge obtains the exact paid 402 but never signs or pays.
- `query` (string, required): The evidence query.
- `region` (string)

### `models_list` (~32 tokens)

List the live Clervo AI catalog

Returns stable provider-neutral model IDs, capabilities, health, availability, free/paid state, pricing, and commerce metadata.

### `ai_execute` (~101 tokens)

Execute a normalized Clervo AI request

Executes a free model or returns the exact paid challenge without signing or paying. The tool never creates a wallet or authorizes payment.

Input parameters:

- `idempotencyKey` (string)
- `input` (object, required): Normalized AI input object; its kind must match the selected model capability.
- `maximumOutputTokens` (integer)
- `maximumReasoningTokens` (integer)
- `model` (string, required): Stable canonical Clervo model ID or a published alias.

### `clervo_execute` (~91 tokens)

Execute a currently served Clervo full operation

Generic execution for the full profile. Runtime registry truth is checked on every call. Automatic payment is disabled; payable calls return a quote.

Input parameters:

- `body` (object, required)
- `idempotencyKey` (string)
- `paid` (boolean): For a product with a free path, explicitly request its paid path. Signing still requires local --auto-pay opt-in.
- `productId` (string, required)

### `connect_status` (~16 tokens)

Clervo wallet and shared Connect status

Clervo wallet and shared Connect status

### `spend_limits` (~15 tokens)

Clervo buyer-side spend limits

Clervo buyer-side spend limits

### `local_usage` (~14 tokens)

Clervo durable local usage

Clervo durable local usage

### `reconcile` (~18 tokens)

Reconcile unresolved Clervo operations without a new payment

Reconcile unresolved Clervo operations without a new payment

### `doctor` (~15 tokens)

Diagnose the local Clervo Connect installation

Diagnose the local Clervo Connect installation

## Diagnostics

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

## Score history

- 2026-08-15: 74
- 2026-08-14: 74
- 2026-08-13: 74
- 2026-08-12: 74
- 2026-08-11: 59

## Links

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