Metadata-Version: 2.5
Name: medium-mcp
Version: 0.1.0
Summary: MCP server for the Medium publishing platform (posts, users, publications, tags)
Project-URL: Homepage, https://github.com/lesleslie/medium-mcp
Project-URL: Repository, https://github.com/lesleslie/medium-mcp
Author-email: Les Leslie <les@wedgwoodwebworks.com>
License-Expression: BSD-3-Clause
License-File: LICENSE
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.14
Requires-Python: >=3.14
Requires-Dist: fastmcp>=2.12.0
Requires-Dist: httpx2>=0.28.1
Requires-Dist: mcp-common>=0.18.0
Requires-Dist: oneiric>=0.16.0
Requires-Dist: pydantic-settings>=2.1.0
Requires-Dist: pydantic>=2.5.0
Provides-Extra: dev
Requires-Dist: bandit>=1.7.9; extra == 'dev'
Requires-Dist: mypy>=1.9.0; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
Requires-Dist: pytest-cov>=4.1.0; extra == 'dev'
Requires-Dist: pytest>=8.0.0; extra == 'dev'
Requires-Dist: ruff>=0.4.8; extra == 'dev'
Description-Content-Type: text/markdown

# medium-mcp

> **Scaffold status: PyPI name reservation.** This package is a placeholder scaffold to claim
> the `medium-mcp` name on PyPI. The MCP server is not yet implemented. See
> `docs/superpowers/plans/` for the implementation plan (TBD).

MCP server for the Medium publishing platform. Provides access to:

- **Posts** — fetch, list, and search user/author articles
- **Publications** — query stories from Medium publications
- **Users** — profile data, follower counts, author metadata
- **Tags** — topic-based content discovery

## Reserve the PyPI name

```bash
cd /Users/les/Projects/medium-mcp
uv build
uv publish  # uses UV_PUBLISH_TOKEN from env
```

The package name `medium-mcp` is currently free on PyPI (verified 2026-08-31).
Publishing a placeholder 0.1.0 release locks the name.

## Architecture (planned)

Mirrors the `raindropio-mcp` pattern in this ecosystem:

- `httpx2` for the Medium REST API client
- `fastmcp` for the MCP server surface
- `oneiric` for layered config (`settings/medium-mcp.yaml`, `local.yaml`, env vars)
- `mcp-common` for bootstrap, auth, health endpoints
- `pydantic`/`pydantic-settings` for typed config models

## Status

| Phase | State |
|---|---|
| PyPI name reservation | **pending** (run `uv publish`) |
| Spec / plan | not written |
| Implementation | not started |
| Tests | not started |

## License

BSD-3-Clause.