npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@reneturcios/kidsweek

v0.1.0

Published

Things to do with kids 0-6, city by city: a local bridge to the Littles Weekly catalogue of weekly picks, pages, dated outings and search. One bin serves a small CLI and the MCP server.

Readme

kidsweek

A family week, planned city by city. kidsweek is a local forwarding client for the hosted Littles Weekly MCP service: it answers tools/list on your own machine from the captured tool definitions and forwards every lookup to Littles Weekly, returning the results exactly as the service sends them back.

The surface is read-only editorial data for families with children aged 0–6: the cities the catalogue covers, the pages each city carries, the full contents of a page, dated outings, and keyword search across cards, outings and FAQs. Nothing is cached, stored or computed locally — the package is a pipe, not a catalogue.

The tools

  • list_cities — Every city Littles Weekly covers, with its slug, current week, last-checked date and the pages it has. Call this first if you are not sure of a slug. No arguments.
  • list_pages — The pages for one city (or "site" for site-wide pages), with each page's URL, last-checked date, section headings and counts of FAQs and cards. city is required.
  • get_page — Everything on one page, in reading order: sections, every card's official link and checked date, and the page FAQ. city is required; page defaults to "this-week", section narrows to one heading, and format chooses "structured" (default) or "markdown".
  • get_events — Dated outings for kids 0–6 in one city, from this week's list plus dated listings on the seasonal and free pages. city is required; start_date / end_date bound the range, free_only and indoor_only filter, age keeps outings whose age range includes the child, and limit caps the results (1–100, default 40).
  • search — Keyword search across every card, outing and FAQ, in one city or all of them. query is required (2–200 characters); city narrows the search and limit caps the results (1–50, default 15).

Install and run

As an MCP server via npm:

npx -y @reneturcios/kidsweek mcp

MCP client configuration:

{
  "mcpServers": {
    "kidsweek": {
      "command": "npx",
      "args": ["-y", "@reneturcios/kidsweek", "mcp"]
    }
  }
}

As a container:

docker run -i ghcr.io/cloudcorprecords/kidsweek
docker run --rm ghcr.io/cloudcorprecords/kidsweek list_cities '{}'

CLI

One binary serves both the command line and the MCP server. Each tool is a subcommand taking a single JSON string with that tool's arguments:

kidsweek list_cities '{}'
kidsweek list_pages '{"city":"omaha"}'
kidsweek get_page '{"city":"omaha","page":"this-week"}'
kidsweek get_events '{"city":"omaha","free_only":true}'
kidsweek search '{"query":"Santa breakfast"}'
kidsweek --version

Exit codes: 0 when the forwarded call succeeds, 1 when the upstream result is an error, and 2 for usage problems such as an unknown subcommand or a malformed JSON argument.

Configuration

  • LITTLESWEEKLY_MCP_URL — Overrides the upstream endpoint. The default is the pinned hosted endpoint, https://littlesweekly.com/mcp. (The override variable is a reconstruction added by this rebuild.)

The Littles Weekly registry record declares no headers on its remote, so kidsweek sends no authentication header of any kind — lookups are keyless.

Upstream failures — a JSON-RPC error from the service, a non-2xx response, an unreadable body, or a request that fails outright — are reported to the caller as an error result whose text starts with kidsweek error:.

How forwarding works

The first forwarded call opens a session: an initialize request (protocol version 2025-03-26), followed by a notifications/initialized notification, then the tools/call itself. If the service answers the initialize request with an Mcp-Session-Id header, that value is carried on every later request, and the open session is reused for the rest of the process. Replies are accepted either as plain JSON or as server-sent events. Successful results pass through verbatim, including any isError flag and any extra fields the service includes.

Development

npm install
npm run build   # tsc -> dist/ (dist/cli.js is the bin)
npm test        # tsx --test test/*.test.ts — stubbed upstream, no network
npm run dev     # run the CLI from source

The test suite checks the served tool list against the captured surface, exercises the session handshake and its reuse, asserts that no Authorization header is sent under any environment, and verifies that arguments go upstream untouched and results come back untouched.

License

MIT — see LICENSE. Copyright (c) 2026 Rene Turcios.