Skip to content
MCP server

three.ws Knock

Reach a real person: quote their door, browse who is reachable, knock, and read the reply.

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.1.0
Listing updated
6 days ago

About three.ws Knock

three.ws Knock is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Install

Run in a terminal

claude mcp add knock-mcp --env THREE_WS_API_KEY='<THREE_WS_API_KEY>' -- npx -y @three-ws/knock-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "knock-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/knock-mcp"
      ],
      "env": {
        "THREE_WS_API_KEY": "<THREE_WS_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "knock-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/knock-mcp"
      ],
      "env": {
        "THREE_WS_API_KEY": "<THREE_WS_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "knock-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/knock-mcp"
      ],
      "env": {
        "THREE_WS_API_KEY": "<THREE_WS_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "knock-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/knock-mcp"
      ],
      "env": {
        "THREE_WS_API_KEY": "<THREE_WS_API_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "knock-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/knock-mcp"
      ],
      "env": {
        "THREE_WS_API_KEY": "<THREE_WS_API_KEY>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • THREE_WS_API_KEYA three.ws API key (sk_live_… / sk_test_…) or OAuth access token. Optional: needed only for knock_inbox and knock_act, which manage your own door. Quoting, browsing, knocking and reading a receipt all work without it. Treat like a password.
  • THREE_WS_BASEBase URL of the three.ws API. Override only when self-hosting or targeting a preview deployment.
  • THREE_WS_TIMEOUT_MSPer-request timeout in milliseconds.

Pricing

Open source

Prices change. Check three.ws before you buy.

three.ws Knock FAQ

Is three.ws Knock free?

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

How do I add three.ws Knock to Claude Code?

Run this command in your terminal: claude mcp add knock-mcp --env THREE_WS_API_KEY='<THREE_WS_API_KEY>' -- npx -y @three-ws/knock-mcp

Where this comes from

  • Description: from the official MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers