{"_id":"@africanmarketos/mvr-api-client","_rev":"5-c413a2eeb518003d75f2c7e4203e6278","name":"@africanmarketos/mvr-api-client","dist-tags":{"latest":"6.32.4"},"versions":{"2.6.0":{"name":"@africanmarketos/mvr-api-client","version":"2.6.0","keywords":["mvr","api","african-market","relationships","trust"],"author":{"name":"African Market OS","email":"info@africanmarketos.com"},"license":"MIT","_id":"@africanmarketos/mvr-api-client@2.6.0","maintainers":[{"name":"africanmarketos","email":"africanmarketos591@gmail.com"}],"homepage":"https://github.com/africanmarketos/mvr-api-ts-client#readme","bugs":{"url":"https://github.com/africanmarketos/mvr-api-ts-client/issues"},"dist":{"shasum":"714ee07dc84319ce8b7c88cd90b40eccfff1eb4b","tarball":"https://registry.npmjs.org/@africanmarketos/mvr-api-client/-/mvr-api-client-2.6.0.tgz","fileCount":16,"integrity":"sha512-t9ZapolnWSZoMtW/1JSUPeZJi/PRIaew71R+y9DfJnukRyFQDc30nSoF+Alh7sS7ijdNsbYYg0AHYyuG36R4sw==","signatures":[{"sig":"MEQCIG20Iwg+QQHx/c0sW5gQqv44d5VzeiNV5jz0fwJsIxYTAiAmCcZQX5ZG46oNC/8SQLXXYJxOzqIOjNSTjvqY3YbI3A==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":41502},"main":"dist/index.js","types":"dist/index.d.ts","gitHead":"44cc47379a54510bb3eaea1e80b6378d77f20ef7","scripts":{"build":"tsc","prepublishOnly":"npm run build"},"_npmUser":{"name":"africanmarketos","email":"africanmarketos591@gmail.com"},"repository":{"url":"git+https://github.com/africanmarketos/mvr-api-ts-client.git","type":"git"},"_npmVersion":"10.8.2","description":"TypeScript client for African Market OS MVR API","directories":{},"_nodeVersion":"20.19.5","dependencies":{"axios":"^1.6.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.0.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mvr-api-client_2.6.0_1763104402586_0.5762215881767139","host":"s3://npm-registry-packages-npm-production"}},"6.32.0":{"name":"@africanmarketos/mvr-api-client","version":"6.32.0","keywords":["mvr","api","minimum-viable-relationships","mcp","openapi","relational-readiness","ai-agents"],"author":{"name":"African Market OS","email":"info@africanmarketos.com"},"license":"MIT","_id":"@africanmarketos/mvr-api-client@6.32.0","maintainers":[{"name":"africanmarketos","email":"africanmarketos591@gmail.com"}],"homepage":"https://github.com/africanmarketos591/mvr-api-ts-client#readme","bugs":{"url":"https://github.com/africanmarketos591/mvr-api-ts-client/issues"},"dist":{"shasum":"e79e817dc59948043d182dfcb1adb96fad4daab5","tarball":"https://registry.npmjs.org/@africanmarketos/mvr-api-client/-/mvr-api-client-6.32.0.tgz","fileCount":11,"integrity":"sha512-Okh+3KVCAR8JBkQud000JXlT5zTq0ioSjSjhZpmEGUlds6hJsYuZyK8BPn3+bOs/sCKB7GT6o1TKypvLCPUZkQ==","signatures":[{"sig":"MEQCIG4tIQuDqyojHgR4w1z7MM0oVQW2SeqdU+1xfVflnvwwAiACFzo9ulxiE05erSbAutiZsFjYIkBQ00ZxRyySXqkWAA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@africanmarketos%2fmvr-api-client@6.32.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":18933},"main":"dist/index.js","types":"dist/index.d.ts","gitHead":"f2d4fdc80d9be9031e103405daec17fd7bfbdc17","scripts":{"build":"tsc","prepublishOnly":"npm run build"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:93d10004-c557-4941-aca4-e977da38c546"}},"repository":{"url":"git+https://github.com/africanmarketos591/mvr-api-ts-client.git","type":"git"},"_npmVersion":"11.15.0","description":"TypeScript client for the MVR API relational-readiness layer","directories":{},"_nodeVersion":"20.20.2","dependencies":{"axios":"^1.6.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.0.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mvr-api-client_6.32.0_1779650554791_0.140187557664593","host":"s3://npm-registry-packages-npm-production"}},"6.32.1":{"name":"@africanmarketos/mvr-api-client","version":"6.32.1","keywords":["mvr","api","minimum-viable-relationships","mcp","openapi","relational-readiness","ai-agents"],"author":{"name":"African Market OS","email":"info@africanmarketos.com"},"license":"MIT","_id":"@africanmarketos/mvr-api-client@6.32.1","maintainers":[{"name":"africanmarketos","email":"africanmarketos591@gmail.com"}],"homepage":"https://github.com/africanmarketos591/mvr-api-ts-client#readme","bugs":{"url":"https://github.com/africanmarketos591/mvr-api-ts-client/issues"},"dist":{"shasum":"8c594c0194ba5fe9e7f135f4844329428f038663","tarball":"https://registry.npmjs.org/@africanmarketos/mvr-api-client/-/mvr-api-client-6.32.1.tgz","fileCount":11,"integrity":"sha512-mhncqNfka4N/p2GQj7BsYszqWdYsA/Oc2b6InOscC2MYzv3gOqFg+hNt9TW4v6gJCQ72N0PMieZaYXYEjVznig==","signatures":[{"sig":"MEYCIQDML+6VvtNsLZYpaYB29N6FXP55tHbslZfVCsR/UX9Q9AIhAMR7lIyOKX9ye5NPL9aQXEOTChVgy3tGF77p96hRdPhU","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@africanmarketos%2fmvr-api-client@6.32.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":20385},"main":"dist/index.js","types":"dist/index.d.ts","gitHead":"7a5ff375d95df6249acd0fac1b2398657ba59ff1","scripts":{"build":"tsc","prepublishOnly":"npm run build"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:93d10004-c557-4941-aca4-e977da38c546"}},"repository":{"url":"git+https://github.com/africanmarketos591/mvr-api-ts-client.git","type":"git"},"_npmVersion":"11.15.0","description":"TypeScript client for the MVR API relational-readiness layer","directories":{},"_nodeVersion":"20.20.2","dependencies":{"axios":"^1.6.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.0.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mvr-api-client_6.32.1_1779687926224_0.8037583926585294","host":"s3://npm-registry-packages-npm-production"}},"6.32.3":{"name":"@africanmarketos/mvr-api-client","version":"6.32.3","keywords":["mvr","api","minimum-viable-relationships","mcp","openapi","relational-readiness","ai-agents"],"author":{"name":"African Market OS","email":"info@africanmarketos.com"},"license":"MIT","_id":"@africanmarketos/mvr-api-client@6.32.3","maintainers":[{"name":"africanmarketos","email":"africanmarketos591@gmail.com"}],"homepage":"https://github.com/africanmarketos591/mvr-api-ts-client#readme","bugs":{"url":"https://github.com/africanmarketos591/mvr-api-ts-client/issues"},"dist":{"shasum":"b1c627f80fafaa89ce9ad744c822e42eec7ddfcc","tarball":"https://registry.npmjs.org/@africanmarketos/mvr-api-client/-/mvr-api-client-6.32.3.tgz","fileCount":11,"integrity":"sha512-jzDQ5s4s+DsqKYEEDbkHm2ySdEKS7Aq6PwEnXYNAz/ppbQ3Oul/xfEyEWW2HxyuTuCaqvqA77KRhJeFYO36WCQ==","signatures":[{"sig":"MEQCIBidSkAmKUBkcaZoxXSuQPIh38KYe5NnakWCj1zh9jR/AiBUL/tfvylI56P3aju1h4PCgbaQm2ESsFUja/GXnnJPjQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@africanmarketos%2fmvr-api-client@6.32.3","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":32702},"main":"dist/index.js","types":"dist/index.d.ts","gitHead":"66ebaa793f81b4b2c56a4b15e88df80dff6401b7","scripts":{"test":"npm run build && npm run test:types && node --test tests/*.test.cjs","build":"tsc","test:types":"tsc -p tsconfig.types.json","prepublishOnly":"npm run build"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:93d10004-c557-4941-aca4-e977da38c546"}},"overrides":{"form-data":"^4.0.6"},"repository":{"url":"git+https://github.com/africanmarketos591/mvr-api-ts-client.git","type":"git"},"_npmVersion":"11.6.4","description":"TypeScript client for the MVR API relational-readiness layer","directories":{},"_nodeVersion":"24.18.0","dependencies":{"axios":"^1.18.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.0.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mvr-api-client_6.32.3_1785235174895_0.4742192355245214","host":"s3://npm-registry-packages-npm-production"}},"6.32.4":{"name":"@africanmarketos/mvr-api-client","version":"6.32.4","description":"TypeScript client for the MVR API relational-readiness layer","main":"dist/index.js","types":"dist/index.d.ts","scripts":{"build":"tsc","test:types":"tsc -p tsconfig.types.json","test":"npm run build && npm run test:types && node --test tests/*.test.cjs","prepublishOnly":"npm run build"},"keywords":["mvr","api","minimum-viable-relationships","mcp","openapi","relational-readiness","ai-agents"],"author":{"name":"African Market OS","email":"info@africanmarketos.com"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/africanmarketos591/mvr-api-ts-client.git"},"homepage":"https://github.com/africanmarketos591/mvr-api-ts-client#readme","bugs":{"url":"https://github.com/africanmarketos591/mvr-api-ts-client/issues"},"dependencies":{"axios":"^1.18.0"},"overrides":{"form-data":"^4.0.6"},"devDependencies":{"@types/node":"^20.0.0","typescript":"^5.0.0"},"gitHead":"04ddeaea477692a2c4af2a2cb54449363d3f12e9","_id":"@africanmarketos/mvr-api-client@6.32.4","_nodeVersion":"24.18.0","_npmVersion":"11.6.4","dist":{"integrity":"sha512-P3W8Ts/EqsS/JDcgnjVF5c3AShvQ14NZ/MnKl+vWMq1U39kgnAUo6PJQCPtBhi2OLSLR4KjPbkRgKOq8m9z6DA==","shasum":"29154affdff5f51cd69f4767566d776f84f3cf02","tarball":"https://registry.npmjs.org/@africanmarketos/mvr-api-client/-/mvr-api-client-6.32.4.tgz","fileCount":11,"unpackedSize":32701,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@africanmarketos%2fmvr-api-client@6.32.4","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIHUoIaDNf48piglOOous526wpG7nxTmqw8+t6td+WNqYAiBY4hi22wPm3jZ26TSN9Y1K5QdwHbwKxNBHrLnPGNEj9A=="}]},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:93d10004-c557-4941-aca4-e977da38c546"}},"directories":{},"maintainers":[{"name":"africanmarketos","email":"africanmarketos591@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mvr-api-client_6.32.4_1785236055749_0.917777673137878"},"_hasShrinkwrap":false}},"time":{"created":"2025-11-14T07:13:22.482Z","modified":"2026-07-28T10:54:16.164Z","2.6.0":"2025-11-14T07:13:22.869Z","6.32.0":"2026-05-24T19:22:34.980Z","6.32.1":"2026-05-25T05:45:26.358Z","6.32.3":"2026-07-28T10:39:35.054Z","6.32.4":"2026-07-28T10:54:15.879Z"},"bugs":{"url":"https://github.com/africanmarketos591/mvr-api-ts-client/issues"},"author":{"name":"African Market OS","email":"info@africanmarketos.com"},"license":"MIT","homepage":"https://github.com/africanmarketos591/mvr-api-ts-client#readme","keywords":["mvr","api","minimum-viable-relationships","mcp","openapi","relational-readiness","ai-agents"],"repository":{"type":"git","url":"git+https://github.com/africanmarketos591/mvr-api-ts-client.git"},"description":"TypeScript client for the MVR API relational-readiness layer","maintainers":[{"name":"africanmarketos","email":"africanmarketos591@gmail.com"}],"readme":"# MVR API TypeScript Client\n\n[![npm](https://img.shields.io/npm/v/@africanmarketos/mvr-api-client)](https://www.npmjs.com/package/@africanmarketos/mvr-api-client)\n[![MCP Registry](https://img.shields.io/badge/MCP%20Registry-listed-0f6b45)](https://registry.modelcontextprotocol.io/?search=mvr)\n[![OpenAPI](https://img.shields.io/badge/OpenAPI-3.1-6ba539)](https://africanmarketos.com/api/openapi.json)\n[![License](https://img.shields.io/badge/license-MIT-lightgrey)](https://github.com/africanmarketos591/mvr-api-ts-client/blob/main/LICENSE)\n\nLightweight TypeScript client for the current **MVR API - Minimum Viable Relationships** surface.\n\nUse MVR API when assessing whether a startup, product, investor, NGO, brand, fintech, partnership, program, or market-entry plan has enough trust, permission, embeddedness, guardian approval, reciprocity, evidence completeness, local legitimacy, and stakeholder acceptance to operate in an African or high-context market.\n\nThis client targets the live MVR Core API v6.32.x:\n\n- `POST /v1/first-call` - keyless-compatible, non-verdict activation and next-step routing\n- `POST /v1/auth-check`\n- `POST /v1/entity-resolve`\n- `POST /v1/evidence-completeness`\n- `POST /v1/context/compile`\n- `POST /v1/decision-check`\n- `POST /v1/recommended-inputs`\n- `POST /v1/remediation-path`\n- `GET /v1/model-card`\n- `GET /v1/capabilities`\n\nIt is aligned with the agent OpenAPI contract, public sandbox, and MCP registry entry.\n\n## Install\n\n```bash\nnpm install @africanmarketos/mvr-api-client\n```\n\n## Public Sandbox\n\nThe default key is the public sandbox key:\n\n```text\nX-API-Key: mvr-demo-key-2026\n```\n\nSandbox use is non-commercial evaluation only. It is `full_advisory`, `client_safe`, illustrative, not for production, not for model training, and not for reverse engineering.\n\n## Example\n\n```ts\nimport { MVRClient } from \"@africanmarketos/mvr-api-client\";\n\nconst client = new MVRClient({\n  apiKey: process.env.MVR_API_KEY || \"mvr-demo-key-2026\"\n});\n\nconst result = await client.firstCall({\n  entity: \"Example supplier-finance venture\",\n  country: \"UG\",\n  sector: \"fintech\",\n  question: \"Should this venture launch supplier-finance BNPL next month?\"\n});\n\nconsole.log(result.not_a_verdict); // true: first_call never authorizes launch or scale\n```\n\n`firstCall` intentionally accepts free-form discovery labels such as `generic_startup`; canonical `EntityArchetype` values become mandatory on `recommendedInputs` and evidence-scoring routes. Published top-level and nested privacy, provenance, and artifact enums mirror the production OpenAPI contract while extension fields remain open. When a compiled pack is assembled in a variable before submission, use `defineCompiledPack(pack)` to retain exact compile-time checking of the ten supported lanes; the API also rejects unknown lanes at runtime.\n\n## Evidence Completeness\n\n```ts\nconst result = await client.evidenceCompleteness({\n  subject: {\n    entity_name: \"Sandbox Kampala catering operator\",\n    entity_archetype: \"retail_chain\",\n    country: \"UG\"\n  },\n  market_scope: {\n    country: \"UG\",\n    city: \"Kampala\",\n    sector: \"catering\"\n  },\n  evidence_pack: [\n    {\n      id: \"ev-licence-001\",\n      evidence_type: \"public_filing\",\n      source_class: \"administrative_record\",\n      source_grade: \"B\",\n      stakeholder_class: \"guardian\",\n      evidence_origin: \"field_research\",\n      collection_method: \"direct\",\n      freshness_date: \"2026-05-20\",\n      evidence_geography: { country: \"UG\", city: \"Kampala\" },\n      structured_values: { guardian_strength: 72, permission: 68 }\n    }\n  ]\n});\n```\n\n## Agent Discovery\n\n- Agent OpenAPI: https://africanmarketos.com/api/openapi.agent.json\n- Minimal sandbox OpenAPI: https://africanmarketos.com/api/openapi.agent.sandbox.json\n- AI-agent quickstart: https://africanmarketos.com/docs/quickstart-ai-agents.md\n- Response examples: https://africanmarketos.com/docs/response-examples.md\n- OpenAI tool schema: https://africanmarketos.com/docs/openai-tool-schema.md\n- Canonical five-tool MCP preflight: https://africanmarketos.com/mcp/preflight\n- Seven-tool compatibility MCP endpoint: https://africanmarketos.com/mcp\n- MCP setup: https://africanmarketos.com/mcp/README.md\n- MCP Registry name: `io.github.africanmarketos591/mvr-api`\n- Sandbox guide: https://africanmarketos.com/docs/sandbox.md\n- Agent instructions: https://africanmarketos.com/AGENTS.md\n\n## Attribution\n\nMinimum Viable Relationships (MVR), originated by Farouk Mark Mukiibi, African Market OS.\n\nSandbox/evaluation use only with the public key. Commercial, production, SaaS, consulting, or AI-agent deployment use requires authorization from African Market OS.\n\nDo not present MVR output as credit scoring, legal certification, regulatory approval, investment guarantee, or field-validated truth unless verified evidence and production authorization explicitly support the claim.\n","readmeFilename":"README.md"}