Developer documentation · English
Directory reviewer guide
Use the production MCP connection URL with a dedicated reviewer identity. Reviewer membership is controlled by MattaNutra and routes the identity to an isolated service with synthetic data. Creating a normal account does not grant reviewer access.
Before starting
Request a review invitation from [email protected]. MattaNutra supplies credentials, synthetic shopping targets, sample references, available simulation controls, and the verified deployment version privately. This page does not issue credentials or confirm that a review environment has been activated. Start only after your invitation confirms that sign-in, reviewer routing, and the sandbox are ready.
Reviewer sign-in uses the supplied email and password, without email-code or MFA dependencies. Use fictional information only. Do not supply a real payment card, shipping address, medical history, or another person’s information.
Connect and sign in
- Add https://mattanutra.com/mcp as a remote Streamable HTTP MCP connector in your AI host.
- Choose OAuth authentication when offered. Open the hosted sign-in page and use the privately supplied reviewer credentials. Review and approve the requested permissions. Never put credentials in a prompt or tool argument.
- Request service information, then create a fresh signed-in plan. Old anonymous plans and handles cannot be imported into the reviewer account.
- Confirm that any reviewer checkout uses
review.mattanutra.comand is visibly marked as simulated. Stop and contact support if it asks for real payment or delivery details.
Exercise all six tools
Ask the host to use the current tool definitions and returned handles. Keep handles private. Use a fresh idempotency key for a new operation; use the original key and unchanged input when testing a retry.
| Tool | Try | Expected result |
|---|---|---|
| info | Ask for supported countries, catalogue options, and the available operations. | Public discovery and catalogue information; no sign-in is required. |
| plan | Sign in with the supplied reviewer account. Ask for a new plan using the explicit nutrient amounts from new products supplied in the review invitation. Then ask to revise one preference. | A new account-bound plan and revision, product matches, and opaque handles. Requested and supplied quantities concern new products only. Creating or revising a plan does not purchase anything. |
| execute | Ask to prepare checkout for the latest reviewed plan. Reuse the same idempotency key and exact request to check retry behavior. | An unpaid checkout and order handle; a retry recovers the same operation. The tool does not charge money. |
| order | Ask for the status of the order just created, using the returned order handle. Follow the simulated payment steps supplied with your reviewer invitation, then refresh the order. | The account's order status and timeline, including simulated payment success or decline where available. |
| support | Send “Directory review: please help with this simulated order” with the order handle, then reply using the returned support handle. | A case reference and support thread linked to the synthetic order. |
| feedback | Explicitly agree to submit feedback on the latest plan, then ask to submit “Directory review: plan and checkout tested.” | An acknowledgement after explicit feedback consent. A request without that consent is rejected. |
Education, then product matching
The host can discuss general product information within its own capabilities. MattaNutra receives the agreed nutrient names, daily amounts required from new products, and shopping constraints. It does not supply a diagnostic questionnaire, determine personal nutrient needs, or require the conversation, medical history, memory, or files.
Try a request without nutrient targets: it should return an input error without creating a plan. Then use the invitation’s synthetic targets, refine price or product format, and inspect supplied quantities, incidental ingredients, gaps, and unknown composition. These comparisons do not establish total intake or medical suitability. Decline checkout once and confirm that no checkout is created; then explicitly agree and exercise the simulated checkout.
Sandbox boundaries and resets
The reviewer service uses separate data and capability keys, mock payment and fulfilment adapters, and no production payment, carrier, customer-data, or notification credentials. Simulated payment outcomes cannot charge money, allocate production stock, ship goods, or contact real customers. Reviewer and customer handles are not interchangeable. A successful simulated payment demonstrates the tool workflow; it is not proof of a live payment integration.
Ask support to reset the sample data before repeating a full review. A reset invalidates previous plans, order handles, and support threads. Create a fresh plan afterwards. Do not use internal QA endpoints; they are not part of the reviewer environment.
Verify access and report results
Confirm that general information remains available when signed out, while personal tools request sign-in. Disconnect the connector, reconnect, and repeat consent as required by the host. If MattaNutra supplies a second isolated reviewer identity, verify that it cannot access the first identity’s handles. Never test against another customer’s account.
Send the host name/version, verified server version, date, operation, and redacted error or result to support. Exclude passwords, tokens, authorization headers, private links, and handles. For privacy or deletion requests, see the privacy policy; for purchase responsibilities, see the terms.