A Natural Endeavor
Home / Developer access

REST and Remote MCP

Developer access

Six read-only operations share one service contract across REST and the official MCP Streamable HTTP transport.

Base URL: https://anaturalendeavor.com
MCP: https://anaturalendeavor.com/mcp
OpenAPI: /openapi.json

Operations

get_supplement_label

Read one traceable supplement label snapshot

GET /api/v1/supplement-labels/{label_id}

get_source_record

Inspect public provenance and rights metadata

GET /api/v1/source-records/{source_record_id}

get_ingredient_evidence

Read a reference-only ingredient evidence index

GET /api/v1/ingredients/{ingredient_id}/evidence

get_supplement_dossier

Retrieve label, evidence index, and provenance together

GET /api/v1/supplement-labels/{label_id}/dossier

Authentication and quotas

Public reads can be anonymous at the published experimental quota. Optional API keys use Authorization: Bearer …; keys are never accepted in URLs. OAuth is not published in v1.

Protocol versions

Remote MCP uses Agents SDK 0.24.0, @modelcontextprotocol/server 2.0.0, Streamable HTTP, and a stateless compatibility lane for published 2025 clients.

curl "https://anaturalendeavor.com/api/v1/supplement-labels?query=magnesium&market=US"

# Configure a Streamable HTTP client with:
https://anaturalendeavor.com/mcp