Metadata-Version: 2.4
Name: swisstip-calendar-connector
Version: 0.3.1
Summary: Swiss TIP calendar connector: dataset bundles of dated events by postal code, served to the MCP server over HTTP
Author: Alexander Bobrovsky
License-Expression: Apache-2.0
Project-URL: Homepage, https://github.com/swisstip/swiss-tip
Project-URL: Source, https://github.com/swisstip/swiss-tip
Project-URL: Issues, https://github.com/swisstip/swiss-tip/issues
Keywords: mcp,grounding,switzerland,open-data,connector
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.14
Requires-Python: >=3.14
Description-Content-Type: text/markdown
License-File: LICENSE
License-File: NOTICE
Requires-Dist: pydantic<3,>=2.11
Requires-Dist: starlette>=0.48
Requires-Dist: swisstip-core==0.3.1
Requires-Dist: uvicorn>=0.31.1
Dynamic: license-file

# swisstip-calendar-connector

**Last update:** 23 September 2026

The first dataset connector of Swiss TIP: a separate process that serves
dataset bundles of dated events by postal code, such as a city's
waste-collection calendars published as open data, to the Swiss TIP MCP
server over HTTP. The server registers each bundle behind the concept of
the knowledge release it stands behind, offers it on `resolve`, and
forwards the caller's `lookup`; this process answers from the rows it
carries, with the publisher, licence, source file hash and download date of
every dataset. It reaches no network at answer time and composes no
guidance.

```bash
swisstip-calendar-connector --datasets-dir datasets/<pack> --health
swisstip-calendar-connector --datasets-dir datasets/<pack> --host 127.0.0.1 --port 8100
swisstip-mcp --release releases/<pack>/release.json --connector http://127.0.0.1:8100
```

A bundle (`swiss-tip-dataset/v1`) is built from a curation file with
`swisstip-build-dataset` of the `swisstip-builder` distribution; the
datasets of the published packs live in the packs repository,
[swiss-tip-mvp](https://github.com/swisstip/swiss-tip-mvp). The contract
between the server and a connector (`swiss-tip-connector/v1`) and the
design are in the repository's
[docs/architecture/dataset-connectors.md](https://github.com/swisstip/swiss-tip/blob/main/docs/architecture/dataset-connectors.md).

Requires `swisstip-core` at the same version. Licence: Apache-2.0.
