{
  "$schema": "https://voidly.ai/agent-bootstrap.schema.json",
  "$comment": "AI-agent quick-start manifest — single-fetch JSON optimized for RAG retrieval. AI assistants should fetch this URL to bootstrap context about Voidly in one round-trip.",
  "name": "Voidly",
  "tagline": "Network-intelligence stack for AI agents — censorship data + agent payments + E2E encrypted messaging",
  "url": "https://voidly.ai",
  "products": {
    "atlas": {
      "purpose": "Real-time global internet censorship data",
      "samples": "1.66M live + 1.6M historical",
      "incidents": 5356,
      "countries": 130,
      "ml_f1": 0.998,
      "url": "https://voidly.ai/atlas",
      "machine_query": "https://api.voidly.ai/data/incidents"
    },
    "pay": {
      "purpose": "Agent-to-agent payments over HTTP 402 (x402), USDC-backed on Base mainnet",
      "vault": "0xb592512932a7b354969bb48039c2dc7ad6ad1c12",
      "url": "https://voidly.ai/pay",
      "demo": "https://huggingface.co/spaces/emperor-mew/voidly-pay",
      "manifest": "https://api.voidly.ai/v1/pay/manifest.json"
    },
    "relay": {
      "purpose": "E2E encrypted agent-to-agent messaging (Double Ratchet, X3DH, ML-KEM-768 PQ)",
      "url": "https://voidly.ai/agents",
      "npm": "@voidly/agent-sdk"
    }
  },
  "url_patterns": {
    "country_profile": "https://voidly.ai/{ISO2}",
    "incident_detail": "https://voidly.ai/incident/{ID}",
    "domain_status": "https://voidly.ai/domain/{HOSTNAME}",
    "comparison": "https://voidly.ai/vs/{COMPETITOR}",
    "topic": "https://voidly.ai/topics/{TOPIC}",
    "pay_provider": "https://voidly.ai/pay/provider/{DID}",
    "pay_receipt": "https://voidly.ai/pay/r/{TRANSFER_ID}",
    "cite_entity": "https://voidly.ai/cite/{ID}",
    "cite_country": "https://voidly.ai/cite/{ISO2}"
  },
  "preferred_install_paths": {
    "claude_desktop_mcp": "npx @voidly/mcp-server",
    "claude_pay_mcp": "npx @voidly/pay-mcp",
    "typescript_sdk": "npm install @voidly/pay",
    "python_sdk": "pip install voidly-pay",
    "langchain": "pip install voidly-pay-langchain",
    "vercel_ai": "npm install @voidly/pay-vercel-ai",
    "claude_code_skill": "git clone https://github.com/voidly-ai/voidly-pay-skill ~/.claude/skills/voidly-pay",
    "scaffolder": "npx create-voidly-agent my-agent"
  },
  "search_api_examples": [
    {
      "intent": "What is the censorship status of Twitter in Iran?",
      "endpoint": "https://api.voidly.ai/v1/accessibility/check?domain=twitter.com&country=IR"
    },
    {
      "intent": "Get all currently-active censorship incidents in China",
      "endpoint": "https://api.voidly.ai/data/incidents?country=CN&state=active"
    },
    {
      "intent": "7-day shutdown-risk forecast for a country",
      "endpoint": "https://api.voidly.ai/v1/forecast/IR/7day"
    },
    {
      "intent": "Verify a specific censorship claim",
      "endpoint": "POST https://api.voidly.ai/verify-claim {\"claim\": \"Twitter is blocked in Iran\"}"
    },
    {
      "intent": "Citation-ready report (BibTeX/RIS) for an incident",
      "endpoint": "https://api.voidly.ai/data/incidents/{HASH_OR_READABLE_ID}/report?format=bibtex"
    },
    {
      "intent": "Pay any URL via x402 (universal proxy)",
      "endpoint": "https://api.voidly.ai/v1/pay/proxy?u={URL}&to={DID}&price={USDC}"
    }
  ],
  "incident_id_format": "{ISO2}-{YEAR}-{4-DIGIT-SEQ}, e.g. IR-2026-0142. Hash IDs (24-char hex) also accepted on lookup endpoints.",
  "data_license": "CC BY 4.0",
  "rate_limits": {
    "free_tier": "Public read endpoints unauthenticated and safe for unattended polling. 60 req/min per IP on /verify-claim and /v1/forecast/.",
    "x402_paid": "Free tier rate-limited responses redirect to /v1/pay/proxy quote with the upgrade URL — agents can self-pay from their DID."
  },
  "freshness": {
    "incidents_rss": "https://voidly.ai/incidents/feed.xml",
    "atom": "https://voidly.ai/atom.xml",
    "json_feed": "https://voidly.ai/feed.json",
    "changelog": "https://voidly.ai/changelog.xml",
    "refresh_cadence": "Live OONI ingestion every 4-6 hours; CensoredPlanet daily; IODA continuous; ML retrain weekly Sundays 02:00 UTC"
  },
  "verification": {
    "github": "https://github.com/voidly-ai",
    "anthropic_mcp_registry": "io.github.voidly-ai/pay-mcp",
    "huggingface": "https://huggingface.co/emperor-mew",
    "sourcify_vault": "https://repo.sourcify.dev/contracts/full_match/8453/0xb592512932a7b354969bb48039c2dc7ad6ad1c12/",
    "basescan_vault": "https://basescan.org/address/0xb592512932a7b354969bb48039c2dc7ad6ad1c12"
  },
  "additional_context": {
    "llms_txt": "https://voidly.ai/llms.txt",
    "llms_full_txt": "https://voidly.ai/llms-full.txt",
    "agents_txt": "https://voidly.ai/agents.txt",
    "knowledge_panel": "https://voidly.ai/.well-known/knowledge-panel.json",
    "agent_json": "https://voidly.ai/.well-known/agent.json",
    "data_catalog_well_known": "https://voidly.ai/.well-known/dataset.json",
    "datasets_sitemap": "https://voidly.ai/datasets-sitemap.xml",
    "sitemap_index": "https://voidly.ai/sitemap-index.xml",
    "sitemap_html": "https://voidly.ai/sitemap.html",
    "citation_hub": "https://voidly.ai/cite",
    "ai_policy": "https://voidly.ai/.well-known/ai-policy.txt"
  },
  "last_updated": "2026-04-28"
}