Voidly Ai MCP Server

@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.