Metadata-Version: 2.5
Name: wire-band-mcp
Version: 0.1.0
Summary: Wire.Band MCP server — query compressed semantic telemetry (cache health, anomalies, drift) from any MCP-compatible AI client
Project-URL: Homepage, https://wire.band
Project-URL: Repository, https://github.com/maco144/wireband
Project-URL: Bug Tracker, https://github.com/maco144/wireband/issues
License: MIT
Keywords: ai-agent,iot,mcp,model-context-protocol,telemetry,wire.band
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: System :: Networking
Requires-Python: >=3.10
Requires-Dist: httpx>=0.24.0
Requires-Dist: mcp<3,>=2.0.0
Description-Content-Type: text/markdown

# wire-band-mcp

MCP (Model Context Protocol) server for Wire.Band. Query your compressed semantic telemetry —
cache health, compliance/anomaly status, semantic drift — from any MCP-compatible AI client
(Claude Desktop, Claude Code, or your own agent), without writing REST integration code.

Free tier: sign up for an API key at [wire.band](https://wire.band).

## Installation

```bash
pip install wire-band-mcp
```

Python 3.10+ required.

## Quick Start

### Claude Desktop / Claude Code

Add to your MCP server config:

```json
{
  "mcpServers": {
    "wire-band": {
      "command": "python",
      "args": ["-m", "wire_band_mcp"],
      "env": {"WIREBAND_API_KEY": "sk_..."}
    }
  }
}
```

### CLI

```bash
WIREBAND_API_KEY=sk_... wire-band-mcp
```

## Environment Variables

| Variable | Default | Description |
|---|---|---|
| `WIREBAND_API_KEY` | — | Your Wire.Band API key. Free tier available at wire.band. |
| `WIREBAND_API_URL` | `https://wire.band` | Backend URL — point at a self-hosted server if you run one. |
| `WIREBAND_MCP_TRANSPORT` | `stdio` | `stdio` \| `sse` \| `streamable-http` |

## Tools

- **`get_cache_stats()`** — semantic cache size, hit rate, per-domain breakdown
- **`get_anomaly_status(domain?, limit?)`** — recent compliance/anomaly events
- **`get_drift_score(domain?)`** — semantic drift score (KL divergence from baseline)

All three are read-only, scoped to your own account's data via your API key.

## What this doesn't expose

This server wraps derived, tenant-scoped signals only — never Wire.Band's theta symbol taxonomy,
frame format, or compression internals. It's a thin client, not a reimplementation.
