Dermatology knowledge API for humans and agents.
Build medical AI that understands dermatology. Every answer traces to a versioned source, or it abstains.
{ "question": "Where does atopic dermatitis usually appear in adults?" }
1{
2 "data": {
3 "status": "grounded",
4 "answer": "In adults, atopic dermatitis favors flexural skin, the neck, face and hands. [1] Chronic scratching at these sites commonly causes lichenification. [2]",
5 "citations": [
6 {
7 "id": "cit_1",
8 "evidence_id": "ev_7Hq2",
9 "source": { "id": "src_sbx_ad_overview", "version": "sv_2026_09_14" },
10 "locator": "Distribution, para 2",
11 "checksum": "sha256:b2bb063ee133",
12 "license": "lic_sbx_synthetic"
13 },
14 {
15 "id": "cit_2",
16 "evidence_id": "ev_9Kd4",
17 "source": { "id": "src_sbx_ad_overview", "version": "sv_2026_09_14" },
18 "locator": "Morphology, para 1",
19 "checksum": "sha256:fa16ed7145ce",
20 "license": "lic_sbx_synthetic"
21 }
22 ],
23 "claims": [
24 {
25 "id": "clm_1",
26 "text": "In adults, atopic dermatitis favors flexural skin, the neck, face and hands.",
27 "citations": ["cit_1"]
28 },
29 {
30 "id": "clm_2",
31 "text": "Chronic scratching at these sites commonly causes lichenification.",
32 "citations": ["cit_2"]
33 }
34 ],
35 "removed_claims": []
36 },
37 "meta": { "request_id": "req_tX09J4dyUA", "knowledge_version": "kv_2026_10_01" }
38}
Every claim, cited
Each sentence in an answer links to the passage behind it. Claims no passage supports are removed before the response leaves.
QuestionWhat makes atopic dermatitis flare?
Impaired skin barrier function contributes to disease activity.1 Wool, harsh soaps and sweat are commonly reported to worsen symptoms.2
Impaired epidermal barrier function, including loss-of-function variants in the filaggrin gene in some patients, contributes to disease activity.
- evidence
- ev_2Pm8
- checksum
- sha256:dc73ec1bc482
- knowledge
- kv_2026_10_01
One name for every name
Lay terms, abbreviations and codes resolve to one concept, and ambiguity is flagged instead of guessed. Try typing a term.
- Atopic dermatitis0.81ICD-10-CM L20.9ICD-11 EA80.Z
- Dermatitis, unspecified0.64ICD-10-CM L30.9
Built for agents
An MCP server with five read-only tools. Every call is checked against the caller's scopes and written to a trace.
1{
2 "mcpServers": {
3 "dermliving": {
4 "type": "http",
5 "url": "https://api.dermliving.com/mcp"
6 }
7 }
8}
- search_conditionsconditions:read
- get_conditionconditions:read
- map_terminologyterminology:read
- search_evidenceevidence:read
- ask_knowledgeknowledge:query
- 0initializesess_YfkUkCYqEkok
- 7tools/list5 toolsok
- 12search_conditions{"query":"atopic dermatitis"}1 result · 41 ms
- 56ask_knowledge{"question":"Where does atopic dermatitis usually appear in adults?"}grounded · 2 citations · 813 ms
- 872search_evidence{"include_full_text":true}403 evidence:full_text
- 885audittrc_YfkUkCYqEk5 events written
Source to snapshot
A source answers questions only after its license, extraction and evaluation pass. Each release is an immutable snapshot you can pin.
- Acquirechecksums
- Rightslicense check
- Extractlocators
- NormalizeICD codes
- Indexlexical+vector
- Evaluaterelease gates
- Snapshotkv_2026_10_01
Typed, in your language
TypeScript and Python clients with the same methods and the same errors, generated from one OpenAPI contract.
- MCP
https://api.dermliving.com/mcp
The TypeScript and Python clients aren't on npm or PyPI yet. Every route is plain HTTPS, so curl works today.
- Typed responses and errors
- Retries with jitter
- Cursor pagination
- Timeouts
- Version pinning
1import { DermLiving } from "@dermliving/sdk";
2
3const derm = new DermLiving();
4
5const answer = await derm.knowledge.ask({
6 question: "Where does atopic dermatitis usually appear in adults?",
7 knowledgeVersion: "kv_2026_10_01",
8});
9
10if (answer.status === "grounded") {
11 for (const c of answer.citations) console.log(c.locator, c.checksum);
12} else {
13 console.log("abstained:", answer.reason);
14}
What teams build
Products that need dermatology knowledge they can defend: in front of clinicians, students and reviewers.
Clinical reference copilots
Reference answers clinicians can check.
POST /knowledge/askPOST /evidence/searchDocumentation and coding
Clinical language to ICD-10-CM and ICD-11.
GET /terminology/mapGET /conditions/{id}Medical education
Morphology taught from versioned sources.
GET /conditionsPOST /knowledge/askResearch discovery
Evidence search with citable provenance.
POST /evidence/searchGET /sources/{id}Agent workflows
Scoped dermatology tools over MCP.
MCP server5 read-only tools
Reference, not judgment
DermLiving informs software. Clinical decisions stay with qualified professionals, and the API says so in its responses.
Returns
- Structured condition records
- Ranked passages with provenance
- Answers with claim-level citations
- Terminology maps with ambiguity flags
- Pinned, immutable knowledge versions
Abstains, with a reason
- Diagnosing a patient
clinical_decision - Choosing or dosing treatment
clinical_decision - Triage or malignancy scoring
clinical_decision - Answering beyond its sources
insufficient_evidence - Accepting patient records
patient_data
| Gate | Measures | Threshold |
|---|---|---|
| Citation validity | Every citation resolves to a real passage | ≥ 99% |
| Claim grounding | Claims supported by their cited passage | ≥ 95% |
| Curated recall | Relevant passages found in the top 10 | ≥ 95% |
| Correct abstention | Out-of-scope questions abstain | ≥ 95% |
| Cross-tenant exposure | Adversarial suite, every release | 0 |
| Unauthorized tool runs | Adversarial suite, every release | 0 |
Start free, pay for answers
The sandbox is free. Paid plans add licensed knowledge and bill usage, and abstentions are never billed as answers.
Start in the sandbox.
The whole API on synthetic data. No key, no card, no patient data.