# io.github.digitamaz/clarvia (npm · clarvia-mcp-server)

AI agent tool discovery and scoring. Search 15,400+ MCP servers, APIs, and CLIs.

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

## Components

- npm · `clarvia-mcp-server`: 64/100 (this document), [markdown](https://verifymcp.io/servers/digitamaz-clarvia/clarvia-mcp-server.md), [page](https://verifymcp.io/servers/digitamaz-clarvia/clarvia-mcp-server)

## Channel facts

- Registry: `npm`
- Package: `clarvia-mcp-server`
- Version: `1.1.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**: 86/100
  - No malware found by supply-chain analysis.
  - Only part of the dependency tree could be resolved (94 of 98), 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 (94 of 98), so this covers what we could see, not the whole tree.
- **Provenance & Transparency**: 19/100
  - Repository check failed: the declared repository URL redirects; it must resolve directly.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 124 days ago).
  - Security-disclosure policy not yet verified: we couldn't inspect the source repository.
- **Schema Quality & AI Usability**: 77/100
  - AI-judged instruction clarity (excellent).
  - Tool/resource definitions use about 1640 tokens (~102/item across 16 items; 16 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 digitamaz-clarvia -- npx -y clarvia-mcp-server
```

### Codex

```bash
codex mcp add digitamaz-clarvia -- npx -y clarvia-mcp-server
```

### opencode

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

### OpenClaw

```bash
openclaw mcp add digitamaz-clarvia --command npx --arg -y --arg clarvia-mcp-server
```

### Hermes

```yaml
mcp_servers:
  digitamaz-clarvia:
    command: "npx"
    args: ["-y", "clarvia-mcp-server"]
```

### Other

```json
{
  "mcpServers": {
    "digitamaz-clarvia": {
      "command": "npx",
      "args": [
        "-y",
        "clarvia-mcp-server"
      ]
    }
  }
}
```

## 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, +1)

No change was recorded against any check on this day. Stability & Change Management went from 23 to 27. That category is still filling its 30-day observation window: 7 days of observed history at the previous scan, 8 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-08-02 (score 63, +63)

- [security regression] Provenance: unverified → fail
- [security improvement] Install scripts: unverified → pass
- [security improvement] Known CVEs: unverified → partial
- [security improvement] Malware scan: unverified → pass
- [functional improvement] Schema quality: unverified → excellent
- [functional improvement] Dependency health: unverified → partial
- [functional improvement] Maintenance: unverified → pass
- [functional improvement] MCP protocol: unverified → pass
- [functional improvement] Stability: unverified → 0.23
- [functional improvement] Tool coverage: unverified → 100
- [functional improvement] License: unverified → pass
- [functional] Licence: MIT

### 2026-08-01 (score 0, −22)

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

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

- [security regression] Malware scan: pass → unverified

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

First indexed and scored.

## MCP tools (16)

### `search_services` (~138 tokens)

Search 15,400+ AI agent tools (MCP servers, APIs, CLIs) by keyword, category, or score. Use when you need to find the best tool for a specific task, compare alternatives, or check agent readiness. Returns Clarvia AEO scores (0-100) indicating how easily AI agents can discover and use each service.

Input parameters:

- `category` (string): Filter by category
- `limit` (number): Max results to return
- `min_score` (number): Minimum Clarvia score (0-100)
- `query` (string): Search keyword
- `service_type` (string): Filter by service type

### `scan_service` (~86 tokens)

Run a full AEO audit on any URL — evaluates agent discoverability, API quality, documentation, and MCP readiness. Use when you need to score a website or API for AI agent compatibility, or when building an agent and want to verify a tool meets quality standards. Returns a Clarvia score (0-100) with detailed breakdown.

Input parameters:

- `url` (string, required): URL to scan

### `get_service_details` (~84 tokens)

Get the full AEO evaluation report for a previously scanned service. Use when you need detailed scoring breakdown (documentation, API design, error handling, auth, MCP support) or want to understand why a tool scored high or low. Requires a scan_id from search_services or scan_service results.

Input parameters:

- `scan_id` (string, required): Scan ID from a previous scan or search result

### `list_categories` (~53 tokens)

List all tool categories in the Clarvia directory with service counts per category. Use when you need to browse available categories before searching, discover what types of AI tools exist, or build a category-based navigation for agent tool selection.

### `get_stats` (~64 tokens)

Get aggregate statistics for the Clarvia tool directory — total indexed services, average AEO score, score distribution, and category breakdown. Use when you need an overview of the AI tool ecosystem quality, want to benchmark a tool against the average, or report on agent-readiness trends.

### `register_service` (~119 tokens)

Submit a new AI tool, MCP server, API, or CLI for Clarvia indexing and AEO scoring. Use when you want to register your service in the directory, get an agent-readiness evaluation, or make your tool discoverable by AI agents. The service will be queued for automated scanning.

Input parameters:

- `category` (string, required): Service category
- `description` (string, required): Brief description of the service
- `github_url` (string): GitHub repository URL
- `name` (string, required): Service name
- `url` (string, required): Service URL

### `clarvia_gate_check` (~113 tokens)

Before calling any external API or MCP, use this to check if it is agent-ready. Returns AGENT_NATIVE / AGENT_FRIENDLY / AGENT_POSSIBLE / AGENT_HOSTILE with a boolean pass/fail. Call this first — if the service scores below your threshold, use clarvia_find_alternatives to get a better-rated replacement automatically.

Input parameters:

- `min_rating` (string): Minimum acceptable grade (default: AGENT_FRIENDLY)
- `url` (string, required): Service URL to check

### `clarvia_batch_check` (~89 tokens)

Batch-check up to 10 service URLs in a single call — returns pass/fail and agent grade for each. Use when comparing multiple tool candidates side-by-side, pre-filtering a list of APIs before integration, or building an agent that selects the best tool from several options. More efficient than calling gate_check repeatedly.

Input parameters:

- `urls` (array, required): List of service URLs (max 10)

### `clarvia_find_alternatives` (~129 tokens)

Find higher-rated alternative tools in a given category, ranked by agent-readiness score. Use when a service fails the gate check and you need a replacement, when comparing options in a category (payment, AI, crypto, SaaS), or when an agent needs to fall back to a better-scored tool automatically.

Input parameters:

- `category` (string, required): Service category (e.g. 'payment', 'ai', 'crypto', 'saas')
- `limit` (number): Max results (default: 10)
- `min_score` (number): Minimum score (default: 70)

### `clarvia_probe` (~92 tokens)

Run a live accessibility probe on a service URL right now — checks HTTP reachability, response latency, OpenAPI/Swagger spec presence, MCP server-card availability, and agents.json discovery endpoint. Use when you need real-time health status (not cached scores), want to verify a service is online before calling it, or are debugging connectivity issues with an agent tool.

Input parameters:

- `url` (string, required): Service URL to probe

### `clarvia_submit_feedback` (~124 tokens)

Report the outcome after using a tool (success / failure / partial) to contribute to Clarvia's reliability dataset. Use after every agent tool invocation to help build community-driven quality signals. Accepts optional latency and error details. Improves future agent tool selection accuracy for all users.

Input parameters:

- `agent_id` (string): Your agent identifier
- `error_message` (string): Error details if failed
- `latency_ms` (number): Response latency in ms
- `outcome` (string, required): Usage outcome
- `profile_id` (string, required): Profile ID of the service used

### `register_my_setup` (~133 tokens)

Register your current tool setup (MCP servers, CLIs, APIs, Skills) with Clarvia to get AEO scores and category rankings for each tool. Use when you want to benchmark your agent's toolchain, track setup quality over time, or prepare for comparison and upgrade recommendations. Returns a setup_id for use with compare_my_setup and recommend_upgrades.

Input parameters:

- `setup_id` (string): Custom setup ID (auto-generated hash if omitted)
- `tools` (array, required): List of tool names you currently use (e.g. ['dune-mcp', 'notion-mcp', 'telegram-bot'])

### `compare_my_setup` (~79 tokens)

Compare your registered tool setup against higher-scored alternatives in each category. Shows the best available upgrades for each tool and the category average score. Use after register_my_setup to identify weak spots in your toolchain and find better-rated replacements. Requires a setup_id from register_my_setup.

Input parameters:

- `setup_id` (string, required): Setup ID from register_my_setup

### `clarvia_report_issue` (~156 tokens)

Report a bug, request a feature, ask a question, or flag a security issue with Clarvia or any indexed tool. Use when you encounter problems with a tool's AEO score, find incorrect data, want to suggest improvements to the Clarvia platform, or discover a security vulnerability. Creates a tracked ticket that the Clarvia team will address.

Input parameters:

- `agent_id` (string): Your agent identifier for tracking
- `description` (string, required): Detailed description — include steps to reproduce for bugs
- `service_url` (string): Related service URL if applicable
- `severity` (string): Severity level (default: medium)
- `title` (string, required): Short summary of the issue
- `type` (string, required): Issue type

### `clarvia_list_issues` (~89 tokens)

List existing CS tickets — check status of previously reported issues, see what bugs are known, or find feature requests to upvote. Use to avoid duplicate reports or to track the status of your submitted tickets.

Input parameters:

- `agent_id` (string): Filter by your agent ID to see your tickets
- `status` (string): Filter by status
- `type` (string): Filter by type

### `recommend_upgrades` (~92 tokens)

Get personalized tool recommendations based on your registered setup. Suggests high-scoring tools you don't have yet — both within your existing categories and in complementary adjacent categories. Uses 'users with X also use Y' heuristics. Requires a setup_id from register_my_setup.

Input parameters:

- `limit` (number): Max recommendations to return (default: 10)
- `setup_id` (string, required): Setup ID from register_my_setup

## Diagnostics

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

## Score history

- 2026-08-03: 64
- 2026-08-02: 63
- 2026-08-01: 0
- 2026-07-31: 22
- 2026-07-30: 40
- 2026-07-28: 40
- 2026-07-27: 40

## Links

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