Refactor Substreams AI docs: expand Skills page, retire Substreams MCP page

[brandonleekramer]

Summary

Updates the Substreams AI tooling documentation to reflect the current state of the Substreams Skills plugin (v1.4.0) and retires the standalone Substreams MCP page. The MCP's registry-search and package-inspection capabilities now live in the skills (the substreams-dev skill includes a Registry Search API section), so all references are consolidated onto the Skills page, with redirects in place for old URLs.

Changes

Rewrote the Substreams Skills page (substreams/tooling/skills.mdx)

• Expanded from 3 documented skills to the full current set, grouped into logical sections:
  • Core Development — substreams-dev
  • Chain-Specific — substreams-ethereum, substreams-solana
  • SQL & Sinks — substreams-sql, substreams-sink
  • Deployment — substreams-sink-deploy-local, substreams-hosted-sink
  • Portal Account — portal-api, portal-api-jwt
  • Testing — substreams-testing
• Updated install instructions to the current marketplace flow (claude plugin marketplace add streamingfast/substreams-skills + claude plugin install substreams-dev@streamingfast-substreams) and added a /skills verification block.
• Refreshed resource links (docs.substreams.dev, current Claude Code plugins docs, StreamingFast Discord).

Removed the Substreams MCP page

• Deleted substreams/tooling/substreams-mcp/ (search.mdx + _meta.js).
• Removed the substreams-mcp entry from the tooling nav (_meta.js, _meta-titles.json).
• Removed the stale /en/substreams/tooling/substreams-mcp/search/ entry from route-lockfile.txt.

Repointed all remaining MCP references to Skills

• ai-overview.mdx: dropped the dead Substreams MCP link in the intro, removed the standalone "Substreams MCP" section (heading, tools table, benefits), and folded its capabilities (registry discovery, module-graph/protobuf inspection, sink-command generation) into the "Agent Skills for Substreams" section.
• substreams-dev.mdx (public-substreams): repointed the "Tip" callout from the Substreams Search MCP to Substreams Skills.

Added redirects (nginx.conf)

Old MCP URLs now 301 to the Skills page:

From	To
/en/ai-suite/substreams-mcp/	/en/substreams/tooling/skills/
/en/substreams/tooling/substreams-mcp/... (incl. /search/)	/en/substreams/tooling/skills/
/en/substreams/substreams-mcp/...	/en/substreams/tooling/skills/

Files changed

 nginx.conf                                                       |   6 +-
 website/route-lockfile.txt                                       |   1 -
 website/src/pages/en/ai-overview.mdx                             |  25 +---
 website/src/pages/en/substreams/public-substreams/substreams-dev.mdx |   2 +-
 website/src/pages/en/substreams/tooling/_meta-titles.json        |   4 +-
 website/src/pages/en/substreams/tooling/_meta.js                 |   3 -
 website/src/pages/en/substreams/tooling/skills.mdx               | 151 +++++++++++++++++----
 website/src/pages/en/substreams/tooling/substreams-mcp/_meta.js  |   3 -
 website/src/pages/en/substreams/tooling/substreams-mcp/search.mdx| 138 -------------------
 9 files changed, 130 insertions(+), 203 deletions(-)

Testing / verification

• pnpm install && pnpm lint:fix && pnpm prettier pass clean
• Site builds without broken-link errors for the removed MCP route
• /en/substreams/tooling/substreams-mcp/search/ redirects (301) to /en/substreams/tooling/skills/
• /en/ai-suite/substreams-mcp/ redirects (301) to the Skills page
• Skills page renders with all sections and correct install commands

Notes

• The ai-overview.mdx "Available Skills for Substreams" table still lists the original three skills (substreams-dev, substreams-sql, substreams-testing); it can be synced to the fuller set in a follow-up if desired.
• Skill inventory follows the upstream repo's documented/official list; the substreams-bitcoin and substreams-convert directories that exist in the repo but are not in the maintainers' published list were intentionally not documented.
  🤖 Generated with Claude Code