GetPracticeHelp

搜尋全美超過103,000位經認證的醫療從業人員與心理健康提供者

GitHub
1

文件

GPH Intelligence - Healthcare Vendor Finder

An MCP server that gives AI agents access to 76,000+ curated healthcare service vendors across the United States. Built for practice managers, healthcare AI developers, and anyone building tools for the medical practice market.

What It Does

The GPH Intelligence MCP server provides structured access to GetPracticeHelp's database of healthcare service vendors -- medical billing companies, credentialing services, EHR consultants, healthcare attorneys, compliance firms, and more -- across 25 categories and all 50 states.

Tools

match_practice

Find the best healthcare service vendors for a medical practice based on specialty, size, location, EHR system, and budget. Returns ranked matches with profile-completeness scores.

Parameters:

  • category (required) -- Service category (e.g. "Medical Billing & RCM", "Credentialing Services")
  • state (required) -- Two-letter state abbreviation (e.g. "TX", "CA")
  • specialty -- Practice specialty (e.g. "Family Medicine", "Cardiology")
  • practice_size -- "Solo", "Small", "Mid-size", or "Large"
  • city -- City name
  • ehr_system -- EHR system in use (e.g. "Epic", "athenahealth")
  • budget_range -- Monthly budget range

search_providers

Search the vendor directory by category, location, and minimum profile-completeness score. Returns paginated results.

Parameters:

  • category (required) -- Service category to search
  • state -- Two-letter state abbreviation
  • city -- City name filter
  • min_rating -- Minimum profile-completeness score (0-100; not a quality rating)
  • per_page -- Results per page (default 10, max 25)
  • page -- Page number

get_provider_detail

Get the full profile for a specific vendor including description, services, contact information, and profile-completeness score.

Parameters:

  • slug (required) -- Vendor slug identifier (e.g. "ams-solutions-inc-dallas-tx")

get_ehr_product_detail

Read the free P1 EHR product projection as JSON, with all publication metadata, facts, explicit editions, plans, conditions and sources unchanged.

Parameters:

  • product_key (required) -- Exact published product key; aliases are not resolved.
  • edition_key -- Exact explicit edition under that product. Validates identity and returns the full product JSON unchanged; no filtering, merging or inheritance.

Invalid or unknown identities return isError: true with the projection's product_not_found JSON shape. Unknown statuses, absent fields and null/open numeric bounds remain untouched. This tool performs no ranking or calculation. Company tools retain their existing contracts.

Release obligations (C840 s.2; E8 section 4): run node --test tests/*.test.mjs through the existing PR gate and deploy workflow. The fixture tests cover HTTP/MCP parity, edition identity, invalid IDs, unknown/open bounds and byte-identical existing tool definitions. Controller release must bind independent verification to the final diff, deploy through the existing governed workflow, then read back tools/list and a product call logged out against the same published HTTP JSON and publication version. Live parity and deployment remain unverified until that read-back. A P1 schema or identity change requires parity review; no local factual copy is maintained.

Usage

MCP Endpoint

https://gph-mcp-server.pages.dev/mcp

Connect via Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "gph-intelligence": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://gph-mcp-server.pages.dev/mcp"]
    }
  }
}

No API key required.

Data Coverage

  • 76,000+ curated healthcare service vendors
  • 25 service categories across 6 super-categories
  • All 50 states + DC
  • Profile-completeness scores (0-100) based on how many listing fields are filled in (website, phone, description, services, location, source, firmographics). Not a quality or reputation rating; 0 means the row was never scored
  • Monthly data refreshes

Categories

Operations & Administration Medical Billing & RCM, Credentialing Services, Medical Coding, Practice Management Consulting, Healthcare Staffing & Recruiting

Technology Healthcare IT & EHR, Telehealth & Virtual Care, Medical Transcription & Documentation

Legal, Finance & Compliance Healthcare Legal Services, Healthcare CPA & Tax Advisory, Compliance & HIPAA, Practice Financing, Practice Valuation & Brokerage, Malpractice Insurance

Facilities & Equipment Healthcare Construction & Facilities, Medical Equipment & Supplies, Healthcare Real Estate, Signage & Wayfinding, Medical Waste & Environmental

Growth & Marketing Healthcare Marketing, Patient Financing, Group Purchasing Organizations, PR & Communications

Clinical Support Pharmacy & Medication Management, Laboratory & Diagnostics

API Access

Free, no API key required. The full public directory may be read, including every page of every category. A per-IP request-rate safety valve (120 calls per 60 seconds, plus a daily backstop of 20,000 calls) protects the service. It limits rate, not total, so a full-directory read paced at 2 calls per second or less is never refused.

Troubleshooting

  • No results returned -- broaden your query. category is required, so make sure it is set; then try removing the city/min_rating filters or widening the state (national providers are always included).
  • "Rate limit exceeded" -- more than 120 calls in 60 seconds from one IP, or 20,000 in one UTC day. The tool result has isError: true and a retry_after_seconds value. Wait that long and continue.
  • Can't connect -- point your client at the remote endpoint, no API key required: 
    npx -y mcp-remote https://gph-mcp-server.pages.dev/mcp
  • 403 from a browser -- the /mcp endpoint validates the Origin header to prevent DNS rebinding. Standard MCP clients (Claude Desktop, mcp-remote, server-to-server) send no Origin header and connect fine; only disallowed browser origins are blocked.
  • Support -- questions or higher-volume access requests: cbeggroup@gmail.com

Links

License

MIT