Metadata-Version: 2.4
Name: esheria
Version: 0.1.0
Summary: Installable CLI and MCP tools for the Esheria Regulatory Pack API.
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Office/Business
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Requires-Dist: httpx<1.0,>=0.27
Requires-Dist: pydantic<3.0,>=2.8
Requires-Dist: PyYAML<7.0,>=6.0
Provides-Extra: dev
Requires-Dist: pytest<9.0,>=8.2; extra == "dev"

# Esheria CLI And MCP

Installable command-line and MCP tools for the Esheria Regulatory Pack API.

The package exposes two commands:

```bash
esheria --help
esheria-mcp --help
```

## Install

```bash
pip install esheria
pipx install esheria
uvx --from esheria esheria health --format json
```

## Configure

```bash
export ESHERIA_API_BASE_URL="http://20.57.20.184:8080"
export ESHERIA_API_KEY="<client-api-key>"
export ESHERIA_DEFAULT_PACK_ID="KE-DATA-PROTECTION"
```

Do not commit API keys. The CLI and MCP server read credentials from
environment variables or command-line flags and redact API key values from
diagnostic output.

## CLI Smoke Test

```bash
esheria health --format json
esheria ready --format json
esheria packs list --format json
esheria packs inspect KE-DATA-PROTECTION --format json
esheria obligations list KE-DATA-PROTECTION --query breach --limit 3 --format json
```

## MCP Server

Run the stdio MCP server:

```bash
esheria-mcp serve --stdio
```

The MCP server is read-only and exposes Regulatory Pack API tools for health,
readiness, pack discovery, obligations, applicability, claim verification,
filing calendars, evidence registers, relationship graph queries, exports, and
citation context lookup.
