MCP server exposing 7 tools for symmap.
This URL is a JSON-RPC 2.0 endpoint over HTTP. Issue POST requests with a JSON-RPC body. Browsers and search crawlers land here on GET.
POST https://gateway.pipeworx.io/symmap/mcp
Content-Type: application/json
{"jsonrpc":"2.0","id":1,"method":"tools/list"}symmap_search — Resolve a name to SymMap v2 (symmap.org, Beijing University of Chinese Medicine) entity records and ids across the Traditional Chinese Medicine association graph: herbs, ingredients (molecules), protein targets (genes), TCM symptoms, modern medical symptoms, TCM syndromes, diseases. Accepts Chinese characters, pinyin, Latin or English names, gene symbols, disease names. Returns the SMHB/SMIT/SMTT/SMTS/SMMS/SMSY/SMDE ids the relationship tools take. SymMap records associations, not efficacy.symmap_herb — Full record for one of the 698 herbs in SymMap v2 (symmap.org): Chinese/pinyin/Latin/English names, TCM properties (nature/flavour), meridians, drug class, used part — bilingual, answered from the SymMap v2.0 published herb table. Accepts any name form or a SMHB id. Traditional TCM attributes describe traditional use, not clinically demonstrated effect.symmap_herb_ingredients — Chemical ingredients (molecules) identified in a Traditional Chinese Medicine herb, from SymMap v2 (symmap.org) — with PubChem CID, CAS number and oral-bioavailability score per molecule. Every edge carries evidence_tier and evidence_basis. Constituent presence is a laboratory identification; it is NOT evidence the herb or the molecule treats anything.symmap_herb_symptoms — Traditional indications of a Traditional Chinese Medicine herb from SymMap v2 (symmap.org): the TCM symptoms (SMTS) and TCM syndromes (SMSY) it is traditionally used for, per the Chinese Pharmacopoeia as curated by SymMap. These are TRADITIONAL-USE records (evidence_tier on every edge), not clinical evidence, and TCM symptoms are kept separate from modern medical symptoms — use symmap_symptom_herbs with system:"modern" to enter from the modern vocabulary.symmap_symptom_herbs — Herbs traditionally associated with a symptom in SymMap v2 (symmap.org). system:"tcm" looks up a Traditional Chinese Medicine symptom (SMTS) directly; system:"modern" starts from a modern medical symptom (SMMS), returns its curated TCM-symptom crosswalk, then the herbs per mapped TCM symptom — the two vocabularies and the mapping hop stay explicit, never merged. Every hop carries evidence_tier; a traditional-use association is not evidence of effectiveness.symmap_ingredient — One Traditional Chinese Medicine ingredient (molecule) from SymMap v2 (symmap.org): its protein targets with literature evidence (PubMed-cited edges are tier "laboratory", uncited ones "computational_prediction") and the herbs it has been identified in. A target association is a molecular finding or a prediction — NOT evidence the ingredient treats any condition.symmap_target_diseases — Diseases associated with a protein target (gene) in SymMap v2 (symmap.org), with OMIM/Orphanet identifiers where the association comes from human genetics. Every edge carries evidence_tier: human_clinical for OMIM/Orphanet-backed gene–disease links, computational_prediction otherwise. A gene–disease link says NOTHING about any herb or ingredient treating the disease.Code samples (curl / TypeScript / one-click client install), schemas, and the live playground are on the pack page:
https://pipeworx.io/packs/symmap/
Pipeworx is an open MCP gateway connecting AI agents to live data. pipeworx.io