Skip to main content

Model Context Protocol

The veterans benefits MCP server

VeteranHQ runs a free, public MCP (Model Context Protocol) server that gives Claude and other AI assistants 14 read-only tools for VA disability and veterans benefits, built on 38 CFR and VA’s own rate tables. No account is needed for any public tool.

AT A GLANCE

14public tools
Freeno account
HTTPstreamable

THE ENDPOINT

One address for every client

The address is public on purpose: it is not a password, and there is no key to hold.

Server URL

https://api.veteranhq.app/mcp
Transport
Streamable HTTP
Sign-in
No sign-in for public tools; your own VA record only after you approve. How connecting your record works

INSTALL

Add it to your assistant

Claude has a verified setup. Any other client that adds a remote MCP server over Streamable HTTP takes the same address.

Claude

It reads your record. It cannot change anything at VA.

  1. Step 1: Add VeteranHQ to Claude.

    Add to Claude (opens Claude in a new tab)

    Form empty? Name it VeteranHQ and paste this address.

    https://api.veteranhq.app/mcp
  2. Step 2: In Claude, press Add, then Connect.

  3. Step 3: Sign in to VeteranHQ and press Allow.

Then ask Claude about your ratings, claims, or documents.

On a phone, do this once on claude.ai in your browser; the Claude app picks it up.

ChatGPT support is coming.

You sign in on veteranhq.app, in your own browser. Claude never sees your password. Access lasts 90 days, then Claude asks you to sign in again.

If it did not work

  • The sign-in tab showed your dashboard instead of the permission screen.

    Press Connect in Claude again.

  • Claude says it has no VeteranHQ tools.

    Turn VeteranHQ on in the chat's tools menu, then ask again.

  • Claude keeps asking permission.

    Set the read-only tools to Always allow in Customize, then Connectors, then VeteranHQ, or pick Allow always on the prompt (that choice lasts only for that chat).

Claude Code

Run this in your terminal.

claude mcp add --transport http veteranhq https://api.veteranhq.app/mcp

Other MCP clients

The common format, used by Cursor and similar clients:

{
  "mcpServers": {
    "veteranhq": {
      "url": "https://api.veteranhq.app/mcp"
    }
  }
}

VS Code uses its own format:

{
  "servers": {
    "veteranhq": {
      "type": "http",
      "url": "https://api.veteranhq.app/mcp"
    }
  }
}

THE TOOLS

Every public tool

Each one is read only, free, and needs no account. Your assistant shows you the title and calls the tool by the name beside it.

  1. Calculate combined VA ratingcalculate_combined_rating

    When a veteran has two or more VA disability rating percentages and wants the combined rating.

  2. Compare rating criteriacompare_rating_criteria

    When a veteran names a VA diagnostic code and wants the rating criteria for it.

  3. Analyze a rating gapanalyze_rating_gap

    When a veteran gives a condition name and the VA disability percentage currently assigned for it, and wants that percentage compared against the VASRD criteria.

  4. Check a 12-month absence windowcalculate_rolling_window

    When a veteran supplies dates of incapacitating episodes and the question involves the 38 CFR 4.71a formula VA uses to rate intervertebral disc syndrome on incapacitating episodes, diagnostic code 5243.

  5. Find secondary conditionsfind_secondary_conditions

    When a veteran names a VA service-connected condition and asks what other conditions can follow from it.

  6. Check presumptive eligibilitycheck_presumptive_eligibility

    When a veteran asks whether VA treats a condition as presumptively service connected, or which conditions are presumptive for a given exposure or service era.

  7. Search case law and regulationssearch_legal_authority

    When a veteran's question needs VA regulations, legal standards or case law by keyword, citation or diagnostic code.

  8. Prepare for a C&P examprepare_cp_exam

    When a veteran has a VA compensation and pension examination scheduled for a condition and wants to know what it involves.

  9. Look up monthly compensation ratelookup_compensation_rate

    When a veteran wants the monthly VA disability compensation amount for a given rating percentage and dependent situation.

  10. Estimate retroactive back paycompute_retroactive_pay

    When a veteran gives an effective date and a VA rating increase and asks what the retroactive amount would be.

  11. Find free and accredited claim helpfind_claim_help

    When a veteran asks who can help with a VA disability claim, or describes a crisis.

  12. Search the VeteranHQ guidessearch_guides

    When a veteran asks about a VA topic VeteranHQ has written a guide on.

  13. Read a VeteranHQ guideget_guide

    When a veteran needs what a VeteranHQ guide on a VA topic says, given a slug from search_guides.

  14. Find veterans benefits to checkfind_veteran_benefits

    When a veteran asks what VA benefits they may qualify for.

WHAT YOU CAN ASK

Ask in plain language

Once it is added, ask the way you would ask a person. Your assistant picks the tool.

  • What is my combined rating with 50% and 30%?
  • What VA benefits can I check with a 70% rating?
  • What does SMC-K pay in 2026?
  • Is my condition presumptive for Agent Orange?

BOUNDARIES

What it is, and what it is not

The same lines the server and the AI Connector page publish.

  • Educational, not legal advice

    VeteranHQ provides educational information about VA disability benefits. It does not provide legal advice, it is not a law firm, and it is not an accredited claims agent.

  • We never file for you

    VeteranHQ helps you gather evidence. We never prepare or file a claim for you, by deliberate product rule, and the MCP server is no exception.

  • Only VA decides

    Only VA decides ratings, effective dates and payment amounts. A number from these tools is what the regulation or the rate table says, not a decision.

  • Public tools carry no personal data

    The public tools take what you type and return what the regulation, the rate table or the published reference says. Not one of them can reach a veteran record, so there is nothing to sign in to and nothing to pay for.

QUESTIONS

Straight answers

  • MCP, the Model Context Protocol, is an open standard that lets an AI assistant call tools on another service. When you ask about a combined rating, your assistant runs the actual calculation on VeteranHQ’s servers and reports what came back, instead of reconstructing the answer from memory.

  • Claude has a verified setup, in Claude itself and in Claude Code, and the steps are on this page. Other clients that can add a remote MCP server over Streamable HTTP can add the same address. The tools that read your own record also need a client that can complete the sign-in on veteranhq.app.

  • Yes. Every public tool is free, with no account and no payment. The tools that read your own record are part of a VeteranHQ membership and work only after you approve them.

  • Not the public tools: not one of them can reach a veteran record. The tools that read your own ratings, claims and documents need a VeteranHQ account, a membership, and your explicit approval when you sign in, and you can turn them off any time in Settings. The AI Connector page lists exactly what they read.

  • No. VeteranHQ helps you gather evidence. We never prepare or file a claim for you, by deliberate product rule, and the MCP server is no exception. Filing stays yours, and only VA decides ratings, effective dates and payment amounts.

Answers from the regulation, not from memory.

Add the address once and every conversation can reach the rating math and the rate tables. Your own record stays out of it unless you decide otherwise.