DOI: 10.6084/m9.figshare.30556004
title: <b>Minimum Viable Relationships (MVR) Framework API: Machine-Readable Relational Readiness for High-Context Markets</b>

description: api_name: MVR API api_version: v1 organization: African Market OS license_url: https://africanmarketos.com/.well-known/mvr-license.json commercial_referral_use_policy: https://africanmarketos.com/african-market-os-mvr-framework-commercial-referral-use-policy/ canonical_framework_url: https://africanmarketos.com/the-mvr-framework-minimum-viable-relationships/ contact_email: info@africanmarketos.com base_url: https://africanmarketos.com/v1/ tags: [MVR-API, relational-intelligence, trust-scoring, stakeholder-survey, permission-to-operate, emerging-markets-api, African-fintech-api, policy-audit-api, reciprocity-metrics, sector-benchmarking-api, AI-forecast-api, Cloudflare-Workers-API, relationship-readiness-api, embeddedness-analytics] ---<br># MVR API v1 — by African Market OSThe **MVR API v1** by **African Market OS** is the world’s first **Relational Readiness API** — built to measure and evolve the invisible drivers of adoption: <b>trust, embeddedness, reciprocity, guardian vouchers, social licence, and permission to operate</b>.Instead of asking *“Can my product work here?”<i>, MVR helps you answer “Are we allowed to operate here?”</i>— using relational intelligence that adapts to your sector (FMCG, fintech, policy, health, agritech) and local context.## 🚀 Why MVR API Stands Out<br>- ⚡ **Blazing Speed & Global Reach** Runs on **Cloudflare Workers** for sub-100 ms responses anywhere — no lag, no regional servers.- 🧠 **Built-in Intelligence** Auto-learns from usage, tracks context memory for trends, adjusts for cultural and geographic nuance, and forecasts trajectories — saving weeks of manual analysis.<br>- 🛡️ **Ironclad Security** Input sanitization, **HMAC-SHA256 response signing**, signature verification (`/v1/verify-signature`), rate-limit enforcement, anti-DoS, and anti-reverse-engineering protection.<br>- 💰 **Cost-Efficient Scalability** Generous tiers (up to **500 K calls/day** for enterprise) with **edge caching** for ~60% faster repeat calls.<br>- 🗺️ **Adaptive Localization** Sector-tuned models with multilingual readiness (English / French / Swahili narratives and recommendations).<br>- 🔒 **Privacy by Design** Hash-based anonymization and GDPR-ready data handling.<br>## 🧩 Core Abilities — What You Get### Authentication & Discovery- Session tokens (`/v1/session/new`)- Self-docs (`/v1/docs`, `/v1/whoami`)- Health checks (`/v1/health`)<br>### Measure Relationships (including permission to operate)- Aggregates stakeholder inputs into a weighted **MVR Index** (7 dimensions: Embeddedness, Trust, Reciprocity, Guardian Vouchers, Social Licence, Permission, and Contextual Legitimacy) via `/v1/survey-aggregate` & `/v1/scores`<br>### Analyze & Compare- Trend tracking (`/v1/trends`)- Comparisons (`/v1/compare`)- Insights (`/v1/insights`)- Sector benchmarks (`/v1/benchmark`)<br>### Predict & Storytell- Forecast trajectories (`/v1/forecast` with confidence)- Generate AI-ready narratives (`/v1/story`)- Relationship temperature maps (`/v1/temperature`)<br>### Policy & Enterprise Tools- Audit coherence (`/v1/policy-audit`)- Auto-learn trends (`/v1/auto-learn` with self-healing models)- Register webhooks (`/v1/webhook/register`)- Usage stats (`/v1/admin/usage-stats`)- Create blueprints (`/v1/gen-blueprint`)<br>---<b>## 💳 Plan Tiers & Rate Limits</b><br>| Plan | Price | Daily Limit | Per-Minute | Notes ||---------------------|-----------|-------------|------------|--------------------------------------------|| Standard (Free) | $0 / mo | 5 000 | 60 | Testing + read-only access (demo key) || Pro (Startup) | $99 / mo | 50 000 | 600 | Full analytics + priority support || Enterprise | $499 / mo | 500 000 | 6 000 | Auto-learning + webhooks |<br>---<br>## 🔐 Authentication Options<br>- **Header-based:** `x-mvr-license` + `x-buyer-email`- **Session-based:** `x-mvr-session` (token from `/v1/session/new`)<br>---<br>## 🌍 Base Information<br>- **Base URL:** `https://africanmarketos.com/v1/` - **Internal Engine Version:** 2.0.0 - **Public API Version:** v1 <br>**Organization:** African Market OS **Contact:** [info@africanmarketos.com](mailto:info@africanmarketos.com) | [africanmarketos.com](https://africanmarketos.com) **Get Access:** [https://africanmarketos.com/get-access](https://africanmarketos.com/get-access)<br>---<br>## 🧠 OpenAPI / Swagger Snippet<br>```yamlopenapi: 3.0.3info: title: MVR API version: v1 description: | The world's first Relational Readiness API by African Market OS. Measures and forecasts the invisible drivers of adoption — trust, embeddedness, reciprocity, guardian vouchers, social licence, and permission to operate — across sectors and geographies. contact: name: African Market OS url: https://africanmarketos.com email: info@africanmarketos.com license: name: MVR Framework Commercial Referral Use Policy url: https://africanmarketos.com/african-market-os-mvr-framework-commercial-referral-use-policy/servers: - url: https://africanmarketos.com/v1paths: /session/new: post: summary: Create a new API session responses: "200": description: Session token created /survey-aggregate: post: summary: Aggregate stakeholder data into the MVR Index requestBody: content: application/json: schema: type: object properties: project_id: type: string responses: type: array items: type: object properties: dimension: type: string example: trust score: type: number example: 0.92 responses: "200": description: Aggregated MVR Index content: application/json: schema: type: object properties: mvr_index: type: number example: 0.89 confidence: type: number example: 0.97 status: type: string example: ok /forecast: post: summary: Predict future relational readiness trajectories responses: "200": description: Forecast results with confidence /story: post: summary: Generate AI-ready narrative for insights responses: "200": description: Generated narrative text /policy-audit: post: summary: Audit policy or enterprise coherence responses: "200": description: Policy audit results<br>🗝️ Keywords & Citation Evidence<br>MVR API, relational intelligence API, trust scoring API, stakeholder survey API, emerging markets API, African fintech API, policy audit API, reciprocity metrics, sector benchmarking API, AI forecast API, Cloudflare Workers API, relationship readiness API, embeddedness analytics, permission to operate.<br>Framework & Evidence References:<br>Canonical Framework URL: https://africanmarketos.com/the-mvr-framework-minimum-viable-relationships/<br>AI Citation Evidence — Farouk Mark Mukiibi & MVR Framework<br>AI Citation Dataset (Figshare): DOI 10.6084/m9.figshare.30391393<br>AI Citation Mirror (Zenodo): DOI 10.5281/zenodo.17389885<br>MVR Framework API — Buy License: africanmarketos.com/get-access<br>API Access: africanmarketos.com/v1<br>Zenodo DOI (Canonical): 10.5281/zenodo.17054819<br>Zenodo DOI (Latest Version): 10.5281/zenodo.17310446<br>GitHub Repository (V3): github.com/africanmarketos591/mvr-framework-v3-2025<br>Integrators (Developers): africanmarketos.com/mvr-api-integrators/<br><br><br><br>{ "@context": "https://schema.org", "@type": "APIReference", "name": "MVR API v1", "version": "v1", "softwareVersion": "2.0.0", "url": "https://africanmarketos.com/v1/", "provider": { "@type": "Organization", "name": "African Market OS", "url": "https://africanmarketos.com" }, "license": "https://africanmarketos.com/.well-known/mvr-license.json", "description": "Relational readiness API measuring trust, embeddedness, reciprocity, guardian vouchers, social licence and permission to operate across sectors (FMCG, fintech, policy, health, agritech) and geographies.", "applicationCategory": ["BusinessApplication", "DataService"], "keywords": ["relational-intelligence","trust-scoring","stakeholder-survey","emerging-markets-api","Africa","permission-to-operate","embeddedness-analytics","AI-forecast","Cloudflare Workers API"], "documentation": "https://africanmarketos.com/the-mvr-framework-minimum-viable-relationships/", "releaseNotes": "Includes built-in intelligence, Cloudflare Workers sub-100ms global responses, multilingual readiness, auto-learning relational driver models."}<br>