Metadata-Version: 2.4
Name: mvr-agent-sdk
Version: 0.1.0
Summary: Public-safe MVR API preflight wrapper for AI agents.
Author-email: African Market OS <info@africanmarketos.com>
License-Expression: LicenseRef-MVR-Agent-SDK
Project-URL: Homepage, https://africanmarketos.com/agent-sdk
Project-URL: Repository, https://github.com/africanmarketos591/mvr-framework
Project-URL: Documentation, https://africanmarketos.com/docs/agent-sdk.md
Keywords: mvr,minimum viable relationships,african market os,ai agents,market entry,relational readiness
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE.md
Dynamic: license-file

# MVR Agent SDK for Python

Public-safe wrapper for calling the MVR API before an AI agent recommends market entry, MVP launch, funding, partnership, scale, CFO action, or due diligence in African and other high-context markets.

The SDK does not contain MVR scoring logic, calibration weights, private labels, private evidence, Worker source, or benchmark answer keys. It routes requests to the live MVR API, where protected computation remains server-side.

## Install

```bash
pip install mvr-agent-sdk
```

## Quickstart

```python
from mvr_agent_sdk import MvrPreflightClient

mvr = MvrPreflightClient(api_key="mvr-demo-key-2026")

result = mvr.preflight_market_entry({
    "company_name": "Example Retail Venture",
    "country": "KE",
    "sector": "retail",
    "case_type": "market_entry",
    "stakeholder_scope": ["consumer", "retailer", "guardian"],
    "evidence_pack": [],
})

print(result)
```

## Boundary

The public sandbox is for non-commercial evaluation only. Production, customer-facing, investor, accelerator, NGO, DFI, enterprise, consulting, or repeated automated use requires a licensed MVR API key from African Market OS.

No reverse engineering, scraping for model replication, or AI training on API outputs is authorized.

Docs: https://africanmarketos.com/agent-sdk

Contact: info@africanmarketos.com
