SkillAgentSearch skills...

oorep-mcp

Model Context Protocol (MCP) server and client SDK that provides AI assistants with access to OOREP (Open Online Repertory) - a comprehensive homeopathic repertory and materia medica database.

Install / Use

claude mcp add Dhi13man -- npx -y github:Dhi13man/oorep-mcp

If the server publishes to npm under a different name, use that package instead — check the repo README.

About this skill
🔌

MCP Server

Model Context Protocol server

Quality Score

83/100

Supported Platforms

Claude Code
Claude Desktop

Our assessment of oorep-mcp

oorep-mcp scores 83/100 on our quality scale, 482nd of 598 Data & Analytics skills we index.

Its MCP Server is 24 KB long, well organised into 77 sections with 33 code examples: a thorough specification that gives an agent plenty to work with.

It has 3 GitHub stars, so there is little community track record yet; judge it on its content.

Substance
30/30
Structure
20/20
Description
15/15
Adoption
3/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated 3 days ago, so oorep-mcp is actively maintained.
  • Our last check on 2026-09-06 found the source still online.
  • It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
  • Its trust signals score 92/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.

AI review by kimi-k2.7-code on 2026-10-06. Automated pattern scan on 2026-10-06. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

oorep-mcp compared with similar skills

All 4 of these similar skills score higher than oorep-mcp; compare them before choosing.

SkillScoreStarsUpdatedFormat
oorep-mcp (this skill)by Dhi13man8333d agoMCP Server
Agent-Reachby Panniantong100114.0ktodayCLAUDE.md
hyperframesby heygen-com10088.2ktodayCLAUDE.md
rufloby ruvnet10082.3ktodayCLAUDE.md
headroomby headroomlabs-ai10080.5ktodayCLAUDE.md

Frequently asked questions

How do I install oorep-mcp?
Run claude mcp add Dhi13man -- npx -y github:Dhi13man/oorep-mcp. The install tabs above show the steps for each supported agent.
Which AI agents does oorep-mcp work with?
It is written for Claude Code and Claude Desktop, as a MCP Server file. Other agents that read the same format can often use it too.
Is oorep-mcp safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 92/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is oorep-mcp still maintained?
The repository was last updated 3 days ago, so oorep-mcp is actively maintained.

OOREP MCP Server

npm version CI CodeQL OpenSSF Scorecard License: MIT

An MCP server and TypeScript client SDK that gives AI assistants access to OOREP's homeopathic repertory and materia medica reference data.

TL;DR

# Install and run (no setup required)
npx -y oorep-mcp
// Or use programmatically
import { createOOREPClient } from 'oorep-mcp';

const client = createOOREPClient();
const results = await client.searchRepertory({ symptom: 'headache worse motion' });
console.log(results.rubrics);
client.destroy();

Ask your AI assistant: "Search OOREP for remedies for throbbing headache worse from light"

What is OOREP?

OOREP (Open Online Repertory) is an open-source homeopathic database containing:

  • 12+ Repertories - Systematic indexes of symptoms mapped to remedies (Kent, Boger, Boericke, etc.)
  • Multiple Materia Medicas - Detailed remedy descriptions and therapeutic indications
  • 600+ Remedies - Comprehensive remedy database with names, abbreviations, and alternates

How Homeopathic Data is Structured

graph TB
    subgraph Repertory[Repertory Structure]
        Chapter[Chapter<br/>e.g. Head]
        Rubric[Rubric<br/>e.g. Pain - Throbbing]
        R1[Belladonna - 4]
        R2[Glonoine - 3]
        R3[Natrum mur - 2]
        Chapter --> Rubric
        Rubric --> R1
        Rubric --> R2
        Rubric --> R3
    end

    subgraph MateriaMedica[Materia Medica Structure]
        Remedy[Remedy<br/>e.g. Belladonna]
        S1[Mind: Sudden onset...]
        S2[Head: Throbbing pain...]
        S3[...]
        Remedy --> S1
        Remedy --> S2
        Remedy --> S3
    end

This MCP server enables AI assistants to query this data programmatically.

Features

| Feature | Description | |---------|-------------| | Search Repertories | Query symptoms across 12+ repertories, get matching rubrics with weighted remedies | | Search Materia Medicas | Find remedy descriptions and indications from multiple sources | | Remedy Information | Get comprehensive details for 600+ remedies | | List Resources | Browse available repertories, materia medicas, and remedies | | Guided Workflows | Prompts for symptom analysis, remedy comparison, case repertorization | | Structured Responses | MCP 2025-06-18 compliant with outputSchema and structuredContent | | Performance | Built-in caching (5min TTL), request deduplication, automatic retries | | Type Safety | Full TypeScript with Zod validation on all inputs | | Security | Input sanitization, error message sanitization, no credentials required | | SDK Adapters | Direct integration with OpenAI, Vercel AI SDK, LangChain, Google Gemini |

Quick Start

Requires Node.js 22.12 or newer with npm/npx.

1. Add to Claude Desktop

macOS: Edit ~/Library/Application Support/Claude/claude_desktop_config.json Windows: Edit %APPDATA%\Claude\claude_desktop_config.json

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

2. Restart Claude Desktop

Quit completely (Cmd+Q / Alt+F4), then reopen.

3. Start Using

You: "Search OOREP for remedies for headache worse at night"

Claude will:

  1. Call search_repertory with symptom "headache worse night"
  2. Return matching rubrics with remedies and their weights
  3. Explain the results in context

Installation

NPX (Recommended)

No installation required:

npx -y oorep-mcp

npm Global

npm install -g oorep-mcp
oorep-mcp

npm Local (for SDK usage)

npm install oorep-mcp

Platform Configuration

Claude Code

Option A: CLI

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

Option B: Config file (~/.claude.json)

{
  "mcpServers": {
    "oorep": {
      "command": "npx",
      "args": ["-y", "oorep-mcp"],
      "env": {
        "OOREP_MCP_BASE_URL": "https://www.oorep.com",
        "OOREP_MCP_LOG_LEVEL": "info"
      }
    }
  }
}

Verify: Run /mcp in Claude Code

Claude Desktop

Config locations:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "oorep": {
      "command": "npx",
      "args": ["-y", "oorep-mcp"],
      "env": {
        "OOREP_MCP_BASE_URL": "https://www.oorep.com",
        "OOREP_MCP_LOG_LEVEL": "info"
      }
    }
  }
}

Important: Quit completely (Cmd+Q), not just close window.

Codex CLI

Config: ~/.codex/config.toml (macOS/Linux) or C:\Users\<Username>\.codex\config.toml (Windows)

[mcp_servers.oorep]
command = "npx"
args = ["-y", "oorep-mcp"]
startup_timeout_sec = 15.0
tool_timeout_sec = 60.0

[mcp_servers.oorep.env]
OOREP_MCP_BASE_URL = "https://www.oorep.com"
OOREP_MCP_LOG_LEVEL = "info"

Or via CLI:

codex mcp add oorep --env OOREP_MCP_BASE_URL=https://www.oorep.com --env OOREP_MCP_LOG_LEVEL=info -- npx -y oorep-mcp

Verify: Run codex mcp list

Gemini CLI

Config: ~/.gemini/settings.json

{
  "mcpServers": {
    "oorep": {
      "command": "npx",
      "args": ["-y", "oorep-mcp"],
      "env": {
        "OOREP_MCP_BASE_URL": "https://www.oorep.com",
        "OOREP_MCP_LOG_LEVEL": "info"
      },
      "timeout": 30000
    }
  }
}

Usage Examples

Once installed, you can interact with OOREP through Claude naturally:

Searching for Remedies

You: "Can you search OOREP for remedies for headache that's worse at night?"

Claude will:

  1. Use the search_repertory tool
  2. Search for "headache worse night" in the default repertory
  3. Return matching rubrics with remedy recommendations and their weights

Getting Detailed Remedy Information

You: "Tell me more about Aconite - what conditions is it used for?"

Claude will:

  1. Use the get_remedy_info tool to fetch details about Aconite
  2. Provide information about its common uses, characteristics, and therapeutic applications

Comparing Remedies

You: "Compare Aconite and Belladonna for fever symptoms"

Claude will:

  1. Use the remedy-comparison prompt
  2. Search materia medicas for both remedies
  3. Provide a side-by-side comparison focusing on fever symptoms
  4. Highlight key differentiating factors

Case Repertorization

You: "I want to repertorize a case with these symptoms: anxiety, palpitations, and insomnia"

Claude will:

  1. Use the repertorization-workflow prompt
  2. Guide you through systematic symptom analysis
  3. Search relevant rubrics for each symptom
  4. Help synthesize results to identify well-indicated remedies

Browsing Available Resources

You: "What repertories are available in OOREP?"

Claude will:

  1. Use the list_available_repertories tool
  2. Show all 12+ available repertories with their names and descriptions

API Reference

Tools

search_repertory

Search for symptoms in homeopathic repertories.

Parameters:

| Name | Type | Required | Default | Description | |------|------|----------|---------|-------------| | symptom | string | Yes | - | Symptom to search (3-200 chars). Supports wildcards. | | repertory | string | No | publicum | Repertory abbreviation (e.g., kent, boger) | | minWeight | number | No | 1 | Minimum remedy weight (1-4) | | maxResults | number | No | 20 | Maximum rubrics to return (1-100) | | includeRemedyStats | boolean | No | true | Include aggregated remedy statistics |

Returns:

{
  totalResults: number;
  rubrics: Array<{
    rubric: string;           // Full path: "Head > Pain > Throbbing"
    text: string | null;      // Additional rubric text
    repertory: string;        // Repertory abbreviation
    remedies: Array<{
      name: string;           // Full name: "Belladonna"
      abbreviation: string;   // "Bell."
      weight: number;         // 1-4
    }>;
  }>;
  remedyStats?: Array<{       // If includeRemedyStats=true
    name: string;
    abbreviation: string;
    count: number;            // Times appearing
    cumulativeWeight: number; // Sum of weights
  }>;
}

search_materia_medica

Search materia medica texts for remedy descriptions.

Parameters:

| Name | Type | Required | Default | Description | |------|------|----------|---------|-------------| | symptom | string | Yes | - | Symptom to search (3-200 chars) | | materiamedica | string | No | boericke | Materia medica abbreviation | | remedy | string | No | - | Filter to specific remedy | | maxResults | number | No | 10 | Maximum results (1-50) |

Returns:

{
  totalResults: number;
  results: Array<{
    remedy: string;           // "Aconitum napellus"
    materiaMedica: string;    // "boericke"
    sections: Array<{
      heading: string;        // "Mind", "Head", etc.
      content: string;        // Section text
      depth: number;          // Heading depth
    }>;
  }>;
}

get_remedy_info

Get detailed information about a specific remedy.

Parameters:

| Name | Type | Required | Description | |------|------|----------|-------------| | remedy | string | Yes | Remedy name, abbreviation, or alternate name (1-100 chars) |

Returns:

{
  id: number;
  nameAbbrev: string;    // "Acon."
  nameLong: string;      // "Aconitum napellus"
  namealt: string[];     // ["Aconite", "Monkshood"]
} | null  // null if not found

Matching behavior:

  • Exact match on abbreviation, long name, or alternate names (case-insensitive)
  • Partial match for queries ≥3 characters

list_available_repertories

List all accessible repertories.

Parameters:

| Name | Type | Required | Description | |------|------|----------|-------------| | language | string | No | Filter by language code (e.g., en, de) |

Returns:

Array<{
  abbreviation: string;  // "kent"
  title: string;         // "Kent Repertory"
  author: string;        // "James Tyler Kent"
  language: string;      // "en"
}>

list_available_materia_medicas

List all accessible materia medica texts.

Parameters:

| Name | Type | Required | Description | |------|------|----------|-------------| | language | string | No | Filter by language code |

Returns:

Array<{
  abbreviation: string;  // "boericke"
  title: string;         // "Boericke Materia Medica"
  author: string;        // "William Boericke"
  language: string;      // "en"
}>

Structured Response Format

All tools support the MCP 2025-06-18 specification with structured responses:

Response Structure:

{
  // Text content for backwards compatibility
  content: [{
    type: 'text',
    text: '{"totalResults": 42, "rubrics": [...]}' // JSON string
  }],

  // Machine-parseable structured content
  structuredContent: {
    totalResults: 42,
    rubrics: [...]  // Actual JavaScript object
  }
}

Benefits:

  • outputSchema: Each tool definition includes a JSON Schema defining the expected output structure
  • structuredContent: Direct access to typed results without JSON parsing
  • Backwards Compatible: Text content always included for older clients
  • Error Handling: Errors return isError: true for LLM self-corr

Truncated for display — read the full file on GitHub.

Related Skills

View on GitHub
GitHub Stars3
CategoryData
Updated3d ago
Forks1

Languages

TypeScript

Trust signals

92/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

1 low