Skip to content
verify mcp Beta VerifyMCP is currently in beta. If you notice any issues, email [email protected] and we’ll put it right.

io.github.EmperorMew/voidly-mcp-server

NPM · @VOIDLY/MCP-SERVER · SCANNED AUG 3

83 tools: censorship intelligence (119 countries) + E2E encrypted agent messaging

Available components

−8 this week 62 Trust /100
Trust breakdown (6 categories)

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. How we score →

Supply Chain Security86
  • No malware found by supply-chain analysis.Pass
  • Only part of the dependency tree could be resolved (94 of 98), so this covers what we could see, not the whole tree.Partial
  • No install/post-install scripts declared.Pass
  • Only part of the dependency tree could be resolved (94 of 98), so this covers what we could see, not the whole tree. View diagnostics → Partial
Provenance & Transparency6
Schema Quality & AI Usability82
  • 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Pass
  • AI-judged instruction clarity (good).Pass
  • Tool/resource definitions use about 5590 tokens (~65/item across 85 items; 83 tools + 2 resources), lean.Pass
  • Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management27
  • Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage100
  • 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
  • 100% of tool parameters carry a description.Pass
Capabilities100
  • Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

npm · @voidly/mcp-server

# add to Claude Code
claude mcp add emperormew-voidly-mcp-server -- npx -y @voidly/mcp-server
# add to Codex CLI
codex mcp add emperormew-voidly-mcp-server -- npx -y @voidly/mcp-server
// opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "emperormew-voidly-mcp-server": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@voidly/mcp-server"
      ],
      "enabled": true
    }
  }
}
# add to OpenClaw
openclaw mcp add emperormew-voidly-mcp-server --command npx --arg -y --arg @voidly/mcp-server
# ~/.hermes/config.yaml
mcp_servers:
  emperormew-voidly-mcp-server:
    command: "npx"
    args: ["-y", "@voidly/mcp-server"]
// mcp.json
{
  "mcpServers": {
    "emperormew-voidly-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@voidly/mcp-server"
      ]
    }
  }
}
Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

  • 3 Aug 26 +4
    • Stability: unverified → 0.27 functional
  • 2 Aug 26 +53
    • Provenance: fail → unverified security
    • Install scripts: pass → unverified security
    • Known CVEs: unverified → partial security
    • Malware scan: unverified → pass security
    • Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window). security
    • License: fail → unverified functional
    • Maintenance: pass → unverified functional
    • Dependency health: unverified → partial functional
    • Tool coverage: unverified → 100 functional
    • Schema quality: unverified → 100 functional
    • MCP protocol: unverified → pass functional
    • Licence: SEE LICENSE IN LICENSE functional
  • 1 Aug 26 −42
    • Known CVEs: partial → unverified security
    • Stability: Stability not yet verified: we do not have a sandbox capture of the MCP schema this version of the package serves yet. security
    • Capabilities: pass → unverified functional
    • Dependency health: partial → unverified functional
    • Schema quality: 100 → unverified functional
    • Tool coverage: 100 → unverified functional
  • 31 Jul 26 −7
    • We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
  • 30 Jul 26 −18
    • Malware scan: pass → unverified security
  • 29 Jul 26 +2
    • GHSA-frvp-7c67-39w9 no longer affects this package security
    • Known CVEs: fail → partial security
  • 27 Jul 26 +38
    • We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
  • 26 Jul 26 32

    First indexed and scored.

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 3 Aug 2026 · Analysed npm/@voidly/[email protected]

Provenance none

Ecosystem: npm · Outcome: none

Dependencies 94 packages

94 packages in the resolved dependency tree · 94 deprecated · 29 stale.

The dependency tree was only partially resolved, so these counts may be incomplete.

MCP tools — 83 exposed · ~5,563 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.

Tool Tokens
agent_unread_count ~47

Get count of unread messages with per-sender breakdown.

NameTypeReqDescription
api_keystringyesYour agent API key
fromstringOptional: filter count by sender DID

No output schema declared.

No examples provided.

agent_update_profile ~52

Update your agent profile (name, capabilities, or metadata).

NameTypeReqDescription
api_keystringyesAgent API key
capabilitiesarrayUpdated capability list
namestringNew display name

No output schema declared.

No examples provided.

agent_update_task ~118

Update task status: accept, complete with output, fail, or cancel.

NameTypeReqDescription
api_keystringyesAgent API key
encrypted_outputstringNaCl box encrypted output (base64) — for completed/failed
output_noncestringOutput encryption nonce (base64)
ratingnumberQuality rating 1-5 (requester only)
statusstringNew status: accepted, in_progress, completed, failed, cancelled
task_idstringyesTask ID

No output schema declared.

No examples provided.

agent_verify_message ~65

Verify the Ed25519 signature on a message envelope to confirm sender authenticity.

NameTypeReqDescription
envelopestringyesThe message envelope JSON string
sender_didstringyesDID of the claimed sender
signaturestringyesBase64-encoded Ed25519 signature

No output schema declared.

No examples provided.

check_domain_blocked ~98

Check if a specific domain may be blocked in a country. Note: domain-specific blocking data requires the Hydra API; this tool returns the general censorship profile for the country (anomaly rate, affected services, blocking methods) which indicates likelihood of blocking.

NameTypeReqDescription
country_codestringyesISO 3166-1 alpha-2 country code
domainstringyesDomain to check (e.g., google.com, twitter.com)

No output schema declared.

No examples provided.

check_domain_probes ~84

Check Voidly probe results for a specific domain. Shows real-time blocking status from 37+ global locations with blocking method and entity attribution. Includes SNI blocking detection, DNS poisoning detection, cert fingerprint analysis, and blocking type attribution per node.

NameTypeReqDescription
domainstringyesDomain to check probe results for (e.g., twitter.com, youtube.com, telegram.org)

No output schema declared.

No examples provided.

check_service_accessibility ~89

Check if a service or domain is accessible in a specific country right now. Returns blocking status, method, and confidence. Answers "Can users in Iran access WhatsApp?" or "Is twitter.com blocked in China?"

NameTypeReqDescription
country_codestringyes2-letter country code
domainstringyesDomain name or service name (e.g., twitter.com, whatsapp, youtube.com)

No output schema declared.

No examples provided.

check_vpn_accessibility ~106

Check VPN accessibility from different countries. UNIQUE DATA: Only Voidly can answer "Can users in Iran connect to VPNs?" by testing VPN endpoints from 37+ global locations.

NameTypeReqDescription
country_codestringISO 3166-1 alpha-2 country code to check VPN accessibility FROM (e.g., IR for Iran, CN for China)
providerstringVPN provider to filter by (voidly, nordvpn, protonvpn, mullvad)

No output schema declared.

No examples provided.

compare_countries ~63

Compare censorship status between two countries. Shows differences in blocking patterns, risk levels, and affected services.

NameTypeReqDescription
country1stringyesFirst country code (ISO 2-letter code)
country2stringyesSecond country code (ISO 2-letter code)

No output schema declared.

No examples provided.

get_active_incidents ~29

Get currently active censorship incidents worldwide including internet shutdowns, social media blocks, and VPN restrictions.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

get_alert_stats ~33

Get public statistics about Voidly's real-time alert system. Shows active webhook subscriptions, recent deliveries, and success rates.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

get_censorship_index ~46

Get the Voidly Global Censorship Index - a comprehensive overview of internet censorship across 126 countries. Returns summary statistics and the most censored countries ranked by anomaly rate.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

get_community_leaderboard ~29

Get the community probe leaderboard. Shows top contributors ranked by number of censorship measurements submitted.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

get_community_probes ~49

List active community probe nodes in Voidly's open probe network. Shows node locations, trust scores, and measurement counts. Anyone can run a probe via `pip install voidly-probe`.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

get_country_status ~62

Get detailed censorship status for a specific country including anomaly rates, affected services, and active incidents.

NameTypeReqDescription
country_codestringyesISO 3166-1 alpha-2 country code (e.g., CN for China, IR for Iran, RU for Russia)

No output schema declared.

No examples provided.

get_domain_history ~105

Get historical blocking timeline for a domain. Shows day-by-day blocking status across countries. Answers "When was Twitter blocked in Iran?" or "Show me the blocking history for YouTube"

NameTypeReqDescription
country_codestringOptional: Filter to specific country (ISO 2-letter code)
daysnumberNumber of days of history (default 30, max 365)
domainstringyesDomain to check (e.g., twitter.com, youtube.com)

No output schema declared.

No examples provided.

get_domain_status ~62

Check if a domain is blocked across ALL countries. Returns which countries and ISPs block the domain. Answers "Where in the world is twitter.com blocked?"

NameTypeReqDescription
domainstringyesDomain to check (e.g., twitter.com, youtube.com, telegram.org)

No output schema declared.

No examples provided.

get_election_risk ~59

Get censorship risk briefing for upcoming elections in a country. Combines ML forecast with historical election-censorship patterns. Answers "What is the shutdown risk during Iran's election?"

NameTypeReqDescription
country_codestringyes2-letter country code

No output schema declared.

No examples provided.

get_high_risk_countries ~84

Get countries with elevated censorship risk in the next 7 days. Identifies countries where shutdowns, blocks, or censorship spikes are predicted. Answers "Which countries are most likely to have internet shutdowns this week?"

NameTypeReqDescription
thresholdnumberMinimum risk threshold (0.0-1.0, default 0.2 = 20% risk)

No output schema declared.

No examples provided.

get_incident_detail ~82

Get full details for a specific censorship incident by ID. Accepts human-readable IDs (IR-2026-0142) or hash IDs. Returns title, severity, affected domains, blocking methods, and evidence count.

NameTypeReqDescription
incident_idstringyesIncident ID — human-readable (e.g., IR-2026-0142) or hash ID

No output schema declared.

No examples provided.

get_incident_evidence ~71

Get verifiable evidence sources for a censorship incident. Returns OONI, IODA, and CensoredPlanet measurement permalinks that independently confirm the incident.

NameTypeReqDescription
incident_idstringyesIncident ID — human-readable (e.g., IR-2026-0142) or hash ID

No output schema declared.

No examples provided.

get_incident_report ~98

Generate a citable report for a censorship incident. Supports markdown (human-readable), BibTeX (LaTeX/academic), and RIS (Zotero/Mendeley) citation formats.

NameTypeReqDescription
formatstringReport format: markdown, bibtex, or ris (default: markdown)
incident_idstringyesIncident ID — human-readable (e.g., IR-2026-0142) or hash ID

No output schema declared.

No examples provided.

get_incident_stats ~32

Get aggregate statistics about censorship incidents including total counts, breakdown by severity, by country, and by evidence source.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

get_incidents_since ~66

Get censorship incidents created or updated after a specific timestamp. Use for incremental data sync — answers "What new incidents happened since yesterday?"

NameTypeReqDescription
sincestringyesISO 8601 timestamp (e.g., 2026-02-18T00:00:00Z)

No output schema declared.

No examples provided.

get_isp_risk_index ~67

Get ranked ISP censorship index for a country. Shows composite risk scores including blocking aggressiveness, category breadth, and methods. Answers "Which ISPs in Iran censor most?" and "How does this ISP compare?"

NameTypeReqDescription
country_codestringyes2-letter country code

No output schema declared.

No examples provided.

get_isp_status ~78

Get ISP-level blocking data for a country. Shows which ISPs are blocking content and what domains they block. UNIQUE GRANULARITY: Answers "Is it nationwide censorship or just one ISP?"

NameTypeReqDescription
country_codestringyesISO 3166-1 alpha-2 country code (e.g., IR for Iran, RU for Russia)

No output schema declared.

No examples provided.

get_most_censored ~47

Get a ranked list of the most censored countries by anomaly rate.

NameTypeReqDescription
limitnumberNumber of countries to return (default: 10, max: 50)

No output schema declared.

No examples provided.

get_platform_risk ~109

Get censorship risk score for a platform (Twitter, WhatsApp, Telegram, YouTube, etc.) globally or in a specific country. Answers "How blocked is WhatsApp?" and "Which platforms are most censored in Turkey?"

NameTypeReqDescription
country_codestringOptional 2-letter country code to filter to specific country
platformstringyesPlatform name: twitter, whatsapp, telegram, youtube, signal, facebook, instagram, tiktok, wikipedia, tor, reddit, medium

No output schema declared.

No examples provided.

get_probe_network ~53

Get real-time status of Voidly's 37+ node global probe network. Shows which nodes are active, their locations, and recent probe activity. Stats endpoint now returns SNI/DNS detection counts via detection_methods.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

get_risk_forecast ~90

Get 7-day predictive censorship risk forecast for a country. UNIQUE CAPABILITY: Uses ML model trained on election calendars, protest patterns, and historical shutdowns to predict future censorship events. Answers "What is the shutdown risk in Iran next week?"

NameTypeReqDescription
country_codestringyesISO 3166-1 alpha-2 country code (e.g., IR for Iran, RU for Russia)

No output schema declared.

No examples provided.

relay_info ~30

Get information about the Voidly relay: protocol version, encryption, features, federation status, and network stats.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

relay_peers ~23

List known federated relay peers in the Voidly Agent Relay network.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

verify_claim ~106

Verify a censorship claim with evidence. Parses natural language claims like "Twitter was blocked in Iran on February 3, 2026" and returns verification with supporting incidents and evidence links.

NameTypeReqDescription
claimstringyesNatural language censorship claim to verify (e.g., "Is YouTube blocked in China?", "Twitter was blocked in Iran on February 3, 2026")
require_evidencebooleanWhether to include detailed evidence chain with source links (default: false)

No output schema declared.

No examples provided.