Endpoint
MCP endpoint: https://aivaclaims.com/mcp
Transport: MCP Streamable HTTP, stateless. Send JSON-RPC 2.0 requests with POST, Content-Type: application/json, and Accept: application/json, text/event-stream. Each request is served by a fresh server instance; no session is created and no Mcp-Session-Id is required. Protocol version 2025-06-18 is supported (older MCP revisions negotiate to it).
Health check: GET https://aivaclaims.com/mcp/health returns {"ok":true,"tools":5}.
No authentication is required. Version 1.0.0 exposes public information only: every tool returns content already published on aivaclaims.com or an official VA.gov source URL. No personal data is read or written, and the server holds no user data. An Authorization header, if sent, is ignored.
All 5 tools are read-only and deterministic. Each returns a text content block containing JSON, and the same object as structuredContent.
find_va_benefits
Given a veteran's combined VA disability rating (0–100, steps of 10), returns the official federal benefit programs worth verifying at that rating — each with VA's own one-sentence eligibility summary and the VA.gov eligibility URL. Use this when a veteran states or asks about their rating and wants to know what they may qualify for. It does not decide eligibility; VA does.
Input schema:
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"rating": {
"type": "integer",
"minimum": 0,
"maximum": 100,
"multipleOf": 10,
"description": "Combined VA disability rating as a whole number: 0, 10, 20 … 100."
}
},
"required": [
"rating"
]
}
get_va_compensation_rate
Returns the official VA monthly and annual disability compensation for a veteran with NO dependents at a given combined rating (10–100, steps of 10), plus the effective date and VA source URL. Use this when a veteran asks how much VA pays at a rating. Amounts for veterans with dependents or Special Monthly Compensation differ — say so and link the VA source.
Input schema:
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"rating": {
"type": "integer",
"minimum": 10,
"maximum": 100,
"multipleOf": 10,
"description": "Combined VA disability rating as a whole number from 10 to 100 in steps of 10. VA pays no monthly compensation at 0%."
}
},
"required": [
"rating"
]
}
get_aiva_services
Returns AIVA's three services — VA disability claim preparation help, Intent to File guidance, and how to get VA medical records — each with its aivaclaims.com URL and the page's own summary. Use this when a veteran asks what AIVA does or how it can help with a claim. No input.
Input schema:
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
}
search_aiva_faq
Keyword search over the aivaclaims.com FAQ. Returns up to 5 matching question/answer pairs verbatim, with the FAQ URL. Use this for questions about how AIVA works, eligibility to use AIVA, privacy, cost, the claims process, or what documents are prepared. If no entry matches, the result says so — do not answer from memory; point the veteran to the FAQ URL or support email instead.
Input schema:
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"query": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Plain-language question or keywords, 1–200 characters."
}
},
"required": [
"query"
]
}
how_to_get_started
Returns the concrete steps a veteran takes to prepare a VA disability claim with AIVA: create a free account, file an Intent to File, gather medical records (with the accepted upload formats and size limit), upload, review the prepared drafts, and submit their own claim to VA — plus what it costs (nothing; donor-funded) and how to reach support. Use this when a veteran wants to begin. No input.
Input schema:
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
}
Prompt
veteran_benefits_checkin — a starting prompt that walks a veteran through their rating, the benefits worth verifying, the compensation rate, and how to get free claim-preparation help. Optional argument rating.
Example
Initialize:
POST https://aivaclaims.com/mcp
Content-Type: application/json
Accept: application/json, text/event-stream
{
"jsonrpc": "2.0",
"id": 1,
"method": "initialize",
"params": {
"protocolVersion": "2025-06-18",
"capabilities": {},
"clientInfo": {
"name": "your-client",
"version": "1.0.0"
}
}
}
Call a tool:
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "get_va_compensation_rate",
"arguments": {
"rating": 70
}
}
}