# Witnessory

> Witnessory is an open-source MCP server for security. Check a website's post-quantum readiness and read internet-wide adoption figures. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API, self-hosted
- **Website:** https://witnessory.org
- **Repository:** https://github.com/witnessory/client
- **MCP Registry name:** io.github.witnessory/witnessory
- **Categories:** security
- **Listing updated:** 2026-11-15

## About

The server is the client side of an observatory that probes the internet from several networks and signs every reading. Its homepage reports 58.9% of the top 10,000 sites negotiating post-quantum TLS and 51.3% of SSH servers offering post-quantum key exchange, as of 2026-11-14 from four probes.

An agent gets five tools: a single-site check, the headline figures by layer, the probe map, a service status call and a pricing call. Results are signed and can be verified in Python with an optional extra, so a figure can be recomputed rather than trusted.

Free checks use one vantage point and are limited to 20 new checks an hour per address, with results reused for 10 minutes. A paid key or per-request payment gives fresh checks.

## Features

- **Single-site check:** Reports how ready one domain is for post-quantum key exchange, in a sentence or as a full signed result.
- **Headline figures:** Returns adoption numbers by layer, such as TLS and SSH.
- **Probe map:** Lists where the probes measure from.
- **Signed readings:** Results carry signatures that can be verified with the optional verify extra.
- **Pay per request:** An x402 flow lets an agent pay $0.01 in USDC on Base for one fresh check, with no account.

## Good for

- Check whether a customer-facing domain negotiates post-quantum key exchange
- Quote current post-quantum adoption figures in a security report
- Let an agent audit a list of domains for crypto-migration planning
- Confirm that the measurement service is up before relying on it

## Install

### Claude Code (Terminal)

```sh
claude mcp add witnessory -- uvx witnessory
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "witnessory": {
      "command": "uvx",
      "args": [
        "witnessory"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "witnessory": {
      "command": "uvx",
      "args": [
        "witnessory"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "witnessory": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "witnessory"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "witnessory": {
      "command": "uvx",
      "args": [
        "witnessory"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "witnessory": {
      "command": "uvx",
      "args": [
        "witnessory"
      ]
    }
  }
}
```

## Tools

- `check_site`: Checks one site's post-quantum readiness.
- `pq_headline`: Returns headline adoption figures by layer.
- `probe_map`: Shows where the probes measure from.
- `service_status`: Reports whether every service is up.
- `pricing`: Lists what is paid and the prices.

## FAQ

### How many free checks are allowed?

Free checks come from one vantage point, 20 new checks an hour per address, with results reused for 10 minutes.

### How does an agent pay?

With the pay extra and a wallet holding USDC on Base, a single fresh check costs $0.01, and a $19 key covers 2,000 fresh checks over 31 days.

### How do I run the server?

Install the witnessory package from PyPI and start it with the command witnessory and the argument mcp.

### What licence is the client?

The README says it is Apache 2.0 and uses only the standard library.

### Is Witnessory free?

Yes. Witnessory is open source, so you can use and self-host it for free.

### How do I add Witnessory to Claude Code?

Run this command in your terminal: claude mcp add witnessory -- uvx witnessory

### What are the best alternatives to Witnessory?

The closest alternatives to Witnessory are REA, Agent Roast, Midplane, Leash and Tinplate Edge AI Safety, Security & EU Compliance.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Agent Roast](https://ai-powered.com/mcp/agent-roast): Agent Roast is an open-source MCP server for developer tools.
- [Midplane](https://ai-powered.com/mcp/midplane): Midplane is an open-source MCP server for databases.
- [Leash](https://ai-powered.com/mcp/leash): Leash is a free MCP server for security.
- [Tinplate Edge AI Safety, Security & EU Compliance](https://ai-powered.com/mcp/tinplate-edge-ai-safety-security-and-eu-compliance): Tinplate Edge AI Safety, Security & EU Compliance is a freemium MCP server for security.
- [SecureCloud](https://ai-powered.com/mcp/securecloud): SecureCloud is a free MCP server for security.
- [Eikino](https://ai-powered.com/mcp/eikino): Eikino is a freemium MCP server for security.
- [SynomosAI Governance MCP](https://ai-powered.com/mcp/synomosai-governance-mcp-2): SynomosAI Governance MCP is an open-source MCP server for security.

---
Source: https://ai-powered.com/mcp/witnessory
