Skip to main content
Glama
Ravelry MCP Server

Ravelry MCP Server

by gpaul-mcp

Ravelry MCP Server

A Model Context Protocol server that turns AI assistants into a knitting and crochet companion, with Ravelry as the backbone: pattern and yarn search with a photo carousel, your stash, queue and projects, exact calculators, and a row counter.

CI MCP SDK v2 Node.js 22+

This project was inspired by my girlfriend, whose passion for knitting and crochet encouraged me to create this bridge between AI assistants and the Ravelry crafting community. Since she's not very tech-savvy and somewhat skeptical about AI, this serves as my way of connecting with her interests and showing how technology can enhance her crafting experience rather than replace it.

Use it now: no installation

A hosted instance is running at:

https://ravelry-mcp.gonz-paul.dev/mcp

You don't need a Ravelry account or API key: add the URL to your AI assistant and start asking.

Claude (web, desktop and mobile): Settings → Connectors → Add custom connector, give it a name ("Ravelry") and paste the URL. Once added, it is available everywhere you use Claude.

ChatGPT: add the URL as a custom MCP connector (developer mode), with no authentication.

Claude Code

claude mcp add --transport http ravelry https://ravelry-mcp.gonz-paul.dev/mcp

VS Code (.vscode/mcp.json)

{
  "servers": {
    "ravelry": { "type": "http", "url": "https://ravelry-mcp.gonz-paul.dev/mcp" }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "ravelry": { "url": "https://ravelry-mcp.gonz-paul.dev/mcp" }
  }
}

New here? Everything it can do, organised by what you want to do, and how to set up a Claude project as your knitting & crochet guide (instructions to paste included).

Then try one of the example prompts, or the built-in starters: Find a pattern, Substitute a yarn, What can I make with this yarn? and Yarn shops near me.

The hosted server only reads public Ravelry data with this project's read-only API key (with Ravelry's permission), stores nothing about your conversations, and allows 60 requests per minute per user. Prefer to run your own? See Run it yourself.

With your own Ravelry account

To also let your assistant read your stash, queue, projects, favorites and library, add this URL instead:

https://ravelry-mcp.gonz-paul.dev/account/mcp

The first time, your assistant opens a page where you sign in with Ravelry, then confirm on a second page which app gets access. Reading is the default; changing your stash, queue and projects needs a second permission on the same page, and the assistant confirms each change with you first. You can revoke access at any time from your Ravelry account's app settings.

Then you can ask things like:

  • "What should I make next?" (it checks which queued patterns your stash already covers)

  • "What can I make with the DK yarn in my stash?"

  • "Look at my projects and tell me what kind of maker I am." (a crafting profile your assistant can remember)

What the server stores: your Ravelry username and its Ravelry sign-in tokens, encrypted, so it can keep your connection working, and the row counters you create (encrypted, deleted when you remove them). Nothing else about you or your conversations.

Related MCP server: MCP Web Search Tool

Tools

Patterns

Tool

What it does

search_patterns

Search by keyword plus filters: craft, category (plain words like "hat", "toys" or "jumper" are mapped to Ravelry's categories), yarn weight, yardage_min/yardage_max, difficulty_max, fit (baby, child, adult, petite, plus, negative ease...), attributes (techniques and construction in plain words: "top down", "raglan", "cables", "Fair Isle", "toe up", "granny square"... all of them or any of them), language, designer, availability (free (default), ravelry, online, inprint, any), sort, paging.

get_pattern_details

Full details for 1–20 patterns: designer, price, difficulty, rating, yarn weight, yardage, gauge (also as numbers per 10 cm), needle/hook sizes, sizes, techniques, crochet terminology (US or UK), languages, photo and designer notes.

Yarns

Tool

What it does

search_yarns

Search by name plus weight, fiber (merino, alpaca, cotton...) and attributes (superwash, hand-dyed, self-striping...), sorted by best match, rating or popularity. Discontinued yarns are hidden unless asked.

get_yarn_details

For 1–20 yarns: fiber content, yards and grams per skein, recommended needles and hooks, gauge, care, texture, color/dye attributes, where it was made, and notes.

find_yarns_for_pattern

Yarn substitution: the yarns other Ravelry users actually used for a pattern, ranked by how many projects used each, next to the weight, yardage and gauge the pattern calls for and the designer's suggested yarns.

match_yarns

Matches what was read from a ball band, receipt or invoice (brand, name, weight, fiber, yards/grams per skein) to Ravelry yarns, with a confidence level, the reasons and alternatives.

Calculators and reference

The assistant uses these instead of doing knitting arithmetic in its head, so the numbers are right and it can focus on explaining.

Tool

What it does

adjust_for_gauge

Your swatch vs the pattern gauge (typed in, or read from a Ravelry pattern): change needles or not, how big the piece comes out as written, and the pattern's numbers recalculated for your gauge, rounded to the stitch repeat.

spread_evenly

"Increase 13 evenly across 97" → [k8, M1] 6 times, [k7, M1] 7 times. Knitting or crochet, flat or in the round.

yarn_needed

Skeins to buy for a pattern (smallest and largest size) in a given yarn, with a safety margin; warns when the yarn weight differs.

convert_yarn_amount

Grams ↔ meters ↔ yards ↔ skeins for a yarn (its own ball-band ratio) or a yarn weight (typical ratio, marked as an estimate): "I have 200 g of Rios", "how many grams is 300 m of DK?".

count_stitches

Reads written rows (*k2, p2; rep from * to last 2 sts, k2, (sc, inc) x 6 (18)) and counts what each step uses and makes; flags rows that don't add up and counts that differ from the pattern's.

crafting_reference

Needle and hook sizes (metric, US, UK, Japanese), yarn weights across regions (US worsted = UK aran = AU 10 ply), US↔UK crochet and knitting terms, and standard abbreviations.

Starters: Read me this row, Chart ↔ written instructions, Find a pattern from a photo and Fix my knitting or crochet problem.

Shops

Tool

What it does

find_yarn_shops

Local yarn shops around a point (latitude/longitude + radius, nearest first) or by name or city: address, distance, website, phone, email.

Your account (at /account/mcp, after signing in)

Tool

What it does

get_my_crafting_profile

Who you are as a maker: crafts, what you make most, yarn weights you use, difficulty you handle (with an estimated level), stash and queue size, plus a short summary worth remembering.

get_my_stash

Your yarn with weight, colorway, skeins and total yards, and yards available per weight.

get_my_queue

Your queued patterns with the yarn you planned for each.

get_my_projects

Your projects: pattern, craft, status, progress, dates, your rating.

get_my_favorites

Your favorited patterns, yarns, designers…

search_my_library

Patterns, books and magazines in your Ravelry library.

find_patterns_for_my_stash

Patterns that fit yarn you own: same weight, using 40–100 % of the yardage.

pick_from_my_queue

Ranks your queue by what your stash already covers: planned yarn on hand, enough yarn of the right weight, or how many yards you're short.

add_to_my_stash

Adds yarn to your stash (e.g. from a receipt photo) with colorway, dye lot, skeins, length, weight, price, shop and purchase date. Skips yarn already stashed.

add_to_my_queue

Queues patterns, optionally with the yarn you plan to use and a note. Skips patterns already queued.

get_my_project

One project: pattern, status, progress, the stash yarn it uses, and its progress log.

start_project

Starts a project from a pattern (or a queued pattern, which leaves the queue) and sets stash yarn aside for it.

log_project_progress

"Row 42 of the sleeve, used 1 skein": adds a dated line to the project's private log, sets the %, and records yarn used so far.

update_project_status

Finish (leftovers stay in the stash, empty yarn becomes used up), pause, resume or frog (yarn goes back).

update_stash_entry

Fix colorway, dye lot, location, notes, status or the total owned.

remove_from_stash

Permanently delete stash entries (only when you ask; "used up" keeps the history).

estimate_finish_date

"When will I finish?": from your own pace (yards a day over your recent finished projects), for a pattern or a project in progress; with a deadline, says if it's comfortable, tight or unlikely.

plan_yarn_shopping

Shopping list for queued or chosen patterns: what your stash already covers (each yard counted once) and what's left to buy per pattern and per weight, in skeins of the planned yarn when known.

review_my_queue

Queue tidy-up: duplicates, patterns you already made, entries waiting for years, and how long the whole queue would take at your pace. Suggests only; never removes anything.

audit_my_stash

Stash check-up: how long it would last at your pace, yarn no plan uses, the oldest yarn, weights you buy but rarely use, leftovers for scrap projects, entries missing information.

discover_patterns_for_me

New patterns from your own taste (techniques, categories, designers in your favorites), or to learn a technique you haven't used yet, leaving out what you already favorited, queued or made.

get_my_needles

Your needles and hooks; with a pattern, which sizes you have and what's missing (circulars or DPNs for patterns worked in the round).

get_row_counter

A row counter card for a project: big + / − buttons you tap while crafting, several named counters (rows, repeats, decreases), a target and the position in the pattern repeat. Also "where am I?" across projects.

set_my_preferences

Your units: metric (meters, grams, cm) or imperial (yards, ounces, inches). The assistant answers in them and widgets show them.

update_row_counter

Changes a counter from the chat ("add 4 rows", "set a 48-row target", "8-row repeat"). Counters are kept on this server (encrypted), not on Ravelry; "Save to Ravelry log" writes the position to the project.

Plus three extra starters: What should I make next?, Use up my stash and Add yarn to my stash from a photo.

Changing anything needs one extra permission ("add, update and remove" on your stash, queue and projects), asked on the same consent page. Your assistant confirms before each change.

Keeping the stash up to date

Ravelry itself does the yarn bookkeeping: when a project uses part of a stash entry, Ravelry keeps that amount aside and the rest stays free. So the assistant works through projects:

  1. Start: "Let's start Musselburgh with my teal Rios": the project is created and the yarn is set aside.

  2. Work: "I'm at row 42 of the brim, used about one skein": a dated line goes into the project's private notes (your progress log) and the yarn used is updated. Next time, "where was I?" reads that log.

  3. Finish or frog: finished projects keep their yarn and the leftovers stay in your stash (yarn with nothing left becomes "used up"); frogged projects give the yarn back.

That way "what can I make with my stash?" and "what can I start from my queue?" only count yarn that is really free.

Widgets in the chat

In apps that support MCP Apps (Claude, ChatGPT…), two kinds of results show up as interactive widgets; everything else stays plain text:

  • Pattern carousel (search_patterns, discover_patterns_for_me, find_patterns_for_my_stash): swipeable cards with the pattern photo (tap it to open Ravelry), difficulty, yarn weight, yardage, rating and price. Tap 👍 or 👎 on each one; your picks are shared with the assistant as you go, and Find more like my 👍 asks it to dig deeper in that style. Each card also has Similar, Details and + Queue.

  • Row counter (get_row_counter), for a Ravelry project or anything you name: big − / + buttons that respond instantly (saved in the background), keyboard support (↑ / ↓ / space), several counters per project, a target and the position in the pattern repeat, and Save to Ravelry log.

Run it yourself

Only needed if you don't want to use the hosted instance. Requires Node.js 22 or later and your own Ravelry API key.

Get Ravelry API credentials

The server uses Ravelry's read-only basic-auth API keys, not your Ravelry login:

  1. Sign in at https://www.ravelry.com/pro/developer (a free Pro account is created if you don't have one).

  2. Create an app and choose basic auth with read-only access.

  3. Copy the generated username and password.

Claude Desktop: one-click bundle

npm install
npm run pack:mcpb

Then double-click the generated ravelry-mcp.mcpb (or drag it onto Claude Desktop's Settings → Extensions page). Claude Desktop asks for the API username and password and stores the password securely.

Any MCP client: build and point at dist/index.js

git clone https://github.com/gpaul-mcp/MCP_ravelry.git
cd MCP_ravelry
npm install
npm run build

Claude Code

claude mcp add ravelry -e RAVELRY_USERNAME=your-api-username -e RAVELRY_PASSWORD=your-api-password -- node /absolute/path/to/MCP_ravelry/dist/index.js

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "ravelry": {
      "command": "node",
      "args": ["/absolute/path/to/MCP_ravelry/dist/index.js"],
      "env": {
        "RAVELRY_USERNAME": "your-api-username",
        "RAVELRY_PASSWORD": "your-api-password"
      }
    }
  }
}

VS Code (.vscode/mcp.json, prompts for the password instead of storing it in the file)

{
  "inputs": [
    {
      "type": "promptString",
      "id": "ravelry-password",
      "description": "Ravelry API password",
      "password": true
    }
  ],
  "servers": {
    "ravelry": {
      "type": "stdio",
      "command": "node",
      "args": ["/absolute/path/to/MCP_ravelry/dist/index.js"],
      "env": {
        "RAVELRY_USERNAME": "your-api-username",
        "RAVELRY_PASSWORD": "${input:ravelry-password}"
      }
    }
  }
}

Configuration

All configuration comes from environment variables. For local development you can put them in a .env file (see .env.example); it is git-ignored.

Variable

Default

Description

RAVELRY_USERNAME

(required)

Read-only API username (AUTH_USER is still accepted).

RAVELRY_PASSWORD

(required)

Read-only API password (AUTH_PASS is still accepted).

MCP_TRANSPORT

stdio

stdio, or http to serve Streamable HTTP at /mcp.

HOST

127.0.0.1

HTTP mode bind address.

PORT

3000

HTTP mode port.

RAVELRY_TIMEOUT_MS

15000

Timeout for each Ravelry API request.

MCP_ALLOWED_HOSTS

(none)

HTTP mode: public hostnames accepted besides localhost, comma-separated.

MCP_URL_SECRET

(none)

HTTP mode: serve at /mcp/<secret> instead of /mcp (16+ characters).

RATE_LIMIT_PER_MINUTE

60

HTTP mode: requests per client per minute; 0 disables.

TRUST_PROXY

false

HTTP mode: identify clients by CF-Connecting-IP / X-Forwarded-For.

RAVELRY_OAUTH_CLIENT_ID / RAVELRY_OAUTH_CLIENT_SECRET

(none)

Enables "Sign in with Ravelry" and /account/mcp. A Ravelry OAuth 2.0 app whose redirect URL is <PUBLIC_URL>/oauth/ravelry/callback.

PUBLIC_URL

(none)

With sign-in: the public origin, e.g. https://ravelry.example.com.

AUTH_SECRET

(none)

With sign-in: 32+ random characters; encrypts stored tokens and signs cookies.

DATA_DIR

./data

With sign-in: where the SQLite sign-in database is kept.

HTTP mode and hosting

MCP_TRANSPORT=http npm start serves Streamable HTTP at http://127.0.0.1:3000/mcp, plus GET /health and a short landing page at / that shows the connector URL. Host and Origin headers must be localhost or one of MCP_ALLOWED_HOSTS (protection against DNS rebinding).

To host your own instance that people add to Claude or ChatGPT by URL (like the hosted one above), follow Self-hosting with Cloudflare Tunnel: a Docker Compose setup that runs it on your own machine for free.

How "Sign in with Ravelry" works

/account/mcp is an OAuth-protected MCP endpoint, following the MCP authorization spec:

  1. An unauthenticated request gets 401 with a WWW-Authenticate header pointing to /.well-known/oauth-protected-resource/account/mcp, which names this server as the authorization server.

  2. The client discovers /.well-known/oauth-authorization-server, registers itself (dynamic client registration) and starts an authorization-code flow with PKCE (required).

  3. The server (oidc-provider) sends the user to Ravelry's OAuth to sign in, then shows its own consent page naming the client. Each new client must be approved, so another app can't silently reuse someone's Ravelry sign-in.

  4. The client receives an access token (1 hour) and refresh token, scoped to /account/mcp (RFC 8707). Ravelry's own tokens never leave the server; they are refreshed as needed.

Everything is stored in SQLite under DATA_DIR: lookup keys are hashed and every record (including Ravelry tokens) is encrypted with a key derived from AUTH_SECRET.

Development

npm run dev        # run from source with auto-restart (Node runs the TypeScript directly)
npm run inspect    # build and open the MCP Inspector against the server
npm run check      # typecheck + lint + tests
npm run smoke      # after `npm run build`: live end-to-end test against the real Ravelry API

Script

Purpose

npm run build

Compile to dist/ with tsc.

npm start

Run the compiled server.

npm test

Vitest suite: drives the server through a real MCP client.

npm run lint

ESLint (type-checked rules) + Prettier check.

npm run lint:fix

Auto-fix lint and formatting.

npm run pack:mcpb

Build a Claude Desktop bundle (ravelry-mcp.mcpb).

A Husky pre-commit hook runs lint-staged, the typecheck and the tests. CI runs the same checks on Node 22 and 24.

Project structure

src/
├── index.ts                    # Entry point: config, transport (stdio or HTTP), shutdown
├── server.ts                   # createServer() factory: server info, instructions, tools
├── config.ts                   # Environment variable parsing and validation (zod)
├── http.ts                     # Streamable HTTP: host checks, URL secret, rate limit, /health, landing page
├── rate-limit.ts               # Per-client request limiter
├── prompts.ts                  # Conversation starters (MCP prompts)
├── auth/                       # "Sign in with Ravelry": OAuth server, consent page, storage
│   ├── server.ts               # oidc-provider setup, Ravelry login step, consent, token checks
│   ├── ravelry-oauth.ts        # Ravelry's OAuth 2.0 endpoints
│   ├── accounts.ts             # Signed-in accounts and Ravelry token refresh
│   ├── adapter.ts / db.ts      # Encrypted SQLite storage
│   └── crypto.ts / pages.ts    # Key derivation, encryption, HTML pages
├── account/                    # Personal tools for signed-in users
│   ├── lists.ts                # get_my_stash, get_my_queue, get_my_projects, ...
│   ├── insights.ts             # find_patterns_for_my_stash, pick_from_my_queue, profile
│   ├── stash.ts                # Stash normalization (yards per weight)
│   └── setup.ts                # Wires sign-in and the per-user server
├── ravelry/
│   ├── client.ts               # Ravelry API client (fetch, timeouts, cancellation, errors)
│   ├── types.ts                # Ravelry API response types
│   └── vocabulary.ts           # Verified filter values and category resolution
└── tools/
    ├── search-patterns.ts      # search_patterns tool
    ├── get-pattern-details.ts  # get_pattern_details tool
    ├── yarns.ts                # search_yarns and get_yarn_details tools
    ├── find-yarns-for-pattern.ts # find_yarns_for_pattern tool
    ├── find-yarn-shops.ts      # find_yarn_shops tool
    └── format.ts               # Shared formatting helpers
test/                           # Vitest tests (in-process MCP client, mocked Ravelry API)
scripts/
├── smoke.ts                    # Live end-to-end check over stdio
└── pack-mcpb.ts                # MCP Bundle packaging
manifest.json                   # MCP Bundle manifest

Adding a tool

  1. Create src/tools/<name>.ts exporting register<Name>(server, ravelry) that calls server.registerTool() with a title, a description written for the model, a zod inputSchema (use .describe() on every field), an outputSchema, and annotations.

  2. Register it in src/server.ts and list it in manifest.json.

  3. Add a test in test/server.test.ts.

License

MIT, see LICENSE.

📜 Project Overview

Ravelry MCP Server turns AI assistants like Claude and ChatGPT into a knitting and crochet companion, with Ravelry as the backbone. It searches patterns and yarns, reads and updates a maker's own stash, queue and projects through "Sign in with Ravelry", does every crafting calculation exactly, and shows interactive widgets in the chat: a photo carousel of patterns and a row counter. A hosted instance runs at ravelry-mcp.gonz-paul.dev.

🎯 Key Features

  • Pattern search by technique, yarn weight, yardage, difficulty and fit, shown as a photo carousel with 👍/👎 feedback the assistant uses to refine the next search

  • Personal Ravelry data through OAuth: stash, queue, projects, favorites, library and needles, with project tracking that keeps the stash accurate

  • Exact calculators the assistant calls instead of guessing: gauge adjustment, even increases and decreases, yarn quantities, grams ↔ meters, and a stitch counter that checks written pattern rows

  • Planning from the user's own data: finish-date predictions from their pace, shopping lists after the stash, queue and stash check-ups, pattern suggestions to learn new skills

  • Interactive row counter widget with instant taps saved server-side, for Ravelry projects or anything else

  • Metric or imperial preference, US/UK terminology, needle size and yarn weight conversions

🛠️ Technology Stack

  • TypeScript

  • Node.js

  • Model Context Protocol (MCP) TypeScript SDK v2

  • MCP Apps (interactive widgets)

  • OAuth 2.1 (oidc-provider, PKCE, dynamic client registration)

  • SQLite with AES-256-GCM encryption

  • Zod

  • Vite

  • Vitest

  • Docker and Cloudflare Tunnel

  • Ravelry API

Available Tools

13 tools
adjust_for_gaugeAdjust a pattern to my gaugeA
Read-onlyIdempotent

Compares the user's swatch with a pattern's gauge: whether to change needles, how big the piece comes out if they follow the pattern as written, and pattern numbers (cast-on, stitch counts, rows) recalculated for their gauge so the size stays right. Give the pattern gauge, or a pattern_id to read it from Ravelry.

Inputs: my_gauge (required), counts, pattern_id, measurements, +2 more. Returns: notes, pattern, verdict, needle_advice, +7 more

convert_yarn_amountGrams ↔ meters ↔ yardsA
Read-onlyIdempotent

Converts an amount of yarn between grams and length (meters/yards) and skeins, e.g. "I have 200 g of Rios" or "how many grams is 300 m of DK?". Uses the yarn's own skein data (yarn_id) when given, else a typical ratio for the yarn weight (an estimate). Yarn is sold by weight in much of the world, but patterns need a length.

Inputs: grams, yards, meters, weight, +1 more. Returns: note, yarn, grams, yards, +3 more

count_stitchesCheck stitch countsA
Read-onlyIdempotent

Reads written knitting or crochet instructions row by row ("*k2, p2; rep from * to last 2 sts, k2", "(sc, inc) x 6 (18)") and counts the stitches each step uses and makes. Flags rows that do not use every stitch and counts that differ from the one printed in the pattern. Use it to walk someone through a row or to check a pattern for errors.

Inputs: rows (required), craft, stitches_before. Returns: rows, problems

crafting_referenceKnitting and crochet referenceA
Read-onlyIdempotent

Reference tables: needle and hook sizes (metric, US, UK, Japanese), yarn weights across regions (US worsted = UK aran = AU 10 ply, with typical needles and gauge), US↔UK crochet and knitting terms (UK "dc" is US "sc"!), and standard abbreviations. Use lookup to find one entry, e.g. "4mm", "US 8", "H", "DK", "8 ply", "ssk", "htr".

Inputs: topic (required), craft, lookup. Returns: rows, notes, topic

find_yarns_for_patternFind yarns for a patternA
Read-onlyIdempotent

Yarn substitution: lists the yarns other Ravelry users actually used to make a pattern, ranked by how many projects used each one, next to the yarn weight, yardage and gauge the pattern calls for and the yarns its designer suggested.

Inputs: pattern_id (required), limit, same_weight_only, include_discontinued. Returns: yarns, pattern, total_yarns_used

find_yarn_shopsFind yarn shopsA
Read-onlyIdempotent

Find local yarn shops from Ravelry's shop directory, either around a point (latitude/longitude + radius, nearest first) or by shop name or city. For "near me" or "in ", prefer coordinates: use the coordinates of the place the user names.

Inputs: page, query, units, radius, +3 more. Returns: page, shops, units, page_count, +1 more

get_pattern_detailsGet Ravelry pattern detailsA
Read-onlyIdempotent

Get full details for one or more Ravelry patterns by id: designer, price, difficulty, rating, yarn weight, yardage, gauge, needle/hook sizes, sizes, techniques, crochet terminology (US/UK), and the designer notes.

Inputs: ids (required). Returns: patterns, missing_ids

get_yarn_detailsGet Ravelry yarn detailsA
Read-onlyIdempotent

Get full details for one or more yarns by id: fiber content, recommended needles and hooks, gauge, care, texture, color/dye attributes, where it is made, and notes.

Inputs: ids (required). Returns: yarns, missing_ids

match_yarnsMatch yarns to RavelryA
Read-onlyIdempotent

Finds the Ravelry yarn behind text read from a ball band, receipt or invoice. Pass one item per yarn with the raw label plus whatever you could read (brand, name, weight, fiber, yards/meters and grams per skein). Returns the best match with a confidence and alternatives; use the yarn ids with add_to_my_stash or get_yarn_details.

Inputs: items (required). Returns: matches

search_patternsSearch Ravelry patternsA
Read-onlyIdempotent

Search the Ravelry pattern database by keyword and filters: craft, category, yarn weight, yardage, difficulty, fit, techniques and construction (attributes), language, designer and price. Returns a page of matches; call get_pattern_details with the ids for yarn, gauge, needles and notes.

Inputs: fit, page, sort, craft, +12 more. Returns: page, units, category, patterns, +3 more

search_yarnsSearch Ravelry yarnsA
Read-onlyIdempotent

Search the Ravelry yarn database by name, weight, fiber and attributes (superwash, hand-dyed, self-striping...). Excludes discontinued yarns unless asked. Returns yardage and grams per skein, washability and rating for each match.

Inputs: page, sort, fiber, query, +4 more. Returns: page, yarns, page_count, total_results

spread_evenlyIncrease or decrease evenlyA
Read-onlyIdempotent

Spaces increases or decreases evenly across a row or round, e.g. "increase 13 stitches evenly across 97": returns the exact written instruction. Knitting uses M1 / k2tog, crochet uses 2 sts in one / sc2tog.

Inputs: change (required), stitches (required), craft, stitch, +1 more. Returns: steps, instructions, stitches_after, stitches_before

yarn_neededHow much yarn to buyA
Read-onlyIdempotent

Works out how many skeins to buy for a pattern with a given yarn, with a safety margin. Reads the yardage from a Ravelry pattern (smallest and largest size) and the skein length from a Ravelry yarn, or takes the numbers directly. Can account for a gauge difference or a bigger size (scale).

Inputs: scale, yarn_id, pattern_id, pattern_yards, +3 more. Returns: yarn, notes, options, pattern, +1 more

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 13 tools

    Disambiguation4/5

    Most tools have clearly distinct purposes, but there is mild overlap in the yarn-finding cluster (search_yarns vs match_yarns vs find_yarns_for_pattern) and in the amount calculators (yarn_needed vs convert_yarn_amount). The descriptions do a good job of drawing boundaries, so an agent can mostly select correctly.

    Naming Consistency4/5

    The set predominantly follows a verb_noun snake_case pattern (search_patterns, get_yarn_details, find_yarn_shops, adjust_for_gauge, convert_yarn_amount). A few noun-phrase outliers (yarn_needed, crafting_reference) slightly break the convention but remain clear and readable.

    Tool Count5/5

    13 tools is well-scoped for a domain that spans pattern search, yarn search, substitution, gauge math, stitch counting, and reference lookups. Each tool earns its place without redundancy.

    Completeness4/5

    The surface covers the core crafting workflow (search/details for patterns and yarns, substitution, gauge adjustment, calculators, shops, reference tables) with no obvious functional dead ends. Minor gaps exist: it references an add_to_my_stash tool that is not part of the set, and stash/project/favorites management is absent.

    Maintenance

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      A Model Context Protocol server that enables AI assistants to perform real-time web searches, retrieving up-to-date information from the internet via a Crawler API.
      1
      76 npm
      42
      ISC
    • A
      license
      A
      quality
      B
      maintenance
      A Model Context Protocol server that provides real-time web search capabilities to AI assistants through pluggable search providers, currently integrated with the Brave Search API.
      5
      34 npm
      16
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      A Model Context Protocol (MCP) server for the Open Library API that enables AI assistants to search for book information.
      7
      164 npm
      102
      MIT