Use with Claude Code & LLM agents

Copy this prompt into Claude Code (or any LLM agent) and it will set itself up to use the HANK platform over MCP and the REST API. It lists the current services and their operations, generated live from the platform registry.

The prompt starts with ONE MCP connection, to https://api.hank.ai/mcp. That single endpoint reaches every HANK service your key includes, and each tool name starts with the name of the service that does the work. The per-service endpoints follow as the alternative, for a client that wants one entry per service.

To see what a call returns before you wire an agent to it, open the MCP page and run one from your browser.

You are being set up to use the HANK healthcare API platform.
Ask the user for their API key (minted at console.hank.ai/console/api-keys); store it as HANK_API_KEY.

MCP (do this first): ONE connection reaches every HANK service this key
includes. In Claude Code:
  claude mcp add --transport http hank https://api.hank.ai/mcp \
    --header "Authorization: Bearer $HANK_API_KEY"
  Tool names start with the service, for example codesets_lookup_cpt.
  The catalog lists only the services this key includes.

REST: base https://api.hank.ai/v1, header:  Authorization: Bearer $HANK_API_KEY
  - hank-codesets (/v1/codesets): anesthesia.lookup, classification.groups, classification.rbcs, classification.scope, code.batch, code.identify, code.lookup, code.search, lookup, rules.check
  - claim-cleaner (/v1/claimcleaner): claim.validate, codes.download, lookup
  - hank-scholar (/v1/scholar): chat.turn, lookup, mcp.tool_call
  - hank-arse (/v1/arse): arse.emit_835, arse.process, arse.submit, lookup
  - hank-ppman (/v1/ppman): lookup, policy.applicability, policy.changes, policy.document, policy.lookup, policy.resolve_payer, policy.suggest, pt.lookup
  - hank-krac-web (/v1/krac): krac.code, krac.submit, lookup
  - hank-safe-harbor-web (/v1/safeharbor): deidentify_pdf, deidentify.submit, deidentify_text, list_models, lookup
  - hank-medicalnotes-web (/v1/medicalnotes): lookup, medicalnotes.classify, medicalnotes.generate, medicalnotes.submit, medicalnotes.summarize
  - hank-docs (/v1/docs): ask.answer, embed, lookup

Per-service MCP endpoints (the alternative to the one connection above; use these only when you want one client entry per service):
  claude mcp add --transport http hank-codesets https://api.hank.ai/v1/codesets/mcp/ \
    --header "Authorization: Bearer $HANK_API_KEY"
  claude mcp add --transport http hank-claimcleaner https://api.hank.ai/v1/claimcleaner/mcp/ \
    --header "Authorization: Bearer $HANK_API_KEY"
  claude mcp add --transport http hank-scholar https://api.hank.ai/v1/scholar/mcp/hank/ \
    --header "Authorization: Bearer $HANK_API_KEY"
  claude mcp add --transport http hank-arse https://api.hank.ai/v1/arse/mcp/ \
    --header "Authorization: Bearer $HANK_API_KEY"
  claude mcp add --transport http hank-ppman https://api.hank.ai/v1/ppman/mcp/ \
    --header "Authorization: Bearer $HANK_API_KEY"
  claude mcp add --transport http hank-krac https://api.hank.ai/v1/krac/mcp/{org}/ \
    --header "Authorization: Bearer $HANK_API_KEY"
  claude mcp add --transport http hank-safeharbor https://api.hank.ai/v1/safeharbor/mcp/ \
    --header "Authorization: Bearer $HANK_API_KEY"
  claude mcp add --transport http hank-medicalnotes https://api.hank.ai/v1/medicalnotes/mcp/{org}/ \
    --header "Authorization: Bearer $HANK_API_KEY"
  ({org} = your organization id, shown on console.hank.ai/console)

Credits: each operation costs credits; a 402 means out of credits. Rate limit: 429 + Retry-After.
Confirm the MCP server is registered and you can hit the REST API, then summarize what you can do.

copy prompt

Your API key stays a placeholder: paste your own key from API Keys.