pyrox-client 0.2.4__tar.gz → 0.2.5__tar.gz

{pyrox_client-0.2.4 → pyrox_client-0.2.5}/.gitignore

@@ -13,6 +13,7 @@ dist/
 .idea/
 
 docs/issues/
+docs/PROJECT_STATE.md
 
 ui/.env.capacitor
 ui/.env

pyrox_client-0.2.5/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Vlad Matei
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

{pyrox_client-0.2.4 → pyrox_client-0.2.5}/PKG-INFO

@@ -1,8 +1,10 @@
 Metadata-Version: 2.4
 Name: pyrox-client
-Version: 0.2.4
+Version: 0.2.5
 Summary: HYROX race data client – retrieve full race results via Python
 Author: Vlad Matei
+License-Expression: MIT
+License-File: LICENSE
 Requires-Python: >=3.12
 Requires-Dist: fsspec>=2024.2.0
 Requires-Dist: httpx>=0.28.1
@@ -11,6 +13,8 @@ Requires-Dist: pyarrow>=22.0.0
 Provides-Extra: api
 Requires-Dist: duckdb>=1.4.3; extra == 'api'
 Requires-Dist: fastapi>=0.115.0; extra == 'api'
+Requires-Dist: limits>=3.0; extra == 'api'
+Requires-Dist: mcp>=1.2.0; extra == 'api'
 Requires-Dist: numpy>=1.26.4; extra == 'api'
 Requires-Dist: uvicorn[standard]>=0.30.0; extra == 'api'
 Provides-Extra: reporting
@@ -40,7 +44,8 @@ or
 pip install pyrox-client
 ```
 
-Reporting helpers that read the generated DuckDB database are optional:
+DuckDB-backed reporting helpers are optional. The extra installs the DuckDB
+Python library, but it does not bundle a database file:
 
 ```bash
 pip install "pyrox-client[reporting]"
@@ -110,17 +115,63 @@ except RaceNotFound as exc:
 
 ## Reporting Helpers
 
-The base install keeps the public client lightweight. Install the reporting extra
-before using `ReportingClient`:
+The base install keeps the public client lightweight. `ReportingClient` requires
+`pyrox-client[reporting]` and a local DuckDB database path; the package does not
+ship the generated database artifact.
 
 ```python
 from pyrox.reporting import ReportingClient
+
+reporting = ReportingClient(database="/path/to/pyrox_duckdb")
+```
+
+## MCP Server
+
+The hosted reporting service exposes a read-only MCP server over streamable HTTP at
+`https://pyrox-api.fly.dev/mcp/`. It lets Claude answer natural-language questions
+against the HYROX dataset through a small set of intent-shaped tools:
+`list_filters`, `find_athlete`, `get_distribution`, `get_rankings`,
+`get_race_report`, `get_deepdive`, and `get_athlete_profile`.
+
+Add it to Claude Code with the `claude mcp add` command:
+
+```bash
+claude mcp add --transport http pyrox https://pyrox-api.fly.dev/mcp/
+```
+
+Then verify the connection:
+
+```bash
+claude mcp list
+```
+
+By default this registers the server at the local (project) scope. Use
+`--scope user` to make it available across all your projects:
+
+```bash
+claude mcp add --transport http --scope user pyrox https://pyrox-api.fly.dev/mcp/
+```
+
+To remove it:
+
+```bash
+claude mcp remove pyrox
 ```
 
+### Claude web and Desktop
+
+Pyrox also works as a custom connector in the Claude web app and Claude Desktop
+(paid plans). Go to **Settings -> Connectors -> Add custom connector**, set the
+name to `Pyrox` and the URL to `https://pyrox-api.fly.dev/mcp/`, and click
+**Add**. The server is open and read-only, so it connects without a sign-in step.
+
+For example prompts, tool semantics, and caveats, see `docs/mcp.md`.
+
 ## Documentation
 
 - Live docs: https://vmatei2.github.io/pyrox-client/
 - Client API: `docs/api.md`
+- MCP guide: `docs/mcp.md`
 - Error model: `docs/errors.md`
 - Filters and usage notes: `docs/filters.md`
 
@@ -146,6 +197,10 @@ Maintainer-only operational docs:
 - `docs/maintainers/release.md`
 - `docs/maintainers/reporting-service.md`
 
+## License
+
+Released under the [MIT License](LICENSE) — free to use, modify, and distribute. Copyright (c) 2026 Vlad Matei.
+
 ## Disclaimer
 
 Pyrox is an independent project and is not affiliated with, endorsed, or sponsored by HYROX.

{pyrox_client-0.2.4 → pyrox_client-0.2.5}/README.md

@@ -20,7 +20,8 @@ or
 pip install pyrox-client
 ```
 
-Reporting helpers that read the generated DuckDB database are optional:
+DuckDB-backed reporting helpers are optional. The extra installs the DuckDB
+Python library, but it does not bundle a database file:
 
 ```bash
 pip install "pyrox-client[reporting]"
@@ -90,17 +91,63 @@ except RaceNotFound as exc:
 
 ## Reporting Helpers
 
-The base install keeps the public client lightweight. Install the reporting extra
-before using `ReportingClient`:
+The base install keeps the public client lightweight. `ReportingClient` requires
+`pyrox-client[reporting]` and a local DuckDB database path; the package does not
+ship the generated database artifact.
 
 ```python
 from pyrox.reporting import ReportingClient
+
+reporting = ReportingClient(database="/path/to/pyrox_duckdb")
+```
+
+## MCP Server
+
+The hosted reporting service exposes a read-only MCP server over streamable HTTP at
+`https://pyrox-api.fly.dev/mcp/`. It lets Claude answer natural-language questions
+against the HYROX dataset through a small set of intent-shaped tools:
+`list_filters`, `find_athlete`, `get_distribution`, `get_rankings`,
+`get_race_report`, `get_deepdive`, and `get_athlete_profile`.
+
+Add it to Claude Code with the `claude mcp add` command:
+
+```bash
+claude mcp add --transport http pyrox https://pyrox-api.fly.dev/mcp/
+```
+
+Then verify the connection:
+
+```bash
+claude mcp list
+```
+
+By default this registers the server at the local (project) scope. Use
+`--scope user` to make it available across all your projects:
+
+```bash
+claude mcp add --transport http --scope user pyrox https://pyrox-api.fly.dev/mcp/
+```
+
+To remove it:
+
+```bash
+claude mcp remove pyrox
 ```
 
+### Claude web and Desktop
+
+Pyrox also works as a custom connector in the Claude web app and Claude Desktop
+(paid plans). Go to **Settings -> Connectors -> Add custom connector**, set the
+name to `Pyrox` and the URL to `https://pyrox-api.fly.dev/mcp/`, and click
+**Add**. The server is open and read-only, so it connects without a sign-in step.
+
+For example prompts, tool semantics, and caveats, see `docs/mcp.md`.
+
 ## Documentation
 
 - Live docs: https://vmatei2.github.io/pyrox-client/
 - Client API: `docs/api.md`
+- MCP guide: `docs/mcp.md`
 - Error model: `docs/errors.md`
 - Filters and usage notes: `docs/filters.md`
 
@@ -126,6 +173,10 @@ Maintainer-only operational docs:
 - `docs/maintainers/release.md`
 - `docs/maintainers/reporting-service.md`
 
+## License
+
+Released under the [MIT License](LICENSE) — free to use, modify, and distribute. Copyright (c) 2026 Vlad Matei.
+
 ## Disclaimer
 
 Pyrox is an independent project and is not affiliated with, endorsed, or sponsored by HYROX.

{pyrox_client-0.2.4 → pyrox_client-0.2.5}/pyproject.toml

@@ -8,6 +8,8 @@ dynamic = ["version"]
 description = "HYROX race data client – retrieve full race results via Python"
 authors = [{ name = "Vlad Matei" }]
 readme = {file="README.md", content-type = "text/markdown" }
+license = "MIT"
+license-files = ["LICENSE"]
 requires-python = ">=3.12"
 dependencies = [
     "pandas>=2.3.3",
@@ -26,16 +28,12 @@ reporting = [
 api = [
     "duckdb>=1.4.3",
     "fastapi>=0.115.0",
+    "limits>=3.0",
+    "mcp>=1.2.0",
     "numpy>=1.26.4",
     "uvicorn[standard]>=0.30.0",
 ]
 
-# classifiers = [
-#   "Programming Language :: Python :: 3.12",
-#   "License :: OSI Approved :: MIT License",
-#   "Operating System :: OS Independent",
-# ]
-
 # urls."Homepage" = "https://github.com/vmatei2/pyrox-client"
 # urls."Issues"   = "https://github.com/vmatei2/pyrox-client/issues"
 

{pyrox_client-0.2.4 → pyrox_client-0.2.5}/src/pyrox/__init__.py

@@ -3,7 +3,7 @@
 from .core import PyroxClient
 from .errors import AthleteNotFound, PyroxError, RaceNotFound
 
-__version__ = "0.2.4"
+__version__ = "0.2.5"
 
 
 __all__ = [