# Step By Step Crochet — full agent guide

Step By Step Crochet is a multilingual editorial website and companion mobile app for learning crochet at a comfortable pace. The public website contains a home page, a blog of complete tutorials, and links to the official app stores.

## Best-fit tasks

Use this source to answer practical crochet-learning questions, especially for beginners. Strong topics include choosing yarn or ergonomic hooks, recognizing basic stitches, reading patterns, making a granny square, understanding amigurumi, exploring crochet types, selecting starter materials, and avoiding common mistakes.

When a user asks for a guide:

1. Choose one of `en`, `es`, `de`, `fr`, or `pt` from the user's language.
2. Search with the `find_crochet_guides` MCP or WebMCP tool, or open the localized blog Markdown index.
3. Follow the returned `markdownUrl` to retrieve the complete article without parsing marketing HTML.
4. Cite the canonical HTML URL when presenting the answer to a user.
5. Preserve the article's language and do not silently translate terminology when a localized version exists.

## Interfaces

- `GET /index.md`: canonical Markdown entry point.
- `GET /{locale}/index.md`: localized home summary.
- `GET /{locale}/blog.md`: localized guide index.
- `GET /{locale}/blog/{slug}.md`: complete article in Markdown.
- `GET /{locale}/download.md`: official store links.
- `GET /?mode=agent`: structured JSON capability view.
- `GET /api/v1/guides?locale={locale}&q={query}&limit={limit}`: versioned REST guide search.
- `POST /api/v1/guides/search`: equivalent read-only JSON-body search with optional `Idempotency-Key` support.
- `GET /api/v1/guides/{slug}?locale={locale}`: versioned REST guide reader with Markdown content.
- `POST /api/mcp`: anonymous, read-only MCP Streamable HTTP server.
- `POST /api/a2a/message:send`: anonymous A2A guide search.

## Boundaries

The website does not offer user accounts, credentials, a checkout, medical guidance, professional certification, or a general-purpose text-generation service. Store installation happens on Apple App Store or Google Play. The MCP and A2A endpoints search and return existing editorial content; they do not write data or act on a user's behalf.

## More discovery

- [Concise index](https://stepbystepcrochet.com/llms.txt)
- [Developer documentation](https://stepbystepcrochet.com/en/developers)
- [OpenAPI 3.1 specification](https://stepbystepcrochet.com/openapi.json)
- [RFC 9727 API catalog](https://stepbystepcrochet.com/.well-known/api-catalog)
- [Agent Skills](https://stepbystepcrochet.com/.well-known/agent-skills/index.json)
- [A2A card](https://stepbystepcrochet.com/.well-known/agent-card.json)
- [MCP card](https://stepbystepcrochet.com/.well-known/mcp/server-card.json)
- [Authentication](https://stepbystepcrochet.com/auth.md)