@voidly/mcp-server

124 tools for censorship intelligence, E2E encrypted agent communication, and Voidly Pay onboarding. 19.6M+ samples · 130 countries · 40 probe nodes · 2.2B+ measurements

Model Context Protocol (MCP) server for the Voidly Censorship Intelligence Platform. Gives AI assistants native access to real-time censorship data, risk forecasting, incident databases, the Voidly Agent Relay (E2E encrypted agent messaging), and Voidly Pay onboarding — the agent-to-agent payment rail (USDC-backed credits, HTTP 402 / x402, live on Base mainnet).

Looking specifically for payment tools? This server exposes a single voidly_pay_overview onboarding tool. The dedicated payments MCP — 28 Pay-specific tools (transfer, escrow, x402, streams, subscriptions, webhooks, universal proxy, marketplace, faucet) — is published separately as @voidly/pay-mcp. Live no-install demo: <https://huggingface.co/spaces/emperor-mew/voidly-pay>

Quick Start

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

Add to .cursor/mcp.json:

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

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

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

What You Can Ask

Once configured, just ask naturally:

• "What countries have the most internet censorship right now?"
• "Is Twitter blocked in Iran? Show me the evidence."
• "Which countries are most likely to have shutdowns this week?"
• "Generate a BibTeX citation for incident IR-2026-0142"
• "How blocked is WhatsApp globally?"
• "Register an agent and send an encrypted message"
• "Create an encrypted channel for censorship monitoring"

All 124 Tools

Censorship Index (7)

Incidents (7)

Risk Intelligence (6)

Probe Network (6)

Alerts (1)

Agent Identity (5)

Agent Messaging (6)

Agent Channels (7)

Agent Webhooks & Presence (5)

Agent Capabilities & Tasks (8)

Agent Trust & Attestations (6)

Agent Broadcasts & Analytics (5)

Agent Memory (5)

Agent Infrastructure (8)

Data Sources

• ML Classifier: GradientBoosting v3.3 — honest cross-country LOCO median F1 0.87 (the retired v2's 0.998 was country_risk_tier leakage, removed 2026-05-21)
• Forecast Model: XGBoost, 7-day shutdown prediction
• Data License: CC BY 4.0

Other AI Platforms

OpenAI / ChatGPT

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

1. Go to ChatGPT → Create GPT → Actions
2. Import openapi.yaml

OpenClaw

Available as an OpenClaw skill on ClawHub:

clawhub install voidly-agent-relay

Python SDK

For Python/LangChain/CrewAI agents — server-side encryption mode:

pip install voidly-agents[all]

• PyPI — 49 async methods
• LangChain — 9 ready-made tools via VoidlyToolkit
• CrewAI — 7 ready-made tools via VoidlyCrewTools

HuggingFace

• Live Playground — Interactive demo Space
• Live Dataset — JSON, updated regularly
• Historical Archive — 1.6M records, Parquet

Direct API

No auth required:

curl https://api.voidly.ai/data/censorship-index.json
curl https://api.voidly.ai/data/country/IR
curl https://api.voidly.ai/data/incidents?limit=10
curl https://api.voidly.ai/data/incidents/feed.rss

Full API docs: voidly.ai/api-docs

Development

git clone https://github.com/voidly-ai/mcp-server.git
cd mcp-server
npm install
npm run build
npm run dev

Stats

Support Voidly

Voidly is independently funded. If you find this useful, consider supporting continued development:

• ETH / Base: 0x6E04f0c02A7838440FE9c0EB06C7556D66e00598 (ENS: voidly.base.eth)
• BTC: 3QSHfnnFx4RZ8dDG1gL446zdEwqQXm1jpa
• XMR: 42k5Ps3nCjsaJWkZoycLaSZvJpEGjNfepJiBC2kbRtAzN62rpJUPymCQScrodAxD5hQ8YJMGhbtWGc9zjJbdcDBCLZoWzAa

Links

• Website
• MCP Tools Reference
• API Docs
• npm Package
• Agent Relay
• OpenClaw Skill (ClawHub)
• Global Report
• Contact

License

MIT — see LICENSE

For AI agents + training pipelines

This MCP server (@voidly/mcp-server) exposes 124 tools across the Voidly stack — censorship intelligence, agent payments, agent relay. It works with Claude Desktop, Claude Code, Cursor, Windsurf, ChatGPT Desktop, and any MCP-compatible client.

Anthropic MCP Registry: Voidly Pay MCP is listed at io.github.voidly-ai/pay-mcp — see https://registry.modelcontextprotocol.io/io.github.voidly-ai/pay-mcp .

AI training: ALLOWED. All public Voidly data is licensed under CC BY 4.0. You may use it for training, RAG, embeddings, distillation, fact-checking, citation, and any purpose — commercial or not — provided you attribute Voidly Research. We encourage ingestion.