# Oorep MCP

> Oorep MCP is an open-source MCP server for health and science. Search homeopathic repertories and materia medica from an AI assistant or TypeScript code. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API, macOS, Windows, Linux
- **Repository:** https://github.com/dhi13man/oorep-mcp
- **MCP Registry name:** io.github.Dhi13man/oorep-mcp
- **Categories:** [health and science](https://ai-powered.com/categories/health-and-science)
- **Listing updated:** 2026-11-18

## About

This server queries OOREP, the Open Online Repertory, an open-source homeopathic database. The README describes 12+ repertories (such as Kent, Boger and Boericke), several materia medicas and 600+ remedies. A repertory search takes a symptom, an optional repertory abbreviation (default publicum), a minimum remedy weight from 1 to 4 and a result cap, and returns matching rubrics with weighted remedies.

Guided prompts cover symptom analysis, remedy comparison and case repertorization. Inputs are validated with Zod and sanitised, responses are structured with outputSchema, and results are cached for five minutes with request deduplication and automatic retries. No credentials are needed.

The package also works as a TypeScript client, with adapters for OpenAI, the Vercel AI SDK, LangChain and Google Gemini. It needs Node.js 22.12 or newer and is MIT licensed. It returns reference data from a traditional-practice database and does not itself assess whether any remedy works.

## Features

- **Repertory search:** Finds rubrics and weighted remedies for a symptom across 12+ repertories.
- **Materia medica search:** Returns remedy descriptions and indications from multiple sources.
- **Remedy details:** Gives information on 600+ remedies, including names and alternates.
- **Guided prompts:** Prompts for remedy comparison and case repertorization.
- **TypeScript SDK:** createOOREPClient() plus adapters for OpenAI, Vercel AI SDK, LangChain and Gemini.
- **Caching and retries:** Five-minute cache, request deduplication and automatic retries.

## Good for

- Look up rubrics for a symptom in the Kent repertory
- Compare two remedies from their materia medica entries
- Work through a repertorization with step-by-step prompts
- Embed OOREP lookups in a TypeScript or LangChain app

## Install

### Claude Code (Terminal)

```sh
claude mcp add oorep-mcp -- npx -y oorep-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "oorep-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "oorep-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "oorep-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "oorep-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "oorep-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "oorep-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "oorep-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "oorep-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "oorep-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "oorep-mcp"
      ]
    }
  }
}
```

## Tools

- `search_repertory`: Searches symptoms in homeopathic repertories and returns rubrics with weighted remedies.
- `get_remedy_info`: Fetches details about a remedy.
- `list_available_repertories`: Lists the repertories available in OOREP.

## FAQ

### Does it need an account or key?

No. The README says no credentials are required.

### What does it need to run?

Node.js 22.12 or newer; start it with npx -y oorep-mcp.

### Which tools does it expose?

search_repertory, get_remedy_info and list_available_repertories are named in the README, plus guided prompts.

### Can I set the data source?

Yes, OOREP_MCP_BASE_URL defaults to https://www.oorep.com.

### What licence is it?

MIT.

### Is Oorep MCP free?

Yes. Oorep MCP is open source, so you can use and self-host it for free.

### How do I add Oorep MCP to Claude Code?

Run this command in your terminal: claude mcp add oorep-mcp -- npx -y oorep-mcp

### What are the best alternatives to Oorep MCP?

The closest alternatives to Oorep MCP are Tooluniverse, Oya Browser, BasalFit, Ebi Ols and Clinicaltables.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Tooluniverse](https://ai-powered.com/mcp/tooluniverse): Tooluniverse is an open-source MCP server for health and science.
- [Oya Browser](https://ai-powered.com/mcp/oya-browser): Oya Browser is a freemium MCP server for browser automation.
- [BasalFit](https://ai-powered.com/mcp/basalfit): BasalFit is a free MCP server for health and science.
- [Ebi Ols](https://ai-powered.com/mcp/ebi-ols): Ebi Ols is a freemium MCP server for health and science.
- [Clinicaltables](https://ai-powered.com/mcp/clinicaltables): Clinicaltables is a freemium MCP server for health and science.
- [Complex Portal](https://ai-powered.com/mcp/complex-portal): Complex Portal is a freemium MCP server for health and science.
- [Idigbio](https://ai-powered.com/mcp/idigbio): Idigbio is a freemium MCP server for health and science.
- [Ensembl](https://ai-powered.com/mcp/ensembl): Ensembl is a freemium MCP server for health and science.

---
Source: https://ai-powered.com/mcp/oorep-mcp
