← Back to Skills Marketplace
paulieb14

Substreams Search

by PaulieB14 · GitHub ↗ · v1.3.2 · MIT-0
cross-platform ⚠ suspicious
295
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install substreams-search-mcp
Description
Search, inspect, and analyze Substreams packages from the substreams.dev registry — module graphs, protobuf types, and sink deployment commands.
Usage Guidance
This skill appears to implement the advertised features, but review these before installing/ running: - Verify source/packaging: npx will execute code published on npm. Check the npm package page and the GitHub repo (owner PaulieB14) to confirm the published code matches the repository and is from a trusted maintainer. - Python artifacts present: the bundle includes server.py and requirements.txt but the skill only declares Node as required. Ask the maintainer why a Python implementation is included or inspect the files locally — don't assume only Node code will run. - Network exposure: the server can open an HTTP/SSE endpoint (default port 3849). If you run this on a shared or publicly reachable host, ensure it binds to localhost or is behind a firewall so it cannot be accessed from the internet unintentionally. - Remote fetches: the tool fetches arbitrary .spkg URLs and scrapes substreams.dev HTML. These remote inputs could be malformed or hostile; consider running in a restricted environment or container, and avoid running as a privileged user. - Safer testing: inspect the repository code locally (build directory / installed package contents) before running npx, or run npx in a disposable container/VM. If you need higher assurance, request the maintainer to provide a signed release or verify the package integrity on npm/GitHub before use.
Capability Analysis
Type: OpenClaw Skill Name: substreams-search-mcp Version: 1.3.2 The skill bundle provides a legitimate MCP server for searching the Substreams package registry and inspecting blockchain data stream packages (.spkg files). It implements tools in both Python (server.py) and TypeScript (src/index.ts) that perform web scraping of substreams.dev and utilize the @substreams/core library to parse protobuf metadata. While it includes functionality to generate CLI deployment commands and starts a local HTTP server for SSE transport (port 3849), these behaviors are clearly documented in SKILL.md and README.md and align with the stated purpose of assisting developers in the Substreams ecosystem.
Capability Assessment
Purpose & Capability
The skill's name/description align with its behavior: it scrapes the public substreams.dev registry and inspects .spkg files. However, the bundle contains both a Node-based implementation (src/index.ts, package.json) and a separate Python implementation (server.py + requirements.txt) while the declared required binary is only 'node' and SKILL.md insists on running via 'npx'. The presence of Python artifacts without declaring Python as required is an incoherence worth flagging.
Instruction Scope
SKILL.md instructions are scoped to searching, scraping substreams.dev pages, fetching .spkg files from spkg.io, and optionally starting an SSE/HTTP server on a local port. The runtime instructions do not direct reading unrelated local files or environment secrets. They do instruct the agent to fetch arbitrary external URLs (package pages and .spkg binaries), which is expected for this tool but increases exposure to malicious or malformed remote content.
Install Mechanism
There is no explicit install spec in the skill metadata; the README/SKILL.md instructs use via 'npx substreams-search-mcp', which will fetch and run package code from the npm registry. That is a common pattern but still a moderate-risk install mechanism because it executes remote code. The included package.json/package-lock indicate multiple third-party dependencies (normal for this functionality). No direct downloads from arbitrary URLs or archive extracts are specified in the skill metadata.
Credentials
The skill declares no required environment variables or credentials (only an optional MCP_HTTP_PORT to change the HTTP port). That is appropriate for a public-registry search/inspect tool; there are no unrelated credential requests.
Persistence & Privilege
always:false (normal). The skill can start a local HTTP/SSE server (default port 3849) to accept connections from agents. Running a server is within the tool's purpose but is a privilege that could expose a listening endpoint if the process binds to non-local interfaces or if your environment forwards ports. The skill does not request system-wide config changes or other skills' credentials.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install substreams-search-mcp
  3. After installation, invoke the skill by name or use /substreams-search-mcp
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.3.2
Add OpenClaw YAML frontmatter for agent discovery and skill gating
v1.3.1
- Enhanced documentation for all features and usage, including tool descriptions and requirements - Clarified that no API key or environment variables are required - Described new behavior for inspecting packages, sink config analysis, and search (including supported networks) - Added details on SSE/http server, network usage, and use cases for various blockchains and sinks
Metadata
Slug substreams-search-mcp
Version 1.3.2
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 2
Frequently Asked Questions

What is Substreams Search?

Search, inspect, and analyze Substreams packages from the substreams.dev registry — module graphs, protobuf types, and sink deployment commands. It is an AI Agent Skill for Claude Code / OpenClaw, with 295 downloads so far.

How do I install Substreams Search?

Run "/install substreams-search-mcp" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Substreams Search free?

Yes, Substreams Search is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Substreams Search support?

Substreams Search is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Substreams Search?

It is built and maintained by PaulieB14 (@paulieb14); the current version is v1.3.2.

💬 Comments