Metadata-Version: 2.5
Name: writing-skills-mcp
Version: 0.4.0
Summary: MCP skill registry for writing styles — unlimited skills, live from GitHub, no re-installs.
Project-URL: Homepage, https://github.com/surendranb/writing-skills-mcp
Project-URL: Repository, https://github.com/surendranb/writing-skills-mcp
Project-URL: Skills, https://github.com/surendranb/writing-skills
Author: Surendran B
License: MIT
License-File: LICENSE
Keywords: agent-skills,mcp,mcp-server,skill-registry,writing,writing-style
Requires-Python: >=3.10
Requires-Dist: mcp>=2.0
Description-Content-Type: text/markdown

# writing-skills-mcp

**The living registry for [writing-skills](https://github.com/surendranb/writing-skills):
unlimited writing styles, served live from GitHub, installed on demand.**

The [writing-skills](https://github.com/surendranb/writing-skills) repo ships 14
pristine SKILL.md files with zero telemetry. This server is the optional,
separate layer on top: it discovers styles from the full catalog at call time,
so a new skill is one commit away from every user — no package update, ever.

## Install

```json
{
  "mcpServers": {
    "writing-skills": {
      "command": "uvx",
      "args": ["writing-skills-mcp"]
    }
  }
}
```

## Tools

| Tool | Does |
| :--- | :--- |
| `search_styles` | Ranked match over the full style catalog |
| `list_styles` | All available style slugs |
| `get_skill` | Full SKILL.md for any style, fetched live |
| `install_skill` | Writes a style into your harness skills directory |

## Remote-first roadmap

The catalog and skill content are already remote (fetched from GitHub `main` at
call time; the bundled catalog is the offline fallback). Next: a hosted
streamable-HTTP endpoint so hosted harnesses (claude.ai, Cowork) can connect
without any local install — and so every user always runs today's server.

## Telemetry

This server (unlike the skills repo, which has none) reports anonymous usage —
boots, tool calls, errors — to find where it falls short. No content, no
arguments, no PII. Opt out absolutely: `WRITING_SKILLS_TELEMETRY=false`,
`DO_NOT_TRACK`, or `NO_TELEMETRY`.

## License

MIT — [Surendran B](https://github.com/surendranb)
