MyMenopauseRx Admin MCP

MCP server for managing intake & EMR questions, billing wizard rules, provider directory profiles, business metrics, and clinical knowledge.

Setup

Claude Desktop

Open Settings → Developer → Edit Config and add to claude_desktop_config.json:

{
  "mymenopauserx-admin": {
    "command": "/opt/homebrew/bin/node",
    "args": [
      "/opt/homebrew/lib/node_modules/npm/bin/npx-cli.js",
      "-y",
      "mcp-remote",
      "https://mcp.mymenopauserx.com/api/mcp",
      "--header",
      "Authorization: Bearer YOUR_API_TOKEN"
    ],
    "env": {
      "PATH": "/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin"
    }
  }
}

Claude Code

claude mcp add mymenopauserx-admin \
  --transport http \
  --url https://mcp.mymenopauserx.com/api/mcp \
  --header "Authorization: Bearer YOUR_API_TOKEN"

Authentication

Replace YOUR_API_TOKEN with your MyMenopauseRx API bearer token. The token is configured once in your MCP client settings and passed automatically with every tool call.

How It Works

All question tools accept a type parameter: "intake" or "emr". Start with list_categories to see what exists, then get_category to drill into a specific one. To make changes, call create_question_draft, pass its draftId to as many mutation tools as you need, review with get_question_draft, then publish_question_draft. Nothing goes live until publish. Mutations apply one change to the draft — you never need to send the full payload.

Available Tools

Reading

list_categoriesList all categories with IDs, names, and question counts (compact)

get_categoryGet a single category by ID with all its questions

Drafts

create_question_draftCopy the active version into an inactive draft; returns draftId and baseVersionId

get_question_draftReview a draft before publishing (summary or full)

publish_question_draftMake a draft the live version; refuses if another version went live since baseVersionId. With force, also rolls back to any older version

Category Management

update_categoryUpdate a category's name, description, help text, or appointment types in a draft

add_categoryAdd a new category to a draft

remove_categoryRemove a category from a draft

Question Management

add_questionAdd a question to a category in a draft

edit_questionEdit specific fields on a question in a draft

remove_questionRemove a question from a category in a draft

Versioning

list_versionsList all question set versions (compact metadata); roll back by publishing an older id with force

Appointment Types

list_appointment_typesList appointment types with their numeric IDs (for category appointmentTypeIds and per-type billing rules)

Billing Wizard: Definition

get_billing_wizard_definitionReturn the active billing wizard question list and default diagnosis

get_billing_wizard_definition_historyList every saved definition version, newest first

validate_billing_wizard_definitionDry-run a definition payload without persisting

put_billing_wizard_definitionReplace and activate the definition in one shot (prefer the draft flow)

get_or_create_billing_wizard_definition_draftGet the caller's definition draft, or create one from the active version

list_billing_wizard_definition_draftsList the caller's definition drafts

put_billing_wizard_definition_draftReplace a definition draft's questions

publish_billing_wizard_definition_draftPromote a definition draft to the active version (revalidates rules)

discard_billing_wizard_definition_draftDelete a definition draft

Billing Wizard: Rules

list_billing_wizard_global_rulesReturn every global rule (applies to all appointment types)

list_billing_wizard_rules_for_typeReturn the rules scoped to one appointment type

get_effective_billing_wizard_rulesMerged global + per-type rules in runtime evaluation order

list_billing_wizard_global_rules_historyAudit trail of global rule rows, active and superseded

list_billing_wizard_rules_history_for_typeAudit trail of per-type rule rows, active and superseded

validate_billing_wizard_global_rulesDry-run a global rule payload without persisting

validate_billing_wizard_rules_for_typeDry-run a per-type rule payload without persisting

put_billing_wizard_global_rulesReplace the global rule set in one shot (prefer the draft flow)

put_billing_wizard_rules_for_typeReplace one appointment type's rule set in one shot (prefer the draft flow)

Billing Wizard: Rule Drafts

get_or_create_billing_wizard_global_rules_draftGet the caller's global-rules draft, or create one from the active set

get_billing_wizard_global_rules_draftRead the caller's global-rules draft without creating one

put_billing_wizard_global_rules_draftReplace the caller's global-rules draft

publish_billing_wizard_global_rules_draftPromote the global-rules draft to active (validates against the definition)

discard_billing_wizard_global_rules_draftDelete the caller's global-rules draft

get_or_create_billing_wizard_rules_draft_for_typeGet the caller's per-type rules draft, or create one from the active set

get_billing_wizard_rules_draft_for_typeRead the caller's per-type rules draft without creating one

put_billing_wizard_rules_draft_for_typeReplace the caller's per-type rules draft

publish_billing_wizard_rules_draft_for_typePromote the per-type rules draft to active (validates against the definition)

discard_billing_wizard_rules_draft_for_typeDelete the caller's per-type rules draft

Provider Directory

list_provider_directory_profilesList every provider's public-directory profile, each with a readiness block

get_provider_directory_profileGet one provider's public-directory profile by numeric provider ID

put_provider_directory_profileCreate or replace a provider's public-directory profile (whole-object PUT)

Clinical Knowledge

knowledge_agentAsk evidence-based clinical questions about menopause, HRT, and treatments

knowledge_agent_searchSearch the clinical knowledge base and return raw matching passages with sources

Metrics

metricsQuery business metrics (appointments, patients, providers, revenue, labs, conversations, operational). Pass a metric name and optional date range.