@voidly/mcp-server

Voidly MCP Server

Model Context Protocol (MCP) server for the Voidly Global Censorship Index. Enables AI systems like Claude, ChatGPT, and other MCP-compatible clients to query real-time internet censorship data.

Features

• Real-time censorship data from 50+ countries
• OONI-powered measurements - millions of data points
• Incident tracking - active censorship events
• Zero configuration - works out of the box

Tools

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_active_incidents	Currently active censorship incidents

Installation

Claude Desktop

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

{
  "mcpServers": {
    "voidly": {
      "command": "node",
      "args": ["/path/to/voidly/mcp-server/dist/index.js"]
    }
  }
}

Claude Code

Add to your .claude/settings.json:

{
  "mcpServers": {
    "voidly": {
      "command": "node",
      "args": ["/path/to/voidly/mcp-server/dist/index.js"]
    }
  }
}

NPX (Coming Soon)

npx @voidly/mcp-server

Usage Examples

Once configured, you can ask Claude:

• "What countries have the most internet censorship?"
• "Is the internet censored in China?"
• "What's the censorship status in Iran?"
• "Are there any active internet shutdowns?"
• "Is Twitter blocked in Russia?"

Data Sources

• Primary: OONI (Open Observatory of Network Interference)
• Update Frequency: Every 6 hours
• Countries Monitored: 50+
• License: CC BY 4.0

API Endpoints Used

• https://censorship.voidly.ai/v1/censorship-index
• https://censorship.voidly.ai/v1/censorship-index/:country
• https://censorship.voidly.ai/v1/censorship-index/incidents

Development

# Install dependencies
npm install

# Build
npm run build

# Run in development
npm run dev

License

MIT

Links

• Voidly Global Censorship Index
• API Documentation
• Hugging Face Dataset