# Mayo Clinic API

> Mayo Clinic returns condition, symptom, cause, diagnosis and treatment information, available as a workflow and API.

Mayo Clinic’s Get condition returns condition overviews from a disease or condition name, including symptoms, causes and risks when available. Get diagnosis and treatment returns diagnosis, care options and appointment preparation for a condition with a matching page.

- Page: https://fous.com/tools/mayo-clinic
- Handle: `@mayo-clinic`
- Category: [Health](https://fous.com/tools/category/health)
- Source website: https://mayoclinic.org
- Last verified: Sep 28, 2026

## Methods

### Get condition

Operation `get_condition`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

Get a Mayo Clinic disease or condition overview, including symptoms, causes, when to see a doctor, risk factors, complications and prevention when available. Only public condition pages are included.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `condition` | string | yes | `"shingles"` | Disease or condition name in plain words, such as shingles or high blood pressure. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "condition"
  ],
  "properties": {
    "condition": {
      "type": "string",
      "description": "Disease or condition name in plain words, such as shingles or high blood pressure.",
      "examples": [
        "shingles",
        "high blood pressure",
        "appendicitis"
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "condition": "shingles"
    },
    {
      "condition": "high blood pressure"
    },
    {
      "condition": "appendicitis"
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `causes` | string or null | `"A blockage in the lining of the appendix, called the lumen, is the likely cause of appendicitis. This blockage can caus` | Causes in plain text. |
| `overview` | string or null |  | Overview of the condition in plain text. |
| `symptoms` | array |  | Symptoms in plain text. |
| `page_link` | string | `"https://www.mayoclinic.org/diseases-conditions/shingles/symptoms-causes/syc-20353054"` | Link to the Mayo Clinic condition page. |
| `prevention` | string or null |  | Prevention in plain text, or null if no prevention section exists. |
| `risk_factors` | array |  | Risk factors in plain text. |
| `complications` | string or null |  | Complications in plain text. |
| `condition_name` | string | `"Shingles"` | Name shown on the condition page. |
| `when_to_see_a_doctor` | string or null | `"Contact your health care provider as soon as possible if you suspect shingles, especially in the following situations:\` | When to see a doctor in plain text. |

**Example input**

```json
{
  "condition": "shingles"
}
```

**Example output**

```json
{
  "causes": "Shingles is caused by the varicella-zoster virus — the same virus that causes chickenpox. Anyone who's had chickenpox may develop shingles. After you recover from chickenpox, the virus enters your ner…",
  "overview": "Shingles is a viral infection that causes a painful rash. Shingles can occur anywhere on your body. It typically looks like a single stripe of blisters that wraps around the left side or the right sid…",
  "symptoms": [
    "Pain, burning or tingling",
    "Sensitivity to touch",
    "A red rash that begins a few days after the pain"
  ],
  "page_link": "https://www.mayoclinic.org/diseases-conditions/shingles/symptoms-causes/syc-20353054",
  "prevention": "A shingles vaccine may help prevent shingles. People who are eligible should get the Shingrix vaccine, which has been available in the United States since its approval by the Food and Drug Administrat…",
  "risk_factors": [
    "Age. The risk of developing shingles increases with age. Shingles typically occurs in people older than 50. And people over the age of 60 are more likely to experience more-severe complications.",
    "Some diseases. Diseases that weaken your immune system, such as HIV/AIDS and cancer, can increase your risk of shingles.",
    "Cancer treatments. Radiation or chemotherapy can lower your resistance to diseases and may trigger shingles."
  ],
  "complications": "Complications from shingles can include:\n\nPostherpetic neuralgia. For some people, shingles pain continues long after the blisters have cleared. This condition is known as postherpetic neuralgia. It o…",
  "condition_name": "Shingles",
  "when_to_see_a_doctor": "Contact your health care provider as soon as possible if you suspect shingles, especially in the following situations:\n\nThe pain and rash occur near an eye. If left untreated, this infection may lead …"
}
```

### Get diagnosis and treatment

Operation `get_diagnosis_and_treatment`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

Get diagnosis, treatment, home care, alternative medicine and appointment preparation for a Mayo Clinic condition. Only conditions with a matching diagnosis and treatment page are available.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `condition` | string | yes | `"type 2 diabetes"` | Condition name in plain words, for example type 2 diabetes. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "condition"
  ],
  "properties": {
    "condition": {
      "type": "string",
      "description": "Condition name in plain words, for example type 2 diabetes.",
      "examples": [
        "type 2 diabetes",
        "asthma",
        "migraine"
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "condition": "type 2 diabetes"
    },
    {
      "condition": "asthma"
    },
    {
      "condition": "migraine"
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `diagnosis` | string or null | `"A healthcare professional examines your arm for tenderness, swelling, unusual positioning and open wounds. You're asked` | Tests and exams with explanations from the diagnosis section, or null if absent. |
| `page_link` | string | `"https://www.mayoclinic.org/diseases-conditions/type-2-diabetes/diagnosis-treatment/drc-20351199"` | Link to Mayo Clinic diagnosis and treatment page. |
| `condition_name` | string | `"Type 2 diabetes"` | Name of the condition on Mayo Clinic. |
| `treatment_options` | string or null |  | Treatment options and explanations, or null if absent. |
| `alternative_medicine` | string or null |  | Alternative medicine, or null if absent. |
| `lifestyle_and_home_remedies` | string or null |  | Lifestyle and home remedies, or null if absent. |
| `preparing_for_your_appointment` | string or null |  | Appointment preparation, or null if absent. |

**Example input**

```json
{
  "condition": "type 2 diabetes"
}
```

**Example output**

```json
{
  "diagnosis": "The glycated hemoglobin test most often diagnoses type 2 diabetes. Also called the A1C test, it reflects the average blood sugar level for the past two to three months. Results mean the following:\n• B…",
  "page_link": "https://www.mayoclinic.org/diseases-conditions/type-2-diabetes/diagnosis-treatment/drc-20351199",
  "condition_name": "Type 2 diabetes",
  "treatment_options": "Living with type 2 diabetes involves learning about the condition and lifestyle changes. Diabetes education is an important part of managing the condition. Management includes:\n• Healthy eating.\n• Reg…",
  "alternative_medicine": "Many alternative medicine treatments claim to help people living with diabetes. The National Center for Complementary and Integrative Health says studies haven't shown enough proof for any alternative…",
  "lifestyle_and_home_remedies": "Careful management of type 2 diabetes can lower the risk of serious, or even life-threatening complications. Try these tips:\n• Commit to managing your diabetes. Learn all you can about type 2 diabetes…",
  "preparing_for_your_appointment": "Your annual wellness visit can include screening for diabetes. And it can include watching for and treating conditions that raise your risk of diabetes. These include high blood pressure, high cholest…"
}
```

## Quick start

Replace `YOUR_API_KEY` with a Fous API key. To create one, open Developers at the bottom of Fous Studio, turn on Developer mode, then go to API keys (https://app.fous.com/keys). Change the values in `input` to run the same tool on new data.

```bash
curl 'https://api.fous.com/v1/query' \
  --fail-with-body --silent --show-error --max-time 180 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "api": "@mayo-clinic",
  "visibility": "public",
  "operation": "get_condition",
  "version": 1,
  "input": {
    "condition": "shingles"
  },
  "response": {
    "format": "json"
  }
}'
```

```python
# Save as fous.py and run with python3 fous.py. No packages needed.
import json
import urllib.error
import urllib.request

api_key = "YOUR_API_KEY"

body = json.loads("{\n  \"api\": \"@mayo-clinic\",\n  \"visibility\": \"public\",\n  \"operation\": \"get_condition\",\n  \"version\": 1,\n  \"input\": {\n    \"condition\": \"shingles\"\n  },\n  \"response\": {\n    \"format\": \"json\"\n  }\n}")
request = urllib.request.Request(
    "https://api.fous.com/v1/query",
    data=json.dumps(body).encode("utf-8"),
    headers={
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json",
    },
    method="POST",
)
try:
    with urllib.request.urlopen(request, timeout=180) as response:
        result = json.load(response)
except urllib.error.HTTPError as error:
    raise RuntimeError(f"HTTP {error.code}: {error.read().decode('utf-8', errors='replace')}") from error
if result.get("success") is False:
    raise RuntimeError(result.get("error", {}).get("message", "Request failed"))
print(json.dumps(result["data"]["output"], indent=2))
```

```typescript
// Save as fous.mts and run with npx tsx fous.mts.
const apiKey = "YOUR_API_KEY";

const response = await fetch("https://api.fous.com/v1/query", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  signal: AbortSignal.timeout(180_000),
  body: JSON.stringify({
  "api": "@mayo-clinic",
  "visibility": "public",
  "operation": "get_condition",
  "version": 1,
  "input": {
    "condition": "shingles"
  },
  "response": {
    "format": "json"
  }
}),
});
type ApiResult = { success: boolean; data?: { output: unknown }; error?: { message: string } };
const result: ApiResult = await response.json();
if (!response.ok || result.success === false) {
  throw new Error(result.error?.message ?? `HTTP ${response.status}`);
}
if (!result.data) throw new Error("Missing API response data");
console.log(result.data.output);
```

## Use from an AI assistant

Connect this tool to Claude Code, Claude Desktop, Cursor, VS Code, Codex and any MCP client as its own MCP server. Each method is a typed tool whose arguments are the method’s input.

- Server URL: `https://api.fous.com/mcp/tools/mayo-clinic`
- Authorization: `Authorization: Bearer <Fous API key>`

**Tools**

- `get_condition`: Get condition. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `get_diagnosis_and_treatment`: Get diagnosis and treatment. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `fous_get_run`: the result of a run that was still going, by its `request_id`. Free.

Claude Code:

```bash
claude mcp add --scope user --transport http fous-mayo-clinic https://api.fous.com/mcp/tools/mayo-clinic --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"
```

To give the assistant every tool, connect `https://api.fous.com/mcp`: it finds one with `fous_search_tools` and runs it with `fous_run_tool`. Setup for other clients: https://fous.com/llms-full.txt.

## Use cases

- Review symptoms and causes for a condition
- Identify possible risk factors and complications
- Compare diagnosis and treatment information
- Prepare for a medical appointment
- Find home care and alternative medicine information

## FAQ

### Can I run it with my own inputs?

Yes. Change the inputs in Studio and press Run, or send new inputs from your code, or ask a connected AI assistant.

### Can I call this Mayo Clinic tool as an API?

Yes. Send a POST request to /v1/query with your Fous API key and the inputs, and get JSON back.

### How much does it cost?

Each completed run costs 1 credit. Failed runs without a completed receipt are free; completed work can remain charged if delivery is interrupted. With pay as you go, a credit costs 1¢. Monthly plans cost less per credit.

### Do I need a Mayo Clinic account?

No. You only need a Fous account.

### How current is the data?

Fous gets the data from mayoclinic.org when you run it. Some results are reused for up to 24 hours, and results that use your account or key are never reused. It was last verified on Sep 28, 2026.

### What symptoms and causes are listed for a condition?

Get condition returns symptoms, causes and other condition overview details.

### What diagnosis and treatment information is available?

Get diagnosis and treatment returns diagnosis details and treatment options when available.

### How can I prepare for an appointment?

Get diagnosis and treatment returns appointment preparation information when available.

## Related

- [WebMD API](https://fous.com/tools/webmd.md): Plain-language health condition and symptom guides from WebMD.
- [NHS API](https://fous.com/tools/nhs.md): NHS provides condition and medicine guidance, with condition dates reflecting the latest pages used, and nearby England service listings ordered by distance; availability details may be missing.
- [MedlinePlus API](https://fous.com/tools/medlineplus.md): MedlinePlus provides health information from the U.S. National Library of Medicine, including condition and symptom overviews and explanations of tests with matching pages.
- [NLM Clinical Tables API](https://fous.com/tools/nlm-clinical-tables.md): NLM Clinical Tables provides public clinical terminology tables, with diagnosis searches that may miss relevant codes and code explanations checked against current NLM and official classification sources.
- [CDC API](https://fous.com/tools/cdc.md): CDC provides disease facts, age-based vaccine guidance, current travel notices, and destination-specific travel health recommendations; review dates appear only when CDC supplies them.
- [ClinicalTrials.gov API](https://fous.com/tools/clinicaltrials-gov.md): ClinicalTrials.gov helps users find studies and view public trial records, including sponsor-run or funded studies; site distances are approximate, and contacts, eligibility, or exact dates may be missing.
- [Drugs.com API](https://fous.com/tools/drugs-com.md): Drugs.com provides public medicine guides, interaction and food or lifestyle warnings for 2–10 medicines, pill matches by imprint, color, or shape, and listed US cash prices by strength, form, and quantity.
- [World Health Organization API](https://fous.com/tools/world-health-organization.md): The World Health Organization provides public health information, latest outbreak reports, country health statistics with up to 10 years of history when available, and topic fact sheets.
- [All Health tools](https://fous.com/tools/category/health)