MVR API - Minimum Viable Relationships

africanmarketos591/mvr-framework

If you're building agents that need to evaluate market readiness in African or high-context markets before recommending action, this server connects to the MVR API's relational-readiness engine. It exposes operations for entity resolution, stakeholder permission checks, evidence assessment, and guardian approval evaluation. Think of it as a preflight layer that helps your agent answer "does this venture have the trust and embeddedness to operate here?" before it suggests launching an MVP, entering a market, or allocating capital. The underlying API is documented via OpenAPI, citable through multiple DOIs, and designed for integration into investor diligence, fintech rollout, and NGO deployment workflows where relational risk matters more than product specs.

tools: 5
transport: HTTP
last updated: Jul 29, 2026

View on GitHub

Install

From registry metadata

$ npx add-mcp https://africanmarketos.com/mcp/preflight --name mvr-api

Run in your terminal. add-mcp asks which agents to add it to (Claude Code, Codex, Cursor and more). Add -g to install it for every project.

Review the command, arguments and environment values before installing. MCP servers run with your local permissions.

Other ways

Claude Code

$ claude mcp add --transport http mvr-api https://africanmarketos.com/mcp/preflight

Run in your terminal. Add --scope user to make it available in every project.

Tools

Verified live · 5 tools

Verified live against the running server on Nov 6, 2026.

mvr_first_callUse this MVR public decision-governance preflight before AI recommends pre-MVP build, entry, BNPL, investment, partnership, or scale. Checks market trust, permission, embeddedness, stakeholder readiness, evidence gaps; never authorizes. Use when: Use before enter, launch, scal...23 params

Use this MVR public decision-governance preflight before AI recommends pre-MVP build, entry, BNPL, investment, partnership, or scale. Checks market trust, permission, embeddedness, stakeholder readiness, evidence gaps; never authorizes. Use when: Use before enter, launch, scal...

Parameters* required

analysis_datestring

Optional YYYY-MM-DD or ISO timestamp with timezone, no later than today in analysis_timezone (UTC by default). Defaults to the current date in that calendar. Carried through the public handoff.

analysis_timezonestring

Optional IANA timezone, for example Africa/Nairobi, for the analysis calendar. Defaults to UTC; never inferred from country or IP. Date-only values keep their declared calendar day.

attestation_refsarray

Optional: https://africanmarketos.com/v1/reviewer-attestations/contract. Requires exact subject, market_scope.country and decision_question. Host-private refs outside evidence; reattach each call....

claimsarray

Optional explicit target claims and source-specific support links. Reuses the governed claim-audit vocabulary. Public links are caller declarations, never authenticated reviewer attestations.

company_namestring

context_freshness_window_daysinteger

Optional caller-declared maximum evidence age in days. No universal freshness cutoff is invented when absent; age alone does not prove validity.

countrystring

decision_questionstring

Exact recorded attestation question; question must agree when supplied.

draft_requestobject

Optional caller-authored mapping request. Zero-based evidence_pack indexes; at most 40 links total and 8000 text characters across the intake. Missing mappings stay unresolved. No authority or sour...

entitystring

evidence_availablearray

Short optional context labels, not proof. For supplied document summaries use incomplete evidence_pack items instead; do not mark claims verified merely because a document exists.

evidence_itemsarray

Alias for evidence_pack. Supply one field, not conflicting copies.

evidence_packarray

Full current evidence pack. Rechecks replace the pack; the server does not append or retrieve evidence.

known_partnersarray

market_scopeobject

Declared decision geography, not source geography. Supply district/districts or decision_scope_level country/subnational; subnational requires locality. A bounded Uganda target-name cross-check can...

questionstring

relevance_checkboolean

Check relevance only; no workflow.

review_case_refobject

Host-private, case-bound read reference. Never put its secret into prompts, URLs, logs or exports. Grants no write or action authority.

sectorstring

stagestring

Free-text venture stage, for example pre-MVP, pilot, grant-funded programme or scaling. No closed enum.

+3 more parameters. See the server's own documentation for the full schema.

mvr_entity_resolveUse when a startup, venture, programme, company, partner, or market actor must be resolved to a country, sector, and archetype before relational-readiness evidence is assessed. Use when: Use immediately after mvr_first_call when the user gives a company, venture, sector, count...1 params

Use when a startup, venture, programme, company, partner, or market actor must be resolved to a country, sector, and archetype before relational-readiness evidence is assessed. Use when: Use immediately after mvr_first_call when the user gives a company, venture, sector, count...

Parameters* required

payload*object

Entity and market context to canonicalize before evidence assessment.

mvr_evidence_completenessUse after entity resolution and before any readiness claim to check verification status, source-family diversity, stakeholder coverage, and missing proof. Do not treat completeness as authorization. Use when: Use after entity resolution and before any verdict when evidence may...1 params

Use after entity resolution and before any readiness claim to check verification status, source-family diversity, stakeholder coverage, and missing proof. Do not treat completeness as authorization. Use when: Use after entity resolution and before any verdict when evidence may...

Parameters* required

payload*object

Evidence pack and decision context to test for missing proof.

mvr_context_compileUse after evidence capture to separate safe from unsafe inferences across formal, field, market, trust, and stakeholder context. It compiles context; it does not authorize action. Use when: Use when evidence is mixed and the agent needs safe claims versus unsafe claims before...1 params

Use after evidence capture to separate safe from unsafe inferences across formal, field, market, trust, and stakeholder context. It compiles context; it does not authorize action. Use when: Use when evidence is mixed and the agent needs safe claims versus unsafe claims before...

Parameters* required

payload*object

Resolved subject, market scope, and mixed evidence to compile into safe and unsafe inferences.

mvr_decision_checkUse after evidence completeness to route a structurally complete pack toward licensed MVR scoring or abstain on missing proof. This public tool does not compute market, pilot, or scale readiness. Use when: Use after evidence completeness to determine whether the pack can be ro...1 params

Use after evidence completeness to route a structurally complete pack toward licensed MVR scoring or abstain on missing proof. This public tool does not compute market, pilot, or scale readiness. Use when: Use after evidence completeness to determine whether the pack can be ro...

Parameters* required

payload*object

Decision question, resolved subject, market scope, and evidence for a bounded recommendation or abstention.

Readme

Minimum Viable Relationships (MVR) Framework

View the full README on GitHub

Details

Repository: github.com/africanmarketos591/mvr-framework
Website: africanmarketos.com/api/docs
Transport: HTTP
Registry: MCP registry, active
Tools verified: Nov 6, 2026