{"$schema":"https://verifymcp.io/schemas/trust-report.json","schemaVersion":1,"license":{"name":"CC BY-NC 4.0","url":"https://creativecommons.org/licenses/by-nc/4.0/"},"generatedAt":"2026-11-06T03:43:49.210Z","url":"https://verifymcp.io/servers/pipeworx-io-shodan/pipeworx-mcp-shodan","markdownUrl":"https://verifymcp.io/servers/pipeworx-io-shodan/pipeworx-mcp-shodan.md","server":{"slug":"pipeworx-io-shodan","name":"Shodan","registryName":"io.github.pipeworx-io/shodan","description":"Shodan MCP — wraps the full Shodan REST API (api.shodan.io)","registryStatus":"active","deletedAt":null,"statusMessage":null,"liveness":"live","publisher":{"class":"unknown","claimed":false}},"component":{"slug":"pipeworx-mcp-shodan","type":"npm","identifier":"@pipeworx/mcp-shodan","withdrawn":false,"url":"https://verifymcp.io/servers/pipeworx-io-shodan/pipeworx-mcp-shodan","version":"0.2.1","transport":"stdio","scoredAt":"2026-11-05T04:01:37.809Z"},"score":{"total":84,"tier":"high trust","status":"scored","weekDelta":4,"history":[{"date":"2026-11-05","total":84},{"date":"2026-11-04","total":83},{"date":"2026-11-03","total":83},{"date":"2026-11-02","total":82},{"date":"2026-11-01","total":82},{"date":"2026-10-31","total":81},{"date":"2026-10-30","total":81},{"date":"2026-10-29","total":80}]},"categories":[{"name":"Supply Chain Security","score":100,"verdict":"pass","reasons":["No malware found by supply-chain analysis.","No known CVEs affecting this package version or its production dependencies.","No install/post-install scripts declared.","No production dependencies, so there is no dependency health to assess."],"codes":[{"code":"supplychain.malware_clean","args":{}},{"code":"cve.none","args":{}},{"code":"installscript.none","args":{}},{"code":"dephealth.no_dependencies","args":{"deps":"0","unhealthy":"0"}}]},{"name":"Provenance & Transparency","score":97,"verdict":"fail","reasons":["Source repository is publicly reachable at the declared URL.","Cryptographically verified build provenance (signed, bound to pipeworx-io/mcp-shodan).","Clear OSI-approved license (MIT).","Actively maintained (last published 0 days ago).","Disclosure check failed: no security disclosure policy was found in the source repository."],"codes":[{"code":"provenance.repo_verified","args":{}},{"code":"provenance.verified","args":{"repo":"pipeworx-io/mcp-shodan"}},{"code":"license.osi","args":{"spdx":"MIT"}},{"code":"maintenance.recent","args":{"age_days":"0"}},{"code":"disclosure.absent","args":{}}]},{"name":"Schema Quality & AI Usability","score":72,"verdict":"fail","reasons":["AI-judged instruction clarity (excellent).","Context-footprint check failed: tool/resource definitions use about 521 tokens (~173/item across 3 items; 3 tools + 0 resources), over budget; trim descriptions and params.","Usage-examples check failed: none of the tools include examples."],"codes":[{"code":"schema.ai_quality","args":{"band":"excellent"}},{"code":"schema.footprint_heavy","args":{"avg":"173","items":"3","tools":"3","tokens":"521","resources":"0"}},{"code":"schema.examples_absent","args":{}}]},{"name":"Stability & Change Management","score":23,"verdict":"partial","reasons":["Stability observed for 7 of 30 days with no destabilising changes; credit accrues until the full window elapses."],"codes":[{"code":"stability.building_history","args":{"days":"7"}}]},{"name":"Tool Coverage","score":100,"verdict":"pass","reasons":["100% of tools have a non-trivial description (not blank, and not just the tool's name).","100% of tool parameters carry a description."],"codes":[{"code":"toolquality.descriptions","args":{"pct":"100"}},{"code":"toolquality.param_docs","args":{"pct":"100"}}]},{"name":"Tool Safety","score":100,"verdict":"pass","reasons":["No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.","We read all 3 captured tool definition(s), and no name or description among them implies an irreversible operation.","An AI judge read all 4 captured unit(s) of tool text and found none that tries to manipulate the model reading it."],"codes":[{"code":"toolsafety.injection_clean","args":{}},{"code":"toolsafety.destructive_none","args":{"tools":"3"}},{"code":"toolsafety.manipulation_clean","args":{"units":"4","judged":"4"}}]},{"name":"Capabilities","score":100,"verdict":"pass","reasons":["Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28."],"codes":[{"code":"protocol.supported","args":{"latest":"2026-07-28","version":"2025-11-25"}}]}],"inconclusive":[],"malware":[],"components":[{"slug":"shodan-mcp","type":"remote","identifier":"https://gateway.pipeworx.io/shodan/mcp","withdrawn":false,"score":77,"current":false,"url":"https://verifymcp.io/servers/pipeworx-io-shodan/shodan-mcp","markdownUrl":"https://verifymcp.io/servers/pipeworx-io-shodan/shodan-mcp.md"},{"slug":"pipeworx-mcp-shodan","type":"npm","identifier":"@pipeworx/mcp-shodan","withdrawn":false,"score":84,"current":true,"url":"https://verifymcp.io/servers/pipeworx-io-shodan/pipeworx-mcp-shodan","markdownUrl":"https://verifymcp.io/servers/pipeworx-io-shodan/pipeworx-mcp-shodan.md"}],"facts":[{"label":"Registry","value":"npm"},{"label":"Package","value":"@pipeworx/mcp-shodan"},{"label":"Version","value":"0.2.1"},{"label":"Transport","value":"stdio"}],"install":{"available":true,"bundleSha256":null},"tools":[{"name":"shodan_host","title":null,"description":"What's exposed on IP <ip> — open ports, services, and CVEs. Returns the full Shodan host profile: ports, hostnames, org/ISP, geolocation, OS, known vulnerabilities, and a per-service banner sample. Example: shodan_host({ ip: \"8.8.8.8\", _apiKey: \"your-key\" })","inputs":[{"name":"_apiKey","type":"string","required":true,"description":"Shodan API key (account.shodan.io; paid membership required)"},{"name":"history","type":"boolean","required":false,"description":"Include historical banners (optional, default false)"},{"name":"ip","type":"string","required":true,"description":"IPv4 address to look up, e.g. \"8.8.8.8\""}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":146},{"name":"shodan_host_search","title":null,"description":"Search Shodan for hosts matching <query> using Shodan search syntax (e.g. \"apache country:US\", \"port:22 org:\\\"Google\\\"\"). Returns matching hosts with IP, port, org, hostnames, product, and location. Example: shodan_host_search({ query: \"apache country:US\", _apiKey: \"your-key\" })","inputs":[{"name":"_apiKey","type":"string","required":true,"description":"Shodan API key (account.shodan.io; paid membership required)"},{"name":"page","type":"integer","required":false,"description":"Result page number (optional, 100 results/page, default 1)"},{"name":"query","type":"string","required":true,"description":"Shodan search query. Supports filters like country:, org:, port:, product:, os:, e.g. \"apache country:US\""}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":161},{"name":"shodan_host_count","title":null,"description":"Count hosts matching <query> with facet breakdown (free — this endpoint does not consume query credits). Returns the total match count plus optional facet aggregations (e.g. top countries, orgs, ports). Example: shodan_host_count({ query: \"apache\", facets: \"country:10\", _apiKey: \"your-key\" })","inputs":[{"name":"_apiKey","type":"string","required":true,"description":"Shodan API key (account.shodan.io; paid membership required)"},{"name":"facets","type":"string","required":false,"description":"Comma-separated facets for aggregation, e.g. \"country:10\" or \"org:5,port:5\" (optional)"},{"name":"query","type":"string","required":true,"description":"Shodan search query, e.g. \"apache\" or \"port:443 country:DE\""}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":162}],"toolsTruncatedAtCapture":false,"diagnostics":{"capturedAt":"2026-11-05T04:01:37.000Z","track":"package","endpoint":null,"declaredUrl":null,"truncated":false,"tls":null,"dnssec":null,"auth":null,"httpsRedirect":null,"transports":[],"provenance":{"outcome":"verified","label":"Verified","reason":"verified","reasonLabel":"Verified","discovery":"attestation_endpoint","discoveryLabel":"Registry attestation endpoint","sourceRepo":null,"attestationSkipped":null,"attestationSkippedLabel":null},"installScripts":[],"installScriptsTotal":null,"vulnerabilities":[],"vulnerabilitiesTotal":null,"dependencies":{"nodes":0,"partial":false,"deprecated":null,"stale":null,"noRepo":null}},"mismatches":[],"changelog":{"trackingSince":"2026-10-29","recent":[{"id":"chg_01a1a9de-9032-7532-980c-9763bb42943b","kind":"package.version_changed","summary":"Package version (0.2.0 → 0.2.1)","materiality":"functional","direction":"neutral","scoreDelta":null,"occurredOn":"2026-11-05","url":"https://verifymcp.io/servers/pipeworx-io-shodan/pipeworx-mcp-shodan#chg-chg_01a1a9de-9032-7532-980c-9763bb42943b"},{"id":"chg_01a1a9de-9030-7e52-b79b-7825df50f6e0","kind":"check.reverified","summary":"Security disclosure (unverified → fail)","materiality":"functional","direction":"regression","scoreDelta":null,"occurredOn":"2026-11-05","url":"https://verifymcp.io/servers/pipeworx-io-shodan/pipeworx-mcp-shodan#chg-chg_01a1a9de-9030-7e52-b79b-7825df50f6e0"},{"id":"chg_01a1a9de-9034-7108-a785-b2953a826f94","kind":"score.total_changed","summary":"Trust score (83 → 84)","materiality":"functional","direction":"improvement","scoreDelta":1,"occurredOn":"2026-11-05","url":"https://verifymcp.io/servers/pipeworx-io-shodan/pipeworx-mcp-shodan#chg-chg_01a1a9de-9034-7108-a785-b2953a826f94"},{"id":"chg_01a19fe8-9a36-75b3-8cb0-69d1fcce462b","kind":"check.unverifiable","summary":"Security disclosure (fail → unverified)","materiality":"functional","direction":"regression","scoreDelta":null,"occurredOn":"2026-11-03","url":"https://verifymcp.io/servers/pipeworx-io-shodan/pipeworx-mcp-shodan#chg-chg_01a19fe8-9a36-75b3-8cb0-69d1fcce462b"},{"id":"chg_01a19fe8-9a38-76fa-9e04-516cdf92c41d","kind":"score.total_changed","summary":"Trust score (82 → 83)","materiality":"functional","direction":"improvement","scoreDelta":1,"occurredOn":"2026-11-03","url":"https://verifymcp.io/servers/pipeworx-io-shodan/pipeworx-mcp-shodan#chg-chg_01a19fe8-9a38-76fa-9e04-516cdf92c41d"},{"id":"chg_01a19598-43c2-7bd1-b0fe-58425bb25470","kind":"score.total_changed","summary":"Trust score (81 → 82)","materiality":"functional","direction":"improvement","scoreDelta":1,"occurredOn":"2026-11-01","url":"https://verifymcp.io/servers/pipeworx-io-shodan/pipeworx-mcp-shodan#chg-chg_01a19598-43c2-7bd1-b0fe-58425bb25470"},{"id":"chg_01a18b4e-6e43-7e43-a8f9-c286c48446ba","kind":"check.reverified","summary":"Security disclosure (unverified → fail)","materiality":"functional","direction":"regression","scoreDelta":null,"occurredOn":"2026-10-30","url":"https://verifymcp.io/servers/pipeworx-io-shodan/pipeworx-mcp-shodan#chg-chg_01a18b4e-6e43-7e43-a8f9-c286c48446ba"},{"id":"chg_01a18b4e-6e45-73d8-92ed-122c8355b8a9","kind":"score.total_changed","summary":"Trust score (80 → 81)","materiality":"functional","direction":"improvement","scoreDelta":1,"occurredOn":"2026-10-30","url":"https://verifymcp.io/servers/pipeworx-io-shodan/pipeworx-mcp-shodan#chg-chg_01a18b4e-6e45-73d8-92ed-122c8355b8a9"},{"id":"chg_01a1870f-794c-71f8-a410-a24e8f17b411","kind":"score.first_scored","summary":"First indexed and scored","materiality":"functional","direction":"neutral","scoreDelta":null,"occurredOn":"2026-10-29","url":"https://verifymcp.io/servers/pipeworx-io-shodan/pipeworx-mcp-shodan#chg-chg_01a1870f-794c-71f8-a410-a24e8f17b411"},{"id":"chg_01a1869d-7e59-79e0-b1cf-2f46fae4ca44","kind":"score.first_scored","summary":"First indexed and scored","materiality":"functional","direction":"neutral","scoreDelta":null,"occurredOn":"2026-10-29","url":"https://verifymcp.io/servers/pipeworx-io-shodan/pipeworx-mcp-shodan#chg-chg_01a1869d-7e59-79e0-b1cf-2f46fae4ca44"}],"truncated":false,"feedUrl":"https://verifymcp.io/servers/pipeworx-io-shodan/pipeworx-mcp-shodan/changelog.json"},"links":{"html":"https://verifymcp.io/servers/pipeworx-io-shodan/pipeworx-mcp-shodan","markdown":"https://verifymcp.io/servers/pipeworx-io-shodan/pipeworx-mcp-shodan.md","changelogJson":"https://verifymcp.io/servers/pipeworx-io-shodan/pipeworx-mcp-shodan/changelog.json","changelogRss":"https://verifymcp.io/servers/pipeworx-io-shodan/pipeworx-mcp-shodan.xml","external":[{"label":"npm package","href":"https://www.npmjs.com/package/@pipeworx/mcp-shodan"},{"label":"Socket report","href":"https://socket.dev/npm/package/@pipeworx/mcp-shodan"},{"label":"Repository","href":"https://github.com/pipeworx-io/mcp-shodan"},{"label":"Website","href":"https://pipeworx.io/packs/shodan"}]}}