ScriptDocs MCP

Fetch real, current metadata for a package directly from the npm registry, PyPI JSON API, or crates.io. This tool makes a live HTTP request to the actual registry (registry.npmjs.org, pypi.org, or crates.io) at call time. It never returns cached, guessed, or simulated data — if the package doesn't exist, it returns an explicit error rather than a plausible-looking fabrication. Args: - ecosystem ('npm' | 'pypi' | 'cargo'): which registry to query - package_name (string): exact package name, e.g. "zod", "fastapi", or "serde" Returns JSON with: name, latest_version, description, homepage, repository, source_url (the exact registry URL the data came from, for verification), fetched_at (ISO timestamp). Error Handling: - Returns "Error: package not found" if the registry has no such package - Returns "Error: registry request failed" on network/HTTP errors

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "ecosystem",
    "package_name"
  ],
  "properties": {
    "ecosystem": {
      "enum": [
        "npm",
        "pypi",
        "cargo"
      ],
      "type": "string",
      "description": "Which package registry to query: 'npm', 'pypi', or 'cargo' (Rust/crates.io)."
    },
    "package_name": {
      "type": "string",
      "maxLength": 214,
      "minLength": 1,
      "description": "Exact package name as published on the registry, e.g. 'express', 'requests', or 'serde'."
    }
  },
  "additionalProperties": false
}

{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

Fetch the real README/description for a package, straight from the registry — not a summary, not a paraphrase, not AI-generated. For npm this reads the registry's stored README, falling back to the published README.md file via jsDelivr if the registry copy is missing (verbatim markdown). For PyPI this reads the exact long_description shown on the package's PyPI page (verbatim). For Cargo (Rust/crates.io) this reads crates.io's stored README — note: crates.io only stores a pre-rendered HTML version, not the original markdown source, so this is that HTML converted to plain text, not byte-for-byte source. Args: - ecosystem ('npm' | 'pypi' | 'cargo') - package_name (string): exact package name - version (string, optional): specific version; defaults to latest Returns JSON with: readme (truncated to 12000 chars if longer — check 'truncated'), truncated (boolean), source_url (exact URL fetched, for verification), fetched_at. Error Handling: - Returns "Error: ..." if the package or its README cannot be found — never fabricates content to fill the gap. [PAID: $0.009 USDC per call via x402 on Base - send a PAYMENT-SIGNATURE header on the /mcp request; unpaid calls return an HTTP 402 x402 challenge (amount 9000 atomic USDC). The other ScriptDocs tools are free.]

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "ecosystem",
    "package_name"
  ],
  "properties": {
    "version": {
      "type": "string",
      "description": "Specific version to fetch. Defaults to the latest published version if omitted."
    },
    "ecosystem": {
      "enum": [
        "npm",
        "pypi",
        "cargo"
      ],
      "type": "string",
      "description": "Which package registry to query: 'npm', 'pypi', or 'cargo'."
    },
    "package_name": {
      "type": "string",
      "maxLength": 214,
      "minLength": 1,
      "description": "Exact package name as published on the registry."
    }
  },
  "additionalProperties": false
}

{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

Search for keywords inside a package's real README/docs and return verbatim matching snippets with surrounding context. This does keyword matching over the actual fetched document (registry README for npm, long description for PyPI, README-derived text for Cargo) — it does not summarize or paraphrase, and it does not answer from general knowledge. If no matches are found, it says so rather than guessing at an answer. Args: - ecosystem ('npm' | 'pypi' | 'cargo') - package_name (string): exact package name - query (string): keyword(s) to search for, e.g. "rate limit" or "async client" - max_snippets (number, 1-20, default 5): cap on returned matches - version (string, optional): specific version to search; defaults to latest Returns JSON with: snippets (array of {match, context, line_hint}), source_url, fetched_at. Error Handling: - Returns "Error: ..." if the package/docs can't be fetched - Returns an empty snippets array (not an error) if the docs were fetched successfully but the query has no matches

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "ecosystem",
    "package_name",
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Keyword(s) to search for inside the package's real documentation, e.g. 'authentication middleware'."
    },
    "version": {
      "type": "string",
      "description": "Specific version to search within. Defaults to the latest published version if omitted."
    },
    "ecosystem": {
      "enum": [
        "npm",
        "pypi",
        "cargo"
      ],
      "type": "string",
      "description": "Which package registry to query: 'npm', 'pypi', or 'cargo'."
    },
    "max_snippets": {
      "type": "integer",
      "default": 5,
      "maximum": 20,
      "minimum": 1,
      "description": "Maximum number of matching snippets to return."
    },
    "package_name": {
      "type": "string",
      "maxLength": 214,
      "minLength": 1,
      "description": "Exact package name as published on the registry."
    }
  },
  "additionalProperties": false
}

{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

Check a real, specific package version against OSV.dev (Google-run, aggregates GitHub/PyPA/npm/RustSec advisories) — and, when a fix exists, automatically fetch that fixed version's README in the same call, so the result is "here's what's wrong" AND "here's exactly what upgrading looks like," not just a CVE list you have to research further yourself. This is a live query against OSV.dev's public API for the exact package+version given. It never estimates or guesses risk — if OSV has no advisories on record for that version, this correctly reports zero vulnerabilities rather than implying danger that isn't documented. Note: this tool is more limited than dedicated vulnerability-intelligence tools (e.g. VulnCheck, Snyk) — it reports what OSV.dev has on file, not exploit activity or threat intelligence. Args: - ecosystem ('npm' | 'pypi' | 'cargo') - package_name (string): exact package name - version (string, optional): specific version to check; defaults to the latest published version - include_fix_docs (boolean, default true): also fetch the README for the version that fixes the found vulnerabilities Returns JSON with: vulnerability_count, vulnerabilities (array of {id, summary, severity, aliases, fixed_in, references}), recommended_fix (null, or {version, readme, truncated, source_url} for the version that resolves the found issues), source_url, fetched_at. Error Handling: - Returns "Error: ..." if the package doesn't exist or OSV.dev can't be reached - vulnerability_count: 0 with an empty array is a normal, valid result — not an error - If fetching the fix's README fails, recommended_fix is null rather than the whole call failing — the vulnerability data itself is never withheld because of it [PAID: $0.009 USDC per call via x402 on Base - send a PAYMENT-SIGNATURE header on the /mcp request; unpaid calls return an HTTP 402 x402 challenge (amount 9000 atomic USDC). The other ScriptDocs tools are free.]

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "ecosystem",
    "package_name"
  ],
  "properties": {
    "version": {
      "type": "string",
      "description": "Specific version to check. Defaults to the current latest published version if omitted."
    },
    "ecosystem": {
      "enum": [
        "npm",
        "pypi",
        "cargo"
      ],
      "type": "string",
      "description": "Which package registry the version belongs to: 'npm', 'pypi', or 'cargo'."
    },
    "package_name": {
      "type": "string",
      "maxLength": 214,
      "minLength": 1,
      "description": "Exact package name as published on the registry."
    },
    "include_fix_docs": {
      "type": "boolean",
      "default": true,
      "description": "When a vulnerability is found with a known fixed version, also fetch that version's README so the response includes what upgrading actually looks like. Set false to skip the extra fetch."
    }
  },
  "additionalProperties": false
}

{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

Turn a fuzzy or partial name into real, ranked candidate package names, using the registry's own live search index — not a guess at what the package is probably called. For npm this queries registry.npmjs.org's actual search API (the same one npmjs.com uses). For Cargo this queries crates.io's real search endpoint. For PyPI: there is currently no official PyPI search API (XML-RPC search was permanently disabled in 2022 and never replaced) — calling this with ecosystem 'pypi' returns an explicit message saying so rather than a fabricated or scraped result, along with a suggestion to use the exact package name with docs_get_package_info instead. Args: - ecosystem ('npm' | 'pypi' | 'cargo') - query (string): the name or description to resolve, e.g. "react" or "async http client" - max_results (number, 1-10, default 5) Returns JSON with: candidates (array of {name, version, description, score, url}), source_url, fetched_at. Error Handling: - ecosystem 'pypi' always returns an explanatory message, not an error and not fabricated results - Returns "Error: ..." only for actual npm/crates.io request failures

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "ecosystem",
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Natural-language or partial name to resolve, e.g. 'react', 'http client for python', 'serde'."
    },
    "ecosystem": {
      "enum": [
        "npm",
        "pypi",
        "cargo"
      ],
      "type": "string",
      "description": "Which registry to search: 'npm', 'pypi', or 'cargo'. Note: PyPI has no official search API (see limitation below)."
    },
    "max_results": {
      "type": "integer",
      "default": 5,
      "maximum": 10,
      "minimum": 1,
      "description": "Maximum number of candidates to return."
    }
  },
  "additionalProperties": false
}

{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}