Hermetica Encyclopedia MCP Server

Model Context Protocol server for querying the public Hermetica Superfoods Ingredient Encyclopedia API from Claude Desktop, Cursor, Claude Code, and other MCP-compatible clients.

Current data scope

Baseline audited on 2026-07-11:

| Population | Count | What the count means | |---|---:|---| | Raw ingredient source corpus | 16,246 | Source rows retained internally; not all are public profiles | | Public ingredient profiles | 6,100 | Publication-gated profiles kept public for discovery and URL/index continuity | | Human-approved ingredient profiles | 0 | No public ingredient profile had accountable human approval at baseline | | Raw interaction source rows | 121,278 | Generated source rows; these are not public medical conclusions | | Accountable reviewed interaction conclusions | 0 | Public interaction tools return reviewed-only records; none qualified at baseline |

Public inclusion is not evidence validation or human approval. Claim-bearing ingredient narratives are withheld until accountable human review is recorded. Interaction tools search only records with a reviewer, review timestamp, evidence level, and at least one citation.

The MCP server never determines whether a supplement/medication combination is safe. If no accountable reviewed interaction record is returned, the status is unknown, not safe.

What this gives you

The tools can help an AI client:

• Find a public ingredient identity profile and its canonical URL.
• Inspect publication state, review state, and provisional public-score fields.
• Retrieve screened PubMed identifiers for direct source inspection.
• Ask whether an accountable reviewed interaction record currently exists for a substance pair.
• Browse categories, editorial topic routes, and Hermetica articles.

Screened PubMed identifiers are research leads. Their presence does not validate relevance, claim direction, efficacy, dosage, or an ingredient narrative. Condition routes and blog articles are editorial navigation surfaces, not diagnoses or treatment recommendations.

Install

Claude Desktop

Add this to your Claude Desktop configuration:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "hermetica-encyclopedia": {
      "command": "npx",
      "args": ["-y", "hermetica-encyclopedia-mcp"]
    }
  }
}

Restart Claude Desktop, then confirm hermetica-encyclopedia appears in the tools list.

Cursor

Add this to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "hermetica-encyclopedia": {
      "command": "npx",
      "args": ["-y", "hermetica-encyclopedia-mcp"]
    }
  }
}

Claude Code

claude mcp add hermetica-encyclopedia npx -y hermetica-encyclopedia-mcp

Tools exposed

| Tool | Contract | |---|---| | search_ingredients | Search the 6,100 public index-continuity profiles by name | | get_ingredient | Retrieve one publication-gated record; narratives remain withheld without human review | | check_interaction | Look for an accountable reviewed record for a pair; missing means unknown, not safe | | list_interactions_for_substance | List reviewed-only records for one substance; not a complete safety profile | | search_interactions | Filter reviewed-only interaction records; empty results remain unknown | | get_pubmed_citations | Return screened PMID leads and their PubMed links; not claim validation | | get_synergy_pairings | Return pairings only after accountable human approval; no benefit is promised | | list_ingredients_by_tier | Filter provisional public-score bands (1: 7-10, 2: 4-6, 3: below 4) | | browse_categories | Browse categories and public-profile counts | | browse_conditions | Browse editorial condition/topic routes; not medical guidance | | get_encyclopedia_stats | Read live raw, public, reviewed, and sitemap-scope counts | | get_random_ingredient | Select a random profile from a provisional public-score band | | compare_ingredients | Retrieve two gated records and a convenience comparison URL; no clinical judgment | | find_blog_articles | Find separate Hermetica editorial content |

The tool name list_ingredients_by_tier is retained for backward compatibility. Its tier argument now means a provisional public-score band, not evidence strength or clinical quality.

How publication and review work

• Ingredient corpus: 16,246 raw rows are retained as source material. A publication gate exposes 6,100 profiles for index continuity at the audited baseline.
• Ingredient claims: identity and provenance fields can remain public, while claim-bearing narratives, dosage guidance, FAQs, mechanisms, and synergy are withheld unless accountable human review is recorded.
• PubMed identifiers: only screened identifiers are exposed, but screening an identifier is not semantic validation of a claim.
• Interactions: 121,278 raw generated rows remain source data. Public tools and API routes expose only accountable reviewed rows with citations and an evidence level.
• Synergy: pairing content is unavailable until the profile is human-approved. A returned pairing is not individualized advice or a guaranteed benefit.
• Generated scores: public-score bands support ordering and continuity. They do not establish evidence quality, efficacy, safety, or human approval.
• Automation: automated updates do not count as accountable human review.

Live API documentation: https://ingredients.hermeticasuperfoods.com/api/docs

Response interpretation

Version 1.1.0 adds an mcp_interpretation_notice and an audited data_baseline to tool results. Clients should preserve those fields when summarizing results.

For interaction questions:

1. A returned record means only that an accountable reviewed database record is available.
2. A missing record means the combination is unknown in the reviewed public set.
3. Neither outcome replaces a pharmacist, physician, or other qualified healthcare professional.

License

Encyclopedia data: CC BY-NC-SA 4.0. Non-commercial reuse requires attribution and share-alike licensing. Commercial use requires a separate commercial license from Hermetica Superfoods.

MCP server code: MIT. The MIT license covers the software in this package; it does not relicense encyclopedia data returned by the API.

Required data attribution:

Hermetica Superfoods Ingredient Encyclopedia, https://ingredients.hermeticasuperfoods.com

HTML example:

<a href="https://ingredients.hermeticasuperfoods.com" rel="noopener">
  Source: Hermetica Superfoods Ingredient Encyclopedia
</a>

For commercial data licensing, bulk access, or higher rate limits, contact [email protected].

Medical disclaimer

All data is educational and informational only. It is not medical advice and does not establish that a supplement, medication, dosage, or combination is safe or effective. Consult a qualified healthcare professional before making health decisions. Hermetica Superfoods makes no warranty regarding completeness or accuracy.

Support

• API docs: https://ingredients.hermeticasuperfoods.com/api/docs
• OpenAPI 3.1: https://ingredients.hermeticasuperfoods.com/api/v1/openapi.json
• Data license endpoint: https://ingredients.hermeticasuperfoods.com/api/v1/license
• Email: [email protected]
• Repository: https://github.com/mindexpansive/hermetica-supplement-encyclopedia

Built by Hermetica Superfoods.