Skip to main content

signal-platform

Building blocks for derived-signal MCP services: services that periodically ingest public data, compute derived intelligence, and expose it to AI agents over MCP, with optional push notifications.

Used by trading-vol-regime. Architecture: docs/00-platform-architecture.md.

What's in it

Module Purpose
signal_platform.store SnapshotStore protocol + SQLite implementation. Calc workers are the only writers; MCP servers only read. Upserts on (service, kind, as_of) so re-runs are idempotent.
signal_platform.payload Response envelope: every payload carries as_of, a data_freshness label, attribution, and disclaimer.
signal_platform.push Subscriptions and delivery to ntfy topics or webhooks, with per-event cooldowns, auto-deactivation after repeated failures, and SSRF guards (public https targets only, redirects never followed).

Example

from datetime import UTC, datetime

import httpx
from signal_platform import SqliteSnapshotStore, envelope
from signal_platform.push import Notification, send

store = SqliteSnapshotStore("signals.db")
store.put("my-service", "snapshot", datetime.now(UTC), {"level": 42})

latest = store.get_latest("my-service", "snapshot")
payload = envelope(
    latest.payload,
    as_of=latest.as_of,
    attribution="Data from Example Source",
    disclaimer="Informational only.",
)

with httpx.Client() as client:
    send(
        client,
        "ntfy",
        "my-random-topic",
        Notification(key="demo", title="Hi", message="Signal changed"),
    )

License

MIT

Metadata

Release files for signal-platform 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for signal-platform 0.1.0
File Size Uploaded
signal_platform-0.1.0.tar.gz 9.2 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for signal-platform 0.1.0
File Interpreter ABI Platform
signal_platform-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 18.6 kB

Release files / signal_platform-0.1.0.tar.gz

Download URL signal_platform-0.1.0.tar.gz
Size 9.2 kB
Tags Source
SHA-256 checksum
How to use checksums
65b543af09ea66446bb46a5b4f49a578a2627a4964d915148bcae922e86ee072
BLAKE2b-256 checksum
How to use checksums
a13bb98d67b7e00c0df06aa84a01ad894e65625b879121f530dfd63dc0fc6eca
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 10, 2026.

Transparency log

Release files / signal_platform-0.1.0-py3-none-any.whl

Download URL signal_platform-0.1.0-py3-none-any.whl
Size 9.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
55d14f5802c77c04acb88470aa7c468bb02c2fed3af0990a86964a730f167619
BLAKE2b-256 checksum
How to use checksums
91ebf5a7bea6700037adfb1245efacd1350039da7d44bbf38bfbe33f2f45b36e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 10, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page