{
  "schema_version": "1.0",
  "publisher": {
    "name": "Help Me Find A Doctor",
    "url": "https://helpmefindadoctor.com"
  },
  "mcp_endpoint": "https://helpmefindadoctor.com/mcp",
  "documentation": "https://helpmefindadoctor.com/auth.md",
  "skills": [
    {
      "id": "search-doctors",
      "name": "Search doctors",
      "description": "Find physicians by name, specialty, city, or state.",
      "invocation": [
        {
          "via": "mcp",
          "tool": "search_doctors",
          "endpoint": "https://helpmefindadoctor.com/mcp"
        },
        {
          "via": "http",
          "method": "GET",
          "href": "https://helpmefindadoctor.com/find-a-doctor?q={query}"
        }
      ],
      "tags": [
        "directory",
        "search",
        "healthcare"
      ]
    },
    {
      "id": "find-top-doctors",
      "name": "Find top-matching doctors",
      "description": "Ranked matches by specialty, radius, and insurance acceptance.",
      "invocation": [
        {
          "via": "mcp",
          "tool": "find_top_doctors",
          "endpoint": "https://helpmefindadoctor.com/mcp"
        }
      ],
      "tags": [
        "directory",
        "ranking",
        "insurance"
      ]
    },
    {
      "id": "get-doctor",
      "name": "Get doctor by NPI",
      "description": "Return public profile info for a single doctor.",
      "invocation": [
        {
          "via": "mcp",
          "tool": "get_doctor",
          "endpoint": "https://helpmefindadoctor.com/mcp"
        },
        {
          "via": "http",
          "method": "GET",
          "href": "https://helpmefindadoctor.com/doctor/{npi}"
        }
      ],
      "tags": [
        "directory",
        "profile"
      ]
    },
    {
      "id": "list-specialties",
      "name": "List specialties",
      "description": "Medical specialties covered by the directory, with counts.",
      "invocation": [
        {
          "via": "mcp",
          "tool": "list_specialties",
          "endpoint": "https://helpmefindadoctor.com/mcp"
        }
      ],
      "tags": [
        "taxonomy"
      ]
    },
    {
      "id": "list-locations",
      "name": "List states and cities",
      "description": "US states and cities the directory covers.",
      "invocation": [
        {
          "via": "mcp",
          "tool": "list_locations",
          "endpoint": "https://helpmefindadoctor.com/mcp"
        },
        {
          "via": "http",
          "method": "GET",
          "href": "https://helpmefindadoctor.com/api/public/cities/index.json"
        }
      ],
      "tags": [
        "taxonomy",
        "geo"
      ]
    },
    {
      "id": "request-appointment",
      "name": "Request an appointment",
      "description": "Send a contact / appointment request to a doctor's office.",
      "invocation": [
        {
          "via": "mcp",
          "tool": "request_appointment",
          "endpoint": "https://helpmefindadoctor.com/mcp"
        }
      ],
      "tags": [
        "write",
        "contact"
      ],
      "auth_required": true
    },
    {
      "id": "research-health-concern",
      "name": "Research a health concern",
      "description": "General guidance on which specialty to consider. Not medical advice.",
      "invocation": [
        {
          "via": "mcp",
          "tool": "research_health_concern",
          "endpoint": "https://helpmefindadoctor.com/mcp"
        }
      ],
      "tags": [
        "research",
        "triage"
      ]
    }
  ]
}