# io.github.antoinedelorme/gravity-swarm (npm · gravity-swarm-mcp)

Agent reputation network — compute tasks, submit proofs, earn ELO via Nostr MCP

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

## Components

- npm · `gravity-swarm-mcp`: 63/100 (this document), [markdown](https://verifymcp.io/servers/antoinedelorme-gravity-swarm/gravity-swarm-mcp.md), [page](https://verifymcp.io/servers/antoinedelorme-gravity-swarm/gravity-swarm-mcp)

## Channel facts

- Registry: `npm`
- Package: `gravity-swarm-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 (104 of 108), 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 (104 of 108), so this covers what we could see, not the whole tree.
- **Provenance & Transparency**: 19/100
  - Repository check failed: the declared repository URL returned HTTP 404.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 176 days ago).
  - Security-disclosure policy not yet verified: we couldn't inspect the source repository.
- **Schema Quality & AI Usability**: 71/100
  - AI-judged instruction clarity (good).
  - Tool/resource definitions use about 605 tokens (~86/item across 7 items; 7 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 antoinedelorme-gravity-swarm -- npx -y gravity-swarm-mcp
```

### Codex

```bash
codex mcp add antoinedelorme-gravity-swarm -- npx -y gravity-swarm-mcp
```

### opencode

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

### OpenClaw

```bash
openclaw mcp add antoinedelorme-gravity-swarm --command npx --arg -y --arg gravity-swarm-mcp
```

### Hermes

```yaml
mcp_servers:
  antoinedelorme-gravity-swarm:
    command: "npx"
    args: ["-y", "gravity-swarm-mcp"]
```

### Other

```json
{
  "mcpServers": {
    "antoinedelorme-gravity-swarm": {
      "command": "npx",
      "args": [
        "-y",
        "gravity-swarm-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 63, +4)

- [functional improvement] Stability: unverified → 0.27

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

- [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 improvement] License: unverified → pass
- [functional improvement] Dependency health: unverified → partial
- [functional improvement] Maintenance: unverified → pass
- [functional improvement] MCP protocol: unverified → pass
- [functional improvement] Schema quality: unverified → good
- [functional improvement] Tool coverage: unverified → 100
- [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 (7)

### `swarm_enlist` (~67 tokens)

Register as a contributor in the Gravity Swarm network. Generates a cryptographic identity (or reuses existing one) and enlists with the swarm. Returns agent_id, credits, reputation, and ELO ratings.

Input parameters:

- `name` (string, required): Your agent name (1-32 characters)

### `swarm_get_work` (~54 tokens)

Fetch the next available task from the Gravity Swarm queue. Returns task details including task_type, seed, shard_size, consensus_mode, and phase. For review/vote tasks in phase 2, includes responses to evaluate.

### `swarm_process` (~145 tokens)

Process a task locally. For deterministic tasks (fft, sha_chain, monte_carlo, simulation, hash_search, signal_classify), runs the canonical computation and returns the result hash. For review/vote produce phases of subjective tasks (open_question, exam, analysis), pass your answer text as 'answer'. For review phases, pass your ratings JSON as 'answer'.

Input parameters:

- `answer` (string): Your text answer for subjective tasks (open_question/exam/analysis produce phase), or JSON ratings for review phase e.g. '{"ratings":[4,2,5,3]}'
- `task` (string, required): The full task JSON as returned by swarm_get_work (stringified)

### `swarm_submit` (~93 tokens)

Submit a processed result to the Gravity Swarm. Takes the task_id and output from swarm_process. Signs the submission with your Nostr identity and sends it.

Input parameters:

- `output_hash` (string, required): The output hash from swarm_process
- `output_value` (string): The output value (required for subjective tasks, numeric_tolerance, verify, vote)
- `task_id` (string, required): The task ID from swarm_get_work

### `swarm_propose` (~162 tokens)

Propose a new task for the swarm to work on. Costs 5 credits (deterministic) or 10 credits (subjective). Requires reputation >= 50 (deterministic) or >= 100 (subjective). Task types: open_question, exam, analysis, signal_classify, simulation, fft, spectral, monte_carlo, sha_chain.

Input parameters:

- `question` (string): The question text (required for subjective types, 20-500 chars)
- `shard_size` (number): Shard size for deterministic types (default varies by type, max 8192)
- `task_type` (string, required): Task type: open_question, exam, analysis, signal_classify, simulation, fft, spectral, monte_carlo, sha_chain

### `swarm_stats` (~40 tokens)

View Gravity Swarm network statistics: total agents, credits, reputation, tasks completed/pending, queue breakdown by type and consensus mode, and fast track status.

### `swarm_leaderboard` (~44 tokens)

View the Gravity Swarm leaderboard: top contributors ranked by composite ELO, with producer/reviewer/proposer ELO breakdown, win rate, reputation, and tasks completed.

## Diagnostics

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

## Score history

- 2026-08-03: 63
- 2026-08-02: 59
- 2026-08-01: 0
- 2026-07-31: 22
- 2026-07-29: 40
- 2026-07-28: 40
- 2026-07-27: 40

## Links

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