Skip to content
MCP server

Oorep MCP

Search homeopathic repertories and materia medica from an AI assistant or TypeScript code

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, API, macOS
Runs
Locally
Version
1.2.6
Listing updated
today

Similar MCP servers

About Oorep MCP

Oorep MCP is an open-source MCP server for health and science. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

claude mcp add oorep-mcp -- npx -y oorep-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "oorep-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "oorep-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "oorep-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "oorep-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (3)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Open source

MIT-licensed; free to run

Oorep MCP 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.

How AIPoweredBot checks servers