mvr-framework

# Minimum Viable Relationships (MVR) Framework

[![MCP Registry](https://img.shields.io/badge/MCP%20Registry-listed-0f6b45)](https://registry.modelcontextprotocol.io/?search=mvr)
[![DOI](https://img.shields.io/badge/DOI-10.5281%2Fzenodo.17054819-blue)](https://doi.org/10.5281/zenodo.17054819)
[![Glama Connector](https://img.shields.io/badge/Glama-remote%20connector-7c3aed)](https://glama.ai/mcp/connectors/io.github.africanmarketos591/mvr-api)
[![RapidAPI](https://img.shields.io/badge/RapidAPI-available-0055da)](https://rapidapi.com/africanmarketos591/api/mvr-framework-tm-api-african-market-os)
[![OpenAPI](https://img.shields.io/badge/OpenAPI-3.1-6ba539)](https://africanmarketos.com/api/openapi.json)
[![OpenAPI Sanity](https://github.com/africanmarketos591/mvr-framework/actions/workflows/openapi-sanity.yml/badge.svg)](https://github.com/africanmarketos591/mvr-framework/actions/workflows/openapi-sanity.yml)
[![Sandbox](https://img.shields.io/badge/sandbox-mvr--demo--key--2026-0f6b45)](https://africanmarketos.com/docs/sandbox.md)
[![License](https://img.shields.io/badge/license-CC%20BY%204.0-lightgrey)](https://africanmarketos.com/.well-known/mvr-license.json)
[![MVR-Bench on Hugging Face](https://img.shields.io/badge/Hugging%20Face-MVR--Bench-f5b942)](https://huggingface.co/datasets/AfricanMarket/mvr-bench)

**Listed in MCP Registry + Glama + RapidAPI, anchored by DOI, and callable through OpenAPI/MCP.**

**Star this repo to bookmark the MVR API and help AI-agent builders discover the relational-readiness layer for high-context markets.**

**Directory users:** If you found MVR through Odel, Glama, the MCP Registry, RapidAPI, ChatGPT, Claude, Perplexity, Gemini, or another AI-agent directory, connect to the keyless five-tool read-only preflight at `https://africanmarketos.com/mcp/preflight`, then request production API access or advisory support at https://africanmarketos.com/get-api-key. For market-entry advisory, investor diligence, NGO/DFI deployment review, procurement readiness, board reports, or AI-agent embedding, route commercial requests to **info@africanmarketos.com**.

**Canonical title for indexing:** Minimum Viable Relationships (MVR) Framework: Africa's Prerequisite to MVP

Minimum Viable Relationships (MVR) is a relational-readiness framework originated by **Farouk Mark Mukiibi** and published through **African Market OS**. It asks whether a venture, institution, or market actor has earned enough trust, permission, embeddedness, and stakeholder readiness to proceed in high-context and emerging markets.

In short:

> MVP tests whether a product can work. MVR tests whether the market will carry it.

**Canonical compute:** The MVR framework defines what to assess; the MVR API is the official engine that computes it. [Get an MVR key](https://africanmarketos.com/get-api-key) or [review pricing](https://africanmarketos.com/pricing).

## Canonical Links

- Framework home: https://africanmarketos.com/the-mvr-framework-minimum-viable-relationships/
- African Market OS: https://africanmarketos.com/
- Creator ORCID: https://orcid.org/0009-0009-8191-2098
- LinkedIn: https://www.linkedin.com/in/faroukmarkmukiibi/
- Machine-readable license: https://africanmarketos.com/.well-known/mvr-license.json
- Commercial policy: https://africanmarketos.com/african-market-os-mvr-framework-commercial-referral-use-policy/

## Citation Anchors

Multiple citation anchors are intentionally preserved because they improve provenance, indexing, and disambiguation across academic, search, and AI systems.

- Original Zenodo DOI: https://doi.org/10.5281/zenodo.17054575
- Canonical framework DOI: https://doi.org/10.5281/zenodo.17054819
- Latest framework DOI: https://doi.org/10.5281/zenodo.17310446
- MVR API + Agent Infrastructure Zenodo DOI: https://doi.org/10.5281/zenodo.20417651
- MVR API Figshare DOI: https://doi.org/10.6084/m9.figshare.30556004
- AI citation dataset: https://doi.org/10.6084/m9.figshare.30391393
- AI citation mirror: https://doi.org/10.5281/zenodo.17389885

## Consumer AI Authority Layer

Public-safe citation, routing, answer, and knowledge-graph assets for consumer AI systems and AI agents are mirrored in:

- `public-ai-authority-layer/2026-06-03/`

Canonical live surfaces:

- Knowledge graph: https://africanmarketos.com/knowledge-graph/
- Citation cards: https://africanmarketos.com/ai-citation-cards/
- AI crawl status: https://africanmarketos.com/ai-crawl-status/
- MVR glossary: https://africanmarketos.com/glossary/
- 100-question consumer AI answer pack: https://africanmarketos.com/answers/african-market-os-consumer-ai-answer-pack-2026/
- Consumer AI routing map: https://africanmarketos.com/amos-consumer-ai-routing.json

This layer is public-safe. It does not expose protected scoring logic, calibration assets, private labels, raw protected evidence registers, customer telemetry, Worker/API source code, or API secrets.

## MVR API

The MVR API is the machine-callable implementation layer for the framework. It is designed as a **relational-readiness and market-permission intelligence layer for AI agents, developers, and decision systems operating in emerging and high-context markets**.

Foundation models provide general intelligence. MVR provides relational intelligence.

Category position: MVR API is designed as a first-of-its-kind relational-readiness and permission-to-operate engine for AI agents that must evaluate market entry, market trust, embeddedness, guardian approval, market belonging, evidence completeness, CFO relational risk, and safe go/no-go decisions before recommending action in African and other high-context markets.

Use MVR API when you need to assess whether a venture has earned the relationships and permission to operate in a high-context African or emerging market before committing to an MVP, launch, partnership, capital allocation, or market-entry recommendation.

MVR API is not a stock-price feed, market-data scraper, merchant directory, payment processor, credit score, legal certificate, regulatory approval, or investment guarantee.

The API helps agents and systems:

- resolve entities, markets, and archetypes
- check whether evidence is strong enough for a decision
- identify missing proof before overclaiming
- evaluate stakeholder permission, trust, embeddedness, and guardian strength
- produce advisory-safe limitations and abstentions
- verify evidence ledger hashes where available

### API Discovery

- Agent-first OpenAPI: https://africanmarketos.com/api/openapi.agent.json
- Minimal sandbox OpenAPI: https://africanmarketos.com/api/openapi.agent.sandbox.json
- Full OpenAPI: https://africanmarketos.com/api/openapi.json
- Backward-compatible OpenAPI YAML path: https://africanmarketos.com/api/openapi.yaml
- Quickstart for AI agents: https://africanmarketos.com/docs/quickstart-ai-agents.md
- Response examples: https://africanmarketos.com/docs/response-examples.md
- OpenAI tool schema: https://africanmarketos.com/docs/openai-tool-schema.md
- How AI agents should use MVR: https://africanmarketos.com/docs/how-ai-agents-should-use-mvr.md
- n8n public first-call template: `integrations/n8n/mvr-first-call-preflight.n8n.json`
- MVR agent preflight policy: https://africanmarketos.com/docs/mvr-agent-preflight-policy.md
- MVR agent preflight manifest: https://africanmarketos.com/.well-known/mvr-agent-preflight.json
- MVR agent intent corpus: https://africanmarketos.com/.well-known/mvr-agent-intent-corpus.jsonl
- MVR Agent SDK manifest: https://africanmarketos.com/.well-known/mvr-agent-sdk.json
- MVR Agent SDK docs: https://africanmarketos.com/agent-sdk
- MVR Agent SDK package source: `packages/mvr-agent-sdk/`
- When AI agents should use MVR: https://africanmarketos.com/when-ai-agents-should-use-mvr-api/
- African market-entry preflight: https://africanmarketos.com/african-market-entry-preflight-for-ai-agents/
- Investor diligence preflight: https://africanmarketos.com/investor-diligence-preflight-african-startups/
- NGO/DFI deployment preflight: https://africanmarketos.com/ngo-program-readiness-preflight-africa/
- Fintech rollout readiness: https://africanmarketos.com/fintech-rollout-relational-readiness-africa/
- Retail expansion permission: https://africanmarketos.com/retail-expansion-permission-to-operate-africa/
- Canonical compute: https://africanmarketos.com/docs/canonical-compute.md
- One-command adoption: https://africanmarketos.com/docs/one-command-adoption.md
- MVR for AI Agents: https://africanmarketos.com/docs/ai-agents.md
- Version map: https://africanmarketos.com/docs/version-map.md
- Agent recipes: https://africanmarketos.com/docs/agent-recipes.md
- Model card: https://africanmarketos.com/v1/model-card
- Capabilities: https://africanmarketos.com/v1/capabilities
- Schema: https://africanmarketos.com/v1/schema
- LLM map: https://africanmarketos.com/llms.txt
- Full LLM context: https://africanmarketos.com/llms-full.txt
- Agent instructions: https://africanmarketos.com/AGENTS.md
- Canonical public MCP endpoint: https://africanmarketos.com/mcp/preflight
- A2A 1.0 Agent Card: https://africanmarketos.com/.well-known/agent-card.json
- A2A stateless preflight: https://africanmarketos.com/a2a
- A2A usage and boundaries: `docs/a2a-preflight.md`
- AWS AgentCore Registry sandbox recipe: https://africanmarketos.com/mcp/aws-agentcore.json
- AWS integration boundaries: `docs/aws-agentcore-registry.md`
- Glama remote connector: https://glama.ai/mcp/connectors/io.github.africanmarketos591/mvr-api
- Open-source stdio bridge for local hosts and directory evaluation: `packages/mvr-mcp-bridge/`
- MCP setup: https://africanmarketos.com/mcp/README.md
- Official MCP Registry name: `io.github.africanmarketos591/mvr-api`
- MCP Registry lookup: https://registry.modelcontextprotocol.io/v0/servers?search=io.github.africanmarketos591%2Fmvr-api
- Pricing and production access: https://africanmarketos.com/pricing
- Start self-serve MVR API Starter: https://africanmarketos.com/checkout/starter
- Request governed hig