@voidly/mcp-server

Voidly MCP Server

Model Context Protocol (MCP) server for the Voidly Global Censorship Index. Enables AI systems to query real-time internet censorship data.

Data Scale

• 11.7M live OONI measurements
• 1B+ historical measurements (10-year archive)
• 80+ countries monitored
• 5,356+ verified censorship incidents
• 16+ probe nodes (dedicated + community)
• Updated every 5 minutes

Installation

npx @voidly/mcp-server

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "voidly": {
      "command": "npx",
      "args": ["@voidly/mcp-server"]
    }
  }
}

Cursor / Windsurf / Cline

Add to your MCP config:

{
  "mcpServers": {
    "voidly": {
      "command": "npx",
      "args": ["@voidly/mcp-server"]
    }
  }
}

Tools (27)

Core Data

Tool	Description
get_censorship_index	Global overview of all monitored countries
get_country_status	Detailed status for a specific country
check_domain_blocked	Check if a domain is blocked in a country
get_most_censored	Ranked list of most censored countries
get_domain_status	Domain blocking status across ALL countries
get_domain_history	Historical blocking timeline for a domain
compare_countries	Side-by-side censorship comparison

Incidents

Tool	Description
get_active_incidents	Currently active censorship incidents
get_incident_detail	Full details for a specific incident by ID
get_incident_evidence	Verifiable evidence sources for an incident
get_incident_report	Citable report (markdown, BibTeX, RIS)
get_incident_stats	Aggregate incident statistics
get_incidents_since	Delta feed for incremental sync
verify_claim	Verify a censorship claim with evidence

Risk Intelligence

Tool	Description
get_risk_forecast	7-day predictive shutdown risk
get_high_risk_countries	Countries at elevated risk
get_platform_risk	Per-platform censorship risk
get_isp_risk_index	ISP censorship rankings
check_service_accessibility	Real-time accessibility check
get_election_risk	Election-censorship risk briefing

Probe Network

Tool	Description
get_probe_network	16-node probe network status
check_domain_probes	Per-domain probe results with attribution
check_vpn_accessibility	VPN reachability by country
get_isp_status	ISP-level blocking breakdown
get_community_probes	Community probe node listing
get_community_leaderboard	Top probe contributors

Alerts

Tool	Description
get_alert_stats	Alert system health and statistics

Usage Examples

Once configured, you can ask:

• "What countries have the most internet censorship?"
• "Is Twitter blocked in Iran?"
• "Show me evidence for incident IR-2026-0142"
• "Generate a BibTeX citation for the Iran DNS blocking incident"
• "What new censorship incidents happened since yesterday?"
• "Which countries are most likely to have internet shutdowns this week?"
• "How blocked is WhatsApp globally?"
• "Can users in China access VPNs?"
• "Show me the community probe leaderboard"

Other AI Platforms

OpenAI / ChatGPT

MCP isn't supported by OpenAI yet. Use our OpenAI Action instead:

• Go to ChatGPT > Create GPT > Actions
• Import openai-action/openapi.yaml
• Your GPT can now query Voidly data

Direct API

Public endpoints (no auth):

• https://api.voidly.ai/data/censorship-index.json
• https://api.voidly.ai/data/country/{code}
• https://api.voidly.ai/data/incidents
• https://api.voidly.ai/data/methodology

Data Sources

• Primary: OONI (Open Observatory of Network Interference)
• Secondary: IODA, CensoredPlanet, Voidly Probe Network (16 dedicated + community)
• ML Model: 99.8% F1 GradientBoosting classifier
• Forecast: XGBoost 7-day shutdown prediction
• License: CC BY 4.0

Community Probes

Run your own censorship probe node:

pip install voidly-probe
voidly-probe --consent

Or via Docker:

docker run -d --name voidly-probe emperormew2/voidly-probe

Development

npm install
npm run build
npm run dev

Links

• Voidly Censorship Index
• npm Package
• API Docs
• OpenAI Action Spec
• Community Probes

License

MIT