lynceus-mcp
Web search and URL→Markdown extraction for AI agents. RU-web-first, anti-bot hardened, clean reader-mode output.
lyn_search— live web search via the Yandex index, freshness filterlyn_extract— URLs → clean Markdown; gets through where plain fetch gets a 403lyn_usage— remaining credits
Install
npm i -g lynceus-mcp
Get an API key at lynceus.ru — free tier includes 300 credits.
Connect your agent
Claude Code (.mcp.json)
{
"mcpServers": {
"lynceus": {
"command": "npx",
"args": ["-y", "lynceus-mcp"],
"env": { "LYNCEUS_API_KEY": "sk_live_..." }
}
}
}
OpenAI Codex (~/.codex/config.toml)
[mcp_servers.lynceus]
command = "npx"
args = ["-y", "lynceus-mcp"]
env = { LYNCEUS_API_KEY = "sk_live_..." }
Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"lynceus": {
"command": "npx",
"args": ["-y", "lynceus-mcp"],
"env": { "LYNCEUS_API_KEY": "sk_live_..." }
}
}
}
Hermes Agent (~/.hermes/config.yaml)
mcp:
lynceus:
command: npx
args: ["-y", "lynceus-mcp"]
env:
LYNCEUS_API_KEY: sk_live_...
Windsurf (~/.codeium/windsurf/mcp_config.json)
{
"mcpServers": {
"lynceus": {
"command": "npx",
"args": ["-y", "lynceus-mcp"],
"env": { "LYNCEUS_API_KEY": "sk_live_..." }
}
}
}
VS Code (Copilot) (.vscode/mcp.json)
{
"servers": {
"lynceus": {
"type": "stdio",
"command": "npx",
"args": ["-y", "lynceus-mcp"],
"env": { "LYNCEUS_API_KEY": "sk_live_..." }
}
}
}
Streamable HTTP
LYNCEUS_API_KEY=sk_live_... lynceus-mcp --http # POST /mcp on :8082
Environment
| Variable | Default | Notes |
|---|---|---|
LYNCEUS_API_KEY |
— | Required |
LYNCEUS_API_URL |
https://api.lynceus.ru |
Override for self-hosted |
LYNCEUS_TIMEOUT_MS |
120000 |
Per-call timeout |
License
MIT © 2026 Lynceus