Metadata-Version: 2.5
Name: nokk-mcp
Version: 0.1.46a1
Summary: MCP server for nokk, a Chrome-fingerprinted headless browser engine that passes Cloudflare: give an AI agent a browser with `uvx nokk-mcp`.
Project-URL: Homepage, https://github.com/koloss777/nokk
Project-URL: Repository, https://github.com/koloss777/nokk
Project-URL: Issues, https://github.com/koloss777/nokk/issues
Author: koloss777
License: MIT OR Apache-2.0
Keywords: ai-agent,cloudflare,headless-browser,mcp,model-context-protocol,web-scraping
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Internet :: WWW/HTTP :: Browsers
Requires-Python: >=3.10
Requires-Dist: mcp>=1.2
Requires-Dist: nokk>=0.1.46a1
Requires-Dist: websockets>=12
Description-Content-Type: text/markdown

# nokk-mcp

<!-- mcp-name: io.github.koloss777/nokk -->

An MCP server that gives an AI agent a headless browser: [nokk](https://github.com/koloss777/nokk),
a Rust engine with Chrome 151's TLS, HTTP/2 and JavaScript fingerprint that passes Cloudflare's
challenges without Chromium.

```bash
uvx nokk-mcp
```

Client configuration (Claude Desktop, Claude Code, Cursor and others):

```json
{
  "mcpServers": {
    "nokk": { "command": "uvx", "args": ["nokk-mcp"] }
  }
}
```

Tools: `open`, `read_text`, `read_html`, `click`, `fill`, `evaluate`, `links`, `solve_challenge`,
`challenge_state`, `reset`. `open` solves a Cloudflare challenge on the way and says what it met.

Options (flags or environment variables):

| Flag | Variable | What it does |
|---|---|---|
| `--proxy URL` | `NOKK_PROXY` | upstream proxy, e.g. `socks5://host:1080` |
| `--rotate-fingerprint` | `NOKK_ROTATE_FINGERPRINT=1` | each session gets its own coherent fingerprint |
| `--geoip-timezone` | `NOKK_GEOIP_TIMEZONE=1` | timezone and locale follow the proxy's exit IP |
| `--session-store DIR` | `NOKK_SESSION_STORE` | keep named sessions' cookies on disk |
| `--no-auto-solve` | `NOKK_NO_AUTO_SOLVE=1` | do not solve challenges during navigation |
| `--workers N` | `NOKK_WORKERS` | isolate worker threads |

The same server runs as `python -m nokk.mcp` after `pip install "nokk[mcp]"`.
Documentation, the CDP server and the Python and Node launchers: https://github.com/koloss777/nokk
