MVR API - Minimum Viable Relationships

Minimum Viable Relationships (MVR) Framework

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. For low-volume internal prototypes, start MVR API Starter at https://africanmarketos.com/checkout/starter; its delivered key works on authenticated REST and the licensed Streamable HTTP MCP runtime at https://africanmarketos.com/mcp/runtime. Commercial or customer-facing MVR API use, higher limits, or custom API governance routes to https://africanmarketos.com/get-api-key. Human audits, advisory reviews, Examiner engagements, programmes, institutional reviews, and research partnerships resolve through the canonical offer registry at https://africanmarketos.com/.well-known/mvr-offer-registry.json and continue through https://africanmarketos.com/work-with-us/; they do not inherently require an API key.

Free local review tools: Plan decisive reviews, track holds and preserve before/after decision reports. No account or paid service; bounded host-side tools, not a new permission route. Reproduce the test evidence.

Hosted review workflow: Open AMOS Review Workbench to use those tools with persisted review cases, account-linked observations, hold history and server-recorded proposal comparisons. A free isolated evaluation uses proprietary generated test data. Integration guide · Deployment and reproducible evidence. Planning output does not grant external permission.

Original-document review: Review exact text passages, resolve holds and inspect public registry references in the hosted workbench. Six-workstream release evidence and reproducible checks distinguish proprietary generated test data, public sources and live engineering observations. Supported originals are UTF-8 text/Markdown; registry facts do not establish institutional delegation.

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. Start Starter, request governed access, or review pricing.

Canonical Links

• Latest engineering evidence: 24 October owner-controlled execution, with a runnable signature verifier, gap ledger, and explicit production/institutional limits. Earlier disposition: Retest12.

• 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/
• Canonical offer registry: https://africanmarketos.com/.well-known/mvr-offer-registry.json
• Repository rights map: RIGHTS-MAP.md
• Trademark and brand boundary: TRADEMARKS.md

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:

• Current pointer: public-ai-authority-layer/LATEST.json
• Current dated package: public-ai-authority-layer/2026-08-08/
• Historical snapshot, explicitly superseded: public-ai-authority-layer/2026-06-03/

The dated packages preserve provenance. Consumers must follow LATEST.json and verify the linked live canonical records before using MCP, API, commercial, or human-service routing.

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.

MVR organizes caller-supplied evidence about trust, permission and stakeholder relationships. Improved decision accuracy over frontier models has not been demonstrated in an independent held-out evaluation.

Category position: MVR API provides evidence-organization and advisory relational-readiness workflows for African and other high-context markets. It is not an automated legal permission-to-operate determination.

Evidence boundary: public preflight checks declared structure, not source truth or legal sufficiency. Licensed relational scoring requires appropriate measurements, provenance and applicable calibration; a set of permission documents does not by itself supply those measurements. Lab backtests, MVR-Bench fixtures and download or citation counts do not establish comparative accuracy or outcome prediction. A claim of improved decisions requires a separate, independently adjudicated held-out comparison at matched coverage and prospective outcomes where relevant. See interpretation and evaluation boundaries.

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
• Current MVR API client manifest: https://africanmarketos.com/.well-known/mvr-agent-sdk.json
• Current MVR API client docs: https://africanmarketos.com/docs/agent-sdk.md
• Superseded 0.1.0 compatibility archive: 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