Verify npm packages before your AI agent installs them: hallucinations, advisories, API drift.
Call this server's tools from your browser. Nothing to install.
Bearer <your lurq API key>. Free keys at https://www.lurq.run/dashboard/keys
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Assess an entire project's dependencies in ONE call: which packages are outdated, deprecated or carry advisories for the exact installed version, and which configured MCP servers have drifted, need credentials, or cannot be observed at all. Send the inventory you read locally (names and versions only — never source). Returns a per-item verdict plus an explicit coverage count: how many were answered, how many are queued because the index has not seen them, and how many were skipped and why. An item lurq could not assess is reported as unassessed, never as clean.
npm dependencies read from package.json + lockfile
MCP servers read from .mcp.json / agent configs
Assess an entire project's dependencies in ONE call: which packages are outdated, deprecated or carry advisories for the exact installed version, and which configured MCP servers have drifted, need credentials, or cannot be observed at all. Send the inventory you read locally (names and versions only — never source). Returns a per-item verdict plus an explicit coverage count: how many were answered, how many are queued because the index has not seen them, and how many were skipped and why. An item lurq could not assess is reported as unassessed, never as clean.
| Argument | Type | Description |
|---|---|---|
| packages | array | npm dependencies read from package.json + lockfile |
| mcpServers | array | MCP servers read from .mcp.json / agent configs |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"packages": {
"type": "array",
"items": {
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"pattern": "^(?:@[a-z0-9-][a-z0-9-._]*\\/)?[a-z0-9-][a-z0-9-._]*$",
"maxLength": 214,
"minLength": 1
},
"range": {
"type": "string",
"description": "Declared range, e.g. ^6.4.0"
},
"installed": {
"type": [
"string",
"null"
],
"description": "Resolved version from the lockfile or node_modules — what actually runs"
}
},
"additionalProperties": false
},
"maxItems": 600,
"description": "npm dependencies read from package.json + lockfile"
},
"mcpServers": {
"type": "array",
"items": {
"type": "object",
"properties": {
"kind": {
"enum": [
"npm-stdio",
"remote",
"local",
"other-registry"
],
"type": "string",
"description": "How it launches; decides whether lurq can read its contract"
},
"alias": {
"type": "string",
"maxLength": 200
},
"version": {
"anyOf": [
{
"type": "string",
"maxLength": 100
},
{
"type": "null"
}
]
},
"endpoint": {
"anyOf": [
{
"type": "string",
"maxLength": 300
},
{
"type": "null"
}
]
},
"packageName": {
"anyOf": [
{
"type": "string",
"maxLength": 300
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"maxItems": 200,
"description": "MCP servers read from .mcp.json / agent configs"
}
},
"additionalProperties": false
}Look up which lurq tool answers a situation, and what to run next. Call when you're unsure whether lurq covers something (an upgrade, a licence rule, a version's exact exports, publishing a package) instead of guessing or skipping it. Returns matching capabilities with the tool or command to use.
| Argument | Type | Description |
|---|---|---|
| query | string | What you are trying to do, in plain words. Omit for the full menu. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"query": {
"type": "string",
"maxLength": 300,
"description": "What you are trying to do, in plain words. Omit for the full menu."
}
},
"additionalProperties": false
}Side-by-side comparison of 2–5 npm packages you are choosing between, ranked by health score. Untracked names are fetched on demand; one still being scored comes back under `pending` (retry shortly), and a name not on npm under `notFound`.
| Argument | Type | Description |
|---|---|---|
| packages* | array | 2–5 npm package names |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"packages"
],
"properties": {
"packages": {
"type": "array",
"items": {
"type": "string",
"pattern": "^(?:@[a-z0-9-][a-z0-9-._]*\\/)?[a-z0-9-][a-z0-9-._]*$",
"maxLength": 214,
"minLength": 1
},
"maxItems": 5,
"minItems": 2,
"description": "2–5 npm package names"
}
},
"additionalProperties": false
}Check whether a set of packages forms a coherent stack. Resolves the whole set the way npm would and returns a definitive verdict: compatible, conflict (with the exact clashing constraints), or unknown. Checks peer-dependency and engine ranges from declared metadata, plus any recorded sandbox conflicts. Read-only: never installs or executes package code. Not always instant: a set checked before answers immediately, but a new set is resolved live from registry metadata, which can take up to ~25 seconds. Call once with the whole stack before committing to it.
| Argument | Type | Description |
|---|---|---|
| node | string | Optional target Node runtime (e.g. "20" or "20.20.2") for engines.node checks |
| packages* | array | The full candidate stack to check together, 2–30 npm package names — a whole package.json dependency list is the intended input. Pass every package in one call: conflicts routinely appear only across the whole set (a peer range three packages deep), so checking pairs separately misses them and costs a round trip each. |
| versions | object | Optional exact versions keyed by package name, e.g. {"react":"19.0.0"} (use when not checking latest). Must be exact semver versions, not ranges. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"packages"
],
"properties": {
"node": {
"type": "string",
"description": "Optional target Node runtime (e.g. \"20\" or \"20.20.2\") for engines.node checks"
},
"packages": {
"type": "array",
"items": {
"type": "string",
"pattern": "^(?:@[a-z0-9-][a-z0-9-._]*\\/)?[a-z0-9-][a-z0-9-._]*$",
"maxLength": 214,
"minLength": 1
},
"maxItems": 30,
"minItems": 2,
"description": "The full candidate stack to check together, 2–30 npm package names — a whole package.json dependency list is the intended input. Pass every package in one call: conflicts routinely appear only across the whole set (a peer range three packages deep), so checking pairs separately misses them and costs a round trip each."
},
"versions": {
"type": "object",
"description": "Optional exact versions keyed by package name, e.g. {\"react\":\"19.0.0\"} (use when not checking latest). Must be exact semver versions, not ranges.",
"additionalProperties": {
"type": "string",
"maxLength": 256
}
}
},
"additionalProperties": false
}Before wiring an MCP server into a client, find out whether it will work there and exactly what it takes. Accepts an endpoint URL, an official-registry server name, or an npm package name. Answers per client (Claude Code, Claude.ai, ChatGPT, Cursor, VS Code, Codex, Gemini CLI and more): WORKS; NEEDS_SETUP with the steps (a key to send as a header, an OAuth client to pre-register and the redirect URIs to allow, a URL placeholder to fill); BLOCKED with the reason and which side causes it; or UNKNOWN when a decisive fact is not established. Built from a credential-free probe of the endpoint (whether it answers, how it authenticates, which OAuth registration methods it offers, spec deviations strict clients refuse, tool names and schemas) and from primary-sourced client constraints. Returns ready-to-paste config in each client's own format, with placeholder values. Tell the user what it found, including which client it was checked for. UNKNOWN never means it will not work.
| Argument | Type | Description |
|---|---|---|
| client | string | One client to check, e.g. claude-code, cursor, chatgpt; omit for every client |
| server* | string | Endpoint URL (https://…), official registry name (io.github.acme/weather), or npm package name |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"server"
],
"properties": {
"client": {
"enum": [
"claude-code",
"claude-desktop",
"claude-ai",
"claude-api",
"chatgpt",
"openai-responses",
"codex",
"gemini-cli",
"cursor",
"vscode",
"windsurf",
"zed",
"jetbrains-ai",
"junie",
"cline",
"continue",
"goose",
"lovable",
"replit",
"bolt",
"v0"
],
"type": "string",
"description": "One client to check, e.g. claude-code, cursor, chatgpt; omit for every client"
},
"server": {
"type": "string",
"maxLength": 2048,
"minLength": 1,
"description": "Endpoint URL (https://…), official registry name (io.github.acme/weather), or npm package name"
}
},
"additionalProperties": false
}Emit a reference-architecture Mermaid diagram for a stack you have already chosen (package names). A labeled starting point keyed by layer, not a validated architecture, and not an architecture designer.
| Argument | Type | Description |
|---|---|---|
| stack | array | Package names that make up the stack; omit or empty to get usage guidance |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"stack": {
"type": "array",
"items": {
"type": "string",
"pattern": "^(?:@[a-z0-9-][a-z0-9-._]*\\/)?[a-z0-9-][a-z0-9-._]*$",
"maxLength": 214,
"minLength": 1
},
"description": "Package names that make up the stack; omit or empty to get usage guidance"
}
},
"additionalProperties": false
}What changed in a package's runtime surface between two versions: symbols removed, added, and arity changes, plus renames the package itself proves (a removed name that shared one declaration with a name the new version still exports). Removals break `node`; type-only removals are returned separately because they break `tsc` instead. Answers "when did this stop working" from static comparison, with no install required. Use before an upgrade, and to explain a break after one.
| Argument | Type | Description |
|---|---|---|
| package* | string | npm package name |
| toVersion* | string | Version you are moving to |
| fromVersion* | string | Version you are on |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"package",
"fromVersion",
"toVersion"
],
"properties": {
"package": {
"type": "string",
"pattern": "^(?:@[a-z0-9-][a-z0-9-._]*\\/)?[a-z0-9-][a-z0-9-._]*$",
"maxLength": 214,
"minLength": 1,
"description": "npm package name"
},
"toVersion": {
"type": "string",
"description": "Version you are moving to"
},
"fromVersion": {
"type": "string",
"description": "Version you are on"
}
},
"additionalProperties": false
}Full evidence read for one npm package: health and quality scores and the signals behind them, advisories, the shared safety verdict, a summary and a usage guide. Use it when a choice needs more than verify's install gate. Enforces the account's dependency policy. A package lurq has never tracked is fetched and scored on demand, waiting up to ~4 seconds; if scoring takes longer the result is `tracked: false` with a note to retry in a few seconds, which is not an answer about the package.
| Argument | Type | Description |
|---|---|---|
| package* | string | npm package name |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"package"
],
"properties": {
"package": {
"type": "string",
"pattern": "^(?:@[a-z0-9-][a-z0-9-._]*\\/)?[a-z0-9-][a-z0-9-._]*$",
"maxLength": 214,
"minLength": 1,
"description": "npm package name"
}
},
"additionalProperties": false
}What moved in an MCP server's tool contract between two versions: tools removed, parameters that became required, types narrowed, and annotation flips. Two findings here have no npm equivalent and are why this exists. SILENT DRIFT is a schema that changed while its description stayed byte-identical, invisible to anyone reading a changelog. PRIVILEGE WIDENING is a tool that stopped being read-only or started being destructive, which does not break anything and is worse than a break. Use before upgrading a server an agent depends on.
| Argument | Type | Description |
|---|---|---|
| server* | string | npm package name of the MCP server |
| toVersion* | string | Version you are moving to |
| fromVersion* | string | Version you are on |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"server",
"fromVersion",
"toVersion"
],
"properties": {
"server": {
"type": "string",
"pattern": "^(?:@[a-z0-9-][a-z0-9-._]*\\/)?[a-z0-9-][a-z0-9-._]*$",
"maxLength": 214,
"minLength": 1,
"description": "npm package name of the MCP server"
},
"toVersion": {
"type": "string",
"description": "Version you are moving to"
},
"fromVersion": {
"type": "string",
"description": "Version you are on"
}
},
"additionalProperties": false
}Check whether a set of MCP servers can be wired into one agent together. The npm question does not apply — servers are separate processes with nothing to resolve between them. They clash in the single flat TOOL NAMESPACE the agent assembles from all of them: two servers exposing the same tool name leave the agent unable to express which it means, and nothing errors, one simply shadows the other. Also reports the standing context cost, since every tool's schema rides in every request. Pass `tools` for a server when you already hold its tool list (any server: remote, PyPI, Docker, private) and it is analysed as-is; otherwise the npm server's probed surface is used, and one that has not been probed makes the answer UNKNOWN, never clean.
| Argument | Type | Description |
|---|---|---|
| servers* | array | The servers configured into one agent |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"servers"
],
"properties": {
"servers": {
"type": "array",
"items": {
"type": "object",
"required": [
"server"
],
"properties": {
"tools": {
"type": "array",
"items": {
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"maxLength": 256,
"minLength": 1
},
"annotations": {
"type": "object",
"additionalProperties": {}
}
},
"additionalProperties": false
},
"maxItems": 2000,
"description": "The tool list as the agent received it; names and annotations are enough"
},
"server": {
"type": "string",
"maxLength": 300,
"minLength": 1,
"description": "npm package name of the MCP server, or any label when `tools` is given"
},
"version": {
"anyOf": [
{
"type": "string",
"maxLength": 100
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"maxItems": 50,
"minItems": 1,
"description": "The servers configured into one agent"
}
},
"additionalProperties": false
}What an MCP server ACTUALLY exposes: every tool, its required and optional parameters, and its behaviour annotations, read from a live `tools/list` handshake in a sandbox rather than from a README or the model's memory. Call before wiring an agent to a server, or when a tool call is failing for reasons the error does not explain. Also returns `requires` — the API keys and settings the server declares it needs — and `configRequest`, a ready-made line to put in front of your user when something is missing, so 'it needs a token' never presents as 'it is broken'. A miss returns UNKNOWN and queues a probe; UNKNOWN never means the server has no tools.
| Argument | Type | Description |
|---|---|---|
| server* | string | npm package name of the MCP server |
| version | string | Exact version; omit for the latest probed |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"server"
],
"properties": {
"server": {
"type": "string",
"pattern": "^(?:@[a-z0-9-][a-z0-9-._]*\\/)?[a-z0-9-][a-z0-9-._]*$",
"maxLength": 214,
"minLength": 1,
"description": "npm package name of the MCP server"
},
"version": {
"type": "string",
"description": "Exact version; omit for the latest probed"
}
},
"additionalProperties": false
}The rules this account's selection policy enforces on which packages you may add: denied packages (with the reason), license allowlist, confidence, advisory, adoption, staleness and bundle-size floors. Read it once before choosing dependencies so you pick an allowed package first; evaluate already enforces it. Read-only.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}Opt-in feedback after you act on lurq's evidence about a package (verify, evaluate, compare, compat): whether you went with it and whether it built. No source code, only the coarse decision + a build signal. Helps lurq learn which packages agents actually succeed with; safe to skip.
| Argument | Type | Description |
|---|---|---|
| need | string | What you needed the package for, in plain words (no source code) |
| package* | string | The package you decided on |
| accepted* | boolean | Did you go with this package? |
| buildSignal | string | Coarse post-install result, if known |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"package",
"accepted"
],
"properties": {
"need": {
"type": "string",
"maxLength": 500,
"description": "What you needed the package for, in plain words (no source code)"
},
"package": {
"type": "string",
"pattern": "^(?:@[a-z0-9-][a-z0-9-._]*\\/)?[a-z0-9-][a-z0-9-._]*$",
"maxLength": 214,
"minLength": 1,
"description": "The package you decided on"
},
"accepted": {
"type": "boolean",
"description": "Did you go with this package?"
},
"buildSignal": {
"enum": [
"installed",
"compiled",
"tests_passed",
"failed"
],
"type": "string",
"description": "Coarse post-install result, if known"
}
},
"additionalProperties": false
}What a package version ACTUALLY exports at runtime, extracted from its shipped JavaScript rather than from documentation or the model's memory: names and arity, not type signatures (use usage for those). Call before writing code against a package whose API may have moved. Runtime existence is what decides whether an import throws; a removed type breaks tsc, a removed runtime symbol breaks the program. A miss returns UNKNOWN and queues extraction, UNKNOWN never means the symbol is absent.
| Argument | Type | Description |
|---|---|---|
| package* | string | npm package name |
| version | string | Exact version; omit for the latest extracted |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"package"
],
"properties": {
"package": {
"type": "string",
"pattern": "^(?:@[a-z0-9-][a-z0-9-._]*\\/)?[a-z0-9-][a-z0-9-._]*$",
"maxLength": 214,
"minLength": 1,
"description": "npm package name"
},
"version": {
"type": "string",
"description": "Exact version; omit for the latest extracted"
}
},
"additionalProperties": false
}A package version's TYPED API: exported symbols and their signatures from its shipped .d.ts (or DefinitelyTyped), exact to the version, none of it in the model's training data. Use before writing code against a package whose API may have moved. For whether a name exists at RUNTIME (what decides if an import throws) use resolve_surface; for is-it-safe-to-install use verify. Pass knownVersion (e.g. the version you were trained on) to get the precise delta: added, removed, renamed, changed. Also returns the version's declared engines (Node/runtime floor). Large surfaces are paged, 80 symbols per call: `totalSymbols` is the size, `query` filters by name, `offset` pages. `shallow: true` means the API lives on an interface's members that are not listed, and the note says where to read them. For framework file/convention changes (not exported symbols), consult the official migration guide / Context7 instead.
| Argument | Type | Description |
|---|---|---|
| query | string | Part of a symbol name (case-insensitive); returns only matching symbols |
| offset | integer | Index of the first symbol to return, to page past the first 80 |
| package* | string | npm package name |
| version | string | Target version (defaults to latest) |
| knownVersion | string | A version you already know; returns the API delta from it to the target |
Confirm an npm package is real, healthy, and not risky before installing: guards against hallucinated or typosquatted names, deprecations and known advisories, and returns a safety verdict with its reasons and what was not checked. Checks the live registry. The cheap gate to call before every install; use evaluate when you need the full scores.
| Argument | Type | Description |
|---|---|---|
| package* | string | npm package name to verify |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"package"
],
"properties": {
"package": {
"type": "string",
"pattern": "^(?:@[a-z0-9-][a-z0-9-._]*\\/)?[a-z0-9-][a-z0-9-._]*$",
"maxLength": 214,
"minLength": 1,
"description": "npm package name to verify"
}
},
"additionalProperties": false
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"package"
],
"properties": {
"query": {
"type": "string",
"maxLength": 100,
"description": "Part of a symbol name (case-insensitive); returns only matching symbols"
},
"offset": {
"type": "integer",
"minimum": 0,
"description": "Index of the first symbol to return, to page past the first 80"
},
"package": {
"type": "string",
"pattern": "^(?:@[a-z0-9-][a-z0-9-._]*\\/)?[a-z0-9-][a-z0-9-._]*$",
"maxLength": 214,
"minLength": 1,
"description": "npm package name"
},
"version": {
"type": "string",
"description": "Target version (defaults to latest)"
},
"knownVersion": {
"type": "string",
"description": "A version you already know; returns the API delta from it to the target"
}
},
"additionalProperties": false
}