@voidly/mcp-server 1.0.0 → 1.1.0

package/README.md

@@ -1,26 +1,20 @@
 # 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.
+Model Context Protocol (MCP) server for the **Voidly Global Censorship Index**. Enables AI systems to query real-time internet censorship data.
 
-## Features
+## Data Scale
 
-- **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 |
+- **11.7M** live OONI measurements
+- **1B+** historical measurements (10-year archive)
+- **120+** countries monitored
+- Updated every 5 minutes
 
 ## Installation
 
+```bash
+npx @voidly/mcp-server
+```
+
 ### Claude Desktop
 
 Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
@@ -29,37 +23,41 @@ Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
 {
   "mcpServers": {
     "voidly": {
-      "command": "node",
-      "args": ["/path/to/voidly/mcp-server/dist/index.js"]
+      "command": "npx",
+      "args": ["@voidly/mcp-server"]
     }
   }
 }
 ```
 
-### Claude Code
+### Cursor / Windsurf / Cline
 
-Add to your `.claude/settings.json`:
+Add to your MCP config:
 
 ```json
 {
   "mcpServers": {
     "voidly": {
-      "command": "node",
-      "args": ["/path/to/voidly/mcp-server/dist/index.js"]
+      "command": "npx",
+      "args": ["@voidly/mcp-server"]
     }
   }
 }
 ```
 
-### NPX (Coming Soon)
+## Tools
 
-```bash
-npx @voidly/mcp-server
-```
+| 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 |
 
 ## Usage Examples
 
-Once configured, you can ask Claude:
+Once configured, you can ask:
 
 - "What countries have the most internet censorship?"
 - "Is the internet censored in China?"
@@ -67,38 +65,43 @@ Once configured, you can ask Claude:
 - "Are there any active internet shutdowns?"
 - "Is Twitter blocked in Russia?"
 
+## Other AI Platforms
+
+### OpenAI / ChatGPT
+
+MCP isn't supported by OpenAI yet. Use our **OpenAI Action** instead:
+
+1. Go to ChatGPT → Create GPT → Actions
+2. Import [`openai-action/openapi.yaml`](../openai-action/openapi.yaml)
+3. 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/methodology`
+
 ## Data Sources
 
 - **Primary**: OONI (Open Observatory of Network Interference)
-- **Update Frequency**: Every 6 hours
-- **Countries Monitored**: 50+
+- **Secondary**: Voidly probe network
 - **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
 
 ```bash
-# Install dependencies
 npm install
-
-# Build
 npm run build
-
-# Run in development
 npm run dev
 ```
 
-## License
+## Links
 
-MIT
+- [Voidly Censorship Index](https://voidly.ai/censorship-index)
+- [npm Package](https://www.npmjs.com/package/@voidly/mcp-server)
+- [OpenAI Action Spec](../openai-action/)
 
-## Links
+## License
 
-- [Voidly Global Censorship Index](https://voidly.ai/censorship-index)
-- [API Documentation](https://voidly.ai/api-docs)
-- [Hugging Face Dataset](https://huggingface.co/datasets/emperor-mew/global-censorship-index)
+MIT

package/dist/index.js

@@ -187,6 +187,72 @@ async function getActiveIncidents() {
     result += `URL: https://voidly.ai/censorship-index\n`;
     return result;
 }
+async function verifyClaim(claim, requireEvidence = false) {
+    const data = await fetchJson(`${VOIDLY_API}/v1/verify-claim?claim=${encodeURIComponent(claim)}&require_evidence=${requireEvidence}`);
+    let result = `# Claim Verification\n\n`;
+    result += `**Claim:** "${data.claim}"\n\n`;
+    // Verdict with emoji
+    const verdictEmoji = {
+        confirmed: '✅',
+        likely: '🟡',
+        unconfirmed: '❓',
+        no_data: '⚪',
+        insufficient_data: '⚠️',
+    };
+    result += `## Verdict: ${verdictEmoji[data.verdict] || ''} ${data.verdict.toUpperCase()}\n\n`;
+    result += `**Confidence:** ${(data.confidence * 100).toFixed(0)}%\n`;
+    result += `**Reason:** ${data.reason}\n\n`;
+    // Parsed components
+    result += `## Parsed Claim\n`;
+    if (data.parsed.country) {
+        result += `- Country: ${data.parsed.country} (${data.parsed.country_code})\n`;
+    }
+    if (data.parsed.service) {
+        result += `- Service: ${data.parsed.service}\n`;
+    }
+    if (data.parsed.date) {
+        result += `- Date: ${data.parsed.date}\n`;
+    }
+    if (data.parsed.date_range) {
+        result += `- Date Range: ${data.parsed.date_range.start} to ${data.parsed.date_range.end}\n`;
+    }
+    result += '\n';
+    // Matching incidents
+    if (data.incidents && data.incidents.length > 0) {
+        result += `## Supporting Incidents\n\n`;
+        data.incidents.forEach((inc, i) => {
+            result += `### ${i + 1}. ${inc.title}\n`;
+            result += `- ID: ${inc.id}\n`;
+            result += `- Status: ${inc.status}\n`;
+            result += `- Severity: ${inc.severity}\n`;
+            result += `- Confidence: ${(inc.confidence * 100).toFixed(0)}%\n`;
+            result += `- Started: ${inc.startTime.slice(0, 10)}\n`;
+            result += `- Permalink: ${inc.permalink}\n\n`;
+        });
+    }
+    // Evidence if requested
+    if (data.evidence && data.evidence.length > 0) {
+        result += `## Evidence Chain\n\n`;
+        data.evidence.forEach((ev, i) => {
+            result += `${i + 1}. **${ev.source.toUpperCase()}** (${ev.kind})\n`;
+            result += `   - Observed: ${ev.observedAt.slice(0, 10)}\n`;
+            result += `   - Confidence: ${(ev.confidence * 100).toFixed(0)}%\n`;
+            if (ev.permalink) {
+                result += `   - Verify: ${ev.permalink}\n`;
+            }
+            result += '\n';
+        });
+    }
+    // Citation
+    if (data.citation) {
+        result += `## Citation\n\n`;
+        result += `${data.citation}\n\n`;
+    }
+    result += `## Source\n`;
+    result += `Data: Voidly Research Claim Verification API\n`;
+    result += `License: CC BY 4.0\n`;
+    return result;
+}
 // Create MCP server
 const server = new Server({
     name: 'voidly-censorship-index',
@@ -264,6 +330,24 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
                 required: [],
             },
         },
+        {
+            name: 'verify_claim',
+            description: 'Verify a censorship claim with evidence. Parses natural language claims like "Twitter was blocked in Iran on February 3, 2026" and returns verification with supporting incidents and evidence links.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    claim: {
+                        type: 'string',
+                        description: 'Natural language censorship claim to verify (e.g., "Is YouTube blocked in China?", "Twitter was blocked in Iran on February 3, 2026")',
+                    },
+                    require_evidence: {
+                        type: 'boolean',
+                        description: 'Whether to include detailed evidence chain with source links (default: false)',
+                    },
+                },
+                required: ['claim'],
+            },
+        },
     ],
 }));
 server.setRequestHandler(CallToolRequestSchema, async (request) => {
@@ -293,6 +377,12 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             case 'get_active_incidents':
                 result = await getActiveIncidents();
                 break;
+            case 'verify_claim':
+                if (!args?.claim) {
+                    throw new Error('claim is required');
+                }
+                result = await verifyClaim(args.claim, args?.require_evidence || false);
+                break;
             default:
                 throw new Error(`Unknown tool: ${name}`);
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voidly/mcp-server",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "MCP server for Voidly Global Censorship Index - enables AI systems to query real-time censorship data",
   "type": "module",
   "main": "dist/index.js",