ShowMeStepByStep

Official6 toolsLive

by rt1966

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

io.github.rt1966/showmestepbystep (MCP) Server

The MCP server io.github.rt1966/showmestepbystep provides search, browsing, and citation for a step-by-step how-to corpus containing 377 tutorials, intended to be used from an AI client. Its functionality is exposed through 6 tools.

🛠️ Key Features

Search a 377-tutorial step-by-step how-to corpus
Browse tutorial content
Cite results for use in an AI client

🚀 Use Cases

Finding specific steps within a step-by-step how-to tutorial set
Navigating across a 377-tutorial corpus from an AI client
Producing cited references alongside retrieved tutorial content

⚡ Developer Benefits

Tool-based access (6 tools) to search, browse, and citation capabilities
Direct alignment with “step-by-step how-to” retrieval workflows

⚠️ Limitations

Limited scope to the described 377-tutorial step-by-step corpus
No additional capabilities beyond search, browsing, and citation are indicated

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.

Parameters5

query	string	required	Search query (>= 2 chars)
limit	integer	optional
categorySlug	string	optional	Optional category to restrict the search to (e.g. 'cooking', 'crochet'). Use list_categories to see available slugs.
difficulty	string	optional	Optional difficulty filter.
maxDurationMinutes	integer	optional	Optional ceiling on tutorial total duration. Useful for 'quick recipes' / 'under 10 min' queries.

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Search query (>= 2 chars)"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 25,
      "default": 10
    },
    "categorySlug": {
      "type": "string",
      "description": "Optional category to restrict the search to (e.g. 'cooking', 'crochet'). Use list_categories to see available slugs."
    },
    "difficulty": {
      "type": "string",
      "enum": [
        "easy",
        "intermediate",
        "advanced"
      ],
      "description": "Optional difficulty filter."
    },
    "maxDurationMinutes": {
      "type": "integer",
      "minimum": 1,
      "description": "Optional ceiling on tutorial total duration. Useful for 'quick recipes' / 'under 10 min' queries."
    }
  },
  "required": [
    "query"
  ]
}

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.

Parameters1

slug

string

required

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

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Tutorial slug (e.g. 'how-to-fix-a-leaky-faucet')"
    }
  },
  "required": [
    "slug"
  ]
}

list_categories

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

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

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.

Parameters2

categorySlug	string	required	e.g. 'cooking', 'home-improvement', 'crafts'
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "categorySlug": {
      "type": "string",
      "description": "e.g. 'cooking', 'home-improvement', 'crafts'"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "default": 20
    }
  },
  "required": [
    "categorySlug"
  ]
}

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.

Parameters2

days	integer	optional	Lookback window in days (default 14, max 90).
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 90,
      "default": 14,
      "description": "Lookback window in days (default 14, max 90)."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "default": 20
    }
  }
}

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.

Parameters4

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

Raw schema

{
  "type": "object",
  "properties": {
    "topic": {
      "type": "string",
      "minLength": 5,
      "maxLength": 200,
      "description": "What the user wants to learn how to do (e.g. 'how to get pesto stains out of a white shirt')"
    },
    "originalQuery": {
      "type": "string",
      "maxLength": 500,
      "description": "The exact user query that came up empty in search_tutorials. Useful for matching keyword demand."
    },
    "context": {
      "type": "string",
      "maxLength": 200,
      "description": "Brief context about the requester (e.g. 'beginner crocheter', 'first-time homeowner', 'gluten-free baker'). Helps shape the tutorial when we ship it."
    },
    "notifyEmail": {
      "type": "string",
      "maxLength": 254,
      "description": "Optional email to notify when the tutorial ships. Pure opt-in."
    }
  },
  "required": [
    "topic"
  ]
}

Install

Tools (6)

search_tutorialsget_tutoriallist_categorieslist_tutorials_by_categorylist_recent_tutorialsrequest_tutorial

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://www.showmestepbystep.com/api/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

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.

io.github.rt1966/showmestepbystep (MCP) Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

search_tutorials

get_tutorial

list_categories

list_tutorials_by_category

list_recent_tutorials

request_tutorial

Install

Remote endpoint

Related servers