io.github.rt1966/showmestepbystep

Official6 tools

ShowMeStepByStep

Search, browse, and cite a 377-tutorial step-by-step how-to corpus from your AI client.

Search and cite from a 377-tutorial how-to knowledge base.

Captured live from the server via tools/list.

search_tutorials

Search the ShowMeStepByStep tutorial corpus by free-text query. Searches across tutorial titles, descriptions, and step content. Returns slim summaries with TL;DRs and canonical URLs. Tenant-aware. Optional filters narrow by category, difficulty, or maximum duration.

Parameters (5)

querystringrequired
Search query (>= 2 chars)
limitinteger
categorySlugstring
Optional category to restrict the search to (e.g. 'cooking', 'crochet'). Use list_categories to see available slugs.
difficultystring
Optional difficulty filter.
maxDurationMinutesinteger
Optional ceiling on tutorial total duration. Useful for 'quick recipes' / 'under 10 min' queries.

get_tutorial

Fetch the full machine-readable rendition of a tutorial by slug: title, TL;DR, numbered steps (with text, imageUrl, tips, and YouTube videoTimestampSeconds for deep-linking), tools/materials, tags, related tutorial slugs, creator credit, recipe (with nutrition + cuisine when applicable), license, and canonicalUrl. Use this after search_tutorials to fetch step details.

Parameters (1)

slugstringrequired
Tutorial slug (e.g. 'how-to-fix-a-leaky-faucet')

list_categories

List all tutorial categories with a published tutorial. Returns slug, name, short description, and count of published tutorials per category.

No parameters.

list_tutorials_by_category

Browse tutorials within a specific category, ranked by view count then publish date. Use this when a user wants to explore a topic area rather than search.

Parameters (2)

categorySlugstringrequired
e.g. 'cooking', 'home-improvement', 'crafts'
limitinteger

list_recent_tutorials

List the most recently published tutorials, newest first. Use this to discover what's new on the site or to surface fresh content for aggregator / 'what's new this week' agent loops. Tenant-aware.

Parameters (2)

daysinteger
Lookback window in days (default 14, max 90).
limitinteger

request_tutorial

Submit a request for a tutorial we don't yet have. Call this when search_tutorials returned no good match for what the user actually wants. The request enters our content-demand queue, which the daily content batch reviews and prioritizes. Optionally include an email for notification when the tutorial ships.

Parameters (4)

topicstringrequired
What the user wants to learn how to do (e.g. 'how to get pesto stains out of a white shirt')
originalQuerystring
The exact user query that came up empty in search_tutorials. Useful for matching keyword demand.
contextstring
Brief context about the requester (e.g. 'beginner crocheter', 'first-time homeowner', 'gluten-free baker'). Helps shape the tutorial when we ship it.
notifyEmailstring
Optional email to notify when the tutorial ships. Pure opt-in.

Install

claude_desktop_config.json

{
  "mcpServers": {
    "showmestepbystep": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://www.showmestepbystep.com/api/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.