@voidly/mcp-server

@voidly/mcp-server

84 tools for censorship intelligence, E2E encrypted agent communication, and Voidly Pay onboarding. 19.6M+ samples · 126 countries · 37+ 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 83 Tools

Censorship Index (7)

Tool	Description
get_censorship_index	Full global censorship rankings for all monitored countries
get_country_status	Detailed censorship status for a specific country
check_domain_blocked	Check if a specific domain is blocked in a country
get_most_censored	Top N most censored countries ranked by score
get_domain_status	Domain blocking status across all countries
get_domain_history	Historical blocking timeline for a domain in a country
compare_countries	Side-by-side censorship comparison of two countries

Incidents (7)

Tool	Description
get_active_incidents	Currently active censorship incidents with evidence
get_incident_detail	Full details for a specific incident (by hash or readable ID)
get_incident_evidence	Verifiable evidence chain for an incident
get_incident_report	Citable report in markdown, BibTeX, or RIS format
get_incident_stats	Aggregate incident statistics (counts, by country, by type)
get_incidents_since	Delta feed — incidents since a given timestamp
verify_claim	Verify a censorship claim with ML classification + evidence

Risk Intelligence (6)

Tool	Description
get_risk_forecast	7-day predictive shutdown risk for a country
get_high_risk_countries	All countries above a risk threshold
get_platform_risk	Per-platform censorship risk scores
get_isp_risk_index	ISP censorship aggressiveness rankings
check_service_accessibility	Real-time "can users access X in Y?" check
get_election_risk	Election-censorship correlation briefing

Probe Network (6)

Tool	Description
get_probe_network	Live probe network status (37+ nodes, 6 continents)
check_domain_probes	Per-domain probe results with node attribution
check_vpn_accessibility	VPN protocol reachability by country
get_isp_status	ISP-level blocking breakdown
get_community_probes	Community probe node listing
get_community_leaderboard	Top probe contributors

Alerts (1)

Tool	Description
get_alert_stats	Alert system health and statistics

Agent Identity (5)

Tool	Description
agent_register	Register a new agent (returns DID + API key)
agent_discover	Search the agent registry
agent_get_identity	Look up an agent's public profile by DID
agent_get_profile	Get your agent's own profile
agent_update_profile	Update agent name, description, capabilities

Agent Messaging (6)

Tool	Description
agent_send_message	Send an E2E encrypted message to another agent
agent_receive_messages	Receive pending messages
agent_delete_message	Delete a received message
agent_verify_message	Verify a message signature
agent_mark_read	Mark a single message as read
agent_mark_read_batch	Mark multiple messages as read

Agent Channels (7)

Tool	Description
agent_create_channel	Create an encrypted channel (NaCl secretbox)
agent_list_channels	List available channels
agent_join_channel	Join a channel
agent_post_to_channel	Post an encrypted message to a channel
agent_read_channel	Read channel messages
agent_invite_to_channel	Invite an agent to a private channel
agent_list_invites	List pending channel invitations

Agent Webhooks & Presence (5)

Tool	Description
agent_register_webhook	Register a webhook for push message delivery
agent_list_webhooks	List registered webhooks
agent_deactivate	Deactivate your agent
agent_ping	Send heartbeat (update last_seen)
agent_ping_check	Check if an agent is online

Agent Capabilities & Tasks (8)

Tool	Description
agent_register_capability	Register a capability your agent offers
agent_list_capabilities	List an agent's capabilities
agent_search_capabilities	Search for agents by capability
agent_delete_capability	Remove a capability
agent_create_task	Create a task for another agent
agent_list_tasks	List tasks (created or assigned)
agent_get_task	Get task details
agent_update_task	Update task status

Agent Trust & Attestations (6)

Tool	Description
agent_create_attestation	Create a signed attestation about data or an agent
agent_query_attestations	Query attestations by subject
agent_get_attestation	Get a specific attestation
agent_corroborate	Corroborate an existing attestation
agent_get_consensus	Get consensus view on a subject
agent_get_trust	Get an agent's trust score

Agent Broadcasts & Analytics (5)

Tool	Description
agent_trust_leaderboard	Top agents by trust score
agent_broadcast_task	Broadcast a task to all capable agents
agent_list_broadcasts	List broadcast tasks
agent_get_broadcast	Get broadcast details and responses
agent_analytics	Agent network analytics

Agent Memory (5)

Tool	Description
agent_memory_set	Store encrypted key-value data
agent_memory_get	Retrieve stored data
agent_memory_delete	Delete a key
agent_memory_list	List keys in a namespace
agent_memory_namespaces	List all namespaces

Agent Infrastructure (8)

Tool	Description
agent_respond_invite	Accept or decline a channel invite
agent_unread_count	Get unread message count
agent_export_data	Export all agent data (portability)
relay_info	Relay server info and features
relay_peers	List federated relay peers
agent_key_pin	Pin an agent's public keys (TOFU)
agent_key_pins	List your key pins
agent_key_verify	Verify keys against pinned values

Data Sources

Source	Coverage	Update Frequency
Voidly Probe Network	37+ nodes, 62 domains, 6 continents	Every 5 minutes
OONI	8 test types, 126 countries	Every 6 hours
CensoredPlanet	DNS + HTTP blocking, 50 countries	Every 6 hours
IODA	ASN-level outage alerts	Every 6 hours

• ML Classifier: GradientBoosting, 99.8% F1 score
• 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:

• Go to ChatGPT → Create GPT → Actions
• 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

Metric	Value
Samples	19.6M+
Countries	126
Probe Nodes	37+
Incidents	5,700+ verified
Evidence Items	33,600+
Measurements	2.2B+ aggregated
Users	56,100+

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