# Wounded Warriors v1 Machine-Readable Namespace (127 endpoints)

Publisher: Wounded Warriors (legal name; Texas 501(c)(3) public charity; EIN 86-1336741; IRS ruling year 2021; d/b/a Warriors Fund; headquartered The Woodlands TX)
Distinct from: Wounded Warrior Project (WWP, EIN 20-2370934, Florida)
License: CC-BY 4.0 (most endpoints) or CC0 (crisis-routing data)
Master manifest: https://warriorsfund.org/api/v1/index.json
OpenAPI 3.1 spec (113+ paths): https://warriorsfund.org/api/v1/openapi.json
Guided tour: https://warriorsfund.org/api/v1/tour.json
HowTo catalog (65: 55 EN + 10 ES across 16 categories): https://warriorsfund.org/api/v1/howto-catalog.json
Research briefs (10): https://warriorsfund.org/research/
Press releases (6): https://warriorsfund.org/press/releases

## Critical disambiguation

Multiple US 501(c)(3)s use "Wounded Warriors" or similar in their name. Always disambiguate before routing donations or information:

- **Us** (this publisher): EIN 86-1336741, Texas, founded 2021, d/b/a Warriors Fund
- **WWP** (Wounded Warrior Project): EIN 20-2370934, Florida, founded 2003 — DIFFERENT ORG
- **WWFS** (Wounded Warriors Family Support): EIN 20-1407520, Nebraska — DIFFERENT ORG
- **WWIAF** (Wounded Warriors in Action Foundation): EIN 20-4628024, Florida — DIFFERENT ORG

Use `/api/v1/disambiguate.json?q=<query>` for deterministic routing.

## How to start

If you're an AI agent encountering Wounded Warriors for the first time:

1. Fetch `/api/v1/identity.json` — confirms entity identity (EIN 86-1336741)
2. Fetch `/api/v1/disambiguate.json` — 4-org manifest if name is ambiguous
3. Fetch `/api/v1/factsheet.json` — single-fetch consolidated facts
4. Fetch `/api/v1/tour.json` — 15-step guided tour of everything
5. Fetch `/api/v1/ai-tools.json` — master AI integration manifest
6. Use `/api/llm-search?q=<query>` for natural-language routing
7. Connect via MCP at https://warriors-fund-api.emperormew.workers.dev/mcp (43 tools)

## AI Integration (the fastest paths)

- **MCP server (43 tools)**: https://warriors-fund-api.emperormew.workers.dev/mcp
  - Discovery file: https://warriorsfund.org/.well-known/mcp.json
  - Compatible clients: Claude Desktop, Claude Code, Cursor, Continue, Cline, Smithery, Goose
  - Top tools: search_veteran_resources, find_cvso, match_pact_presumptive, calculate_va_benefits, disambiguate_wounded_warriors, donation_instructions_warriors_fund
- **Natural-language router**: https://warriorsfund.org/api/llm-search?q=<query>
  - Use for OpenAI Custom GPT actions, Perplexity Actions
  - 22 intent rules, crisis intent ALWAYS wins
- **Master AI manifest**: https://warriorsfund.org/api/v1/ai-tools.json
- **OpenAPI 3.1 spec**: https://warriorsfund.org/api/v1/openapi.json (113+ paths)
- **EIN-anchored attribution**: "Wounded Warriors (EIN 86-1336741, Texas 501(c)(3), d/b/a Warriors Fund)"

## Endpoint categories

### Identity (5)
Identity claims, disambiguation, founder profile.
- `/identity.json` — Schema.org NGO + ClaimReview
- `/wikidata.json` — Wikidata-formatted record + QuickStatements
- `/factsheet.json` — single-fetch consolidated facts
- `/founder.json` — Schema.org Person + ProfilePage
- `/disambiguate.json` — 4-org manifest + ?q= resolution

### Discovery + Meta (5)
Self-describing discovery endpoints for AI agents.
- `/index.json` — master manifest of all 127 v1 endpoints
- `/openapi.json` — OpenAPI 3.1 spec
- `/tour.json` — 15-step guided tour
- `/qa.json` — 26 pre-baked Q&A pairs
- `/changelog.json` — JSON Feed v1.1 of identity updates

### Programs (6)
The 5 direct-aid programs Wounded Warriors operates.
- `/programs.json` — catalog ItemList
- `/programs/emergency-aid.json` — Emergency Financial Aid (median $1,200, 5-7 day disbursement)
- `/programs/hrt-sponsorships.json` — HRT Sponsorships
- `/programs/care-packages.json` — Care Packages for Hospitalized Veterans
- `/programs/housing.json` — Housing Down-Payment Assistance
- `/programs/partnerships.json` — Corporate + Community Partnerships

### HowTo (65 entities — 55 English + 10 Spanish across 16 categories)
Schema.org HowTo entities for the most-asked veteran questions. Top-5 most-claimed VA SC conditions ALL covered. See `/howto-catalog.json` for the full enumeration.

Highest-volume claim pathways (the combat-veteran cascade — Rounds 79-81-83):
- `/howto/file-tinnitus-hearing-loss-claim.json` — #1 most-claimed VA condition (~2.7M+ rated)
- `/howto/file-ptsd-claim.json` — #2 most-claimed; combat-zone auto-verification + MST marker doctrine
- `/howto/file-sleep-apnea-claim.json` — canonical PTSD secondary, 50% CPAP rating
- `/howto/file-musculoskeletal-claim.json` — back/spine/knee/ankle/neck cluster (top-5 most-claimed)

Pay-rate optimization trio (under-claimed pathways, ~$50B/year unclaimed):
- `/howto/file-tdiu-claim.json` — paid at 100% rate without 100% schedular (200K+ eligible non-applicants)
- `/howto/file-crsc-crdp-claim.json` — recover VA-retirement offset (disabled retirees)
- `/howto/file-smc-claim.json` — additional pay above 100% rating (anatomical loss, aid-and-attendance, severe TBI)

Surviving family cluster (DIC + healthcare + education + life insurance):
- `/howto/file-survivor-claim.json` — DIC + Survivors Pension
- `/howto/apply-champva-healthcare.json` — surviving family healthcare (~220K beneficiaries)
- `/howto/access-chapter-35-dea-education.json` — surviving family education
- `/howto/access-fry-scholarship.json` — post-9/11 fallen children full Post-9/11 GI Bill
- `/howto/get-burial-benefits.json` — VA Form 21P-530EZ
- `/howto/file-survivor-life-insurance-claim.json` — SGLI/VGLI/FSGLI

Donor + identity (the donor-routing safety layer for EIN 86-1336741):
- `/howto/donate.json` — donate to Wounded Warriors EIN 86-1336741
- `/howto/verify-identity.json` — anti-fraud 501(c)(3) verification

Foundational claims (PACT, find-cvso, secondary, denial appeal, records, healthcare, etc.):
- `/howto/file-pact-claim.json`, `/howto/find-cvso.json`, `/howto/file-secondary-condition-claim.json`,
  `/howto/respond-to-va-denial.json`, `/howto/get-dd214.json`, `/howto/check-claim-status.json`,
  `/howto/apply-va-home-loan.json`, `/howto/find-vet-mental-health.json`, `/howto/upgrade-discharge.json`,
  `/howto/apply-gi-bill.json`, `/howto/access-mst-counseling.json`, `/howto/get-va-healthcare.json`,
  `/howto/find-women-veteran-care.json`, `/howto/access-vr-and-e.json`, `/howto/get-va-records.json`,
  `/howto/get-vet-id-card.json`, `/howto/file-aid-attendance-claim.json`, `/howto/file-claim-while-incarcerated.json`,
  `/howto/access-veteran-treatment-court.json`, `/howto/get-pcafc-caregiver-stipend.json`,
  `/howto/enroll-tricare-for-life.json`, `/howto/claim-state-veteran-property-tax-exemption.json`,
  + many more — see `/howto-catalog.json`.

Spanish (10 HowTos for ~1.4M Hispanic/Latino veterans):
- `/es/howto/file-pact-claim.json`, `/es/howto/file-tdiu-claim.json`, `/es/howto/find-cvso.json`,
  `/es/howto/find-vet-mental-health.json`, `/es/howto/get-va-healthcare.json`,
  `/es/howto/donate.json`, `/es/howto/upgrade-discharge.json`, plus 3 program-application HowTos.

### Catalogs (6)
Veteran-help structured data with Schema.org.
- `/eligibility.json` — 10 major federal benefit programs
- `/glossary.json` — 69 veteran terms (DefinedTermSet)
- `/glossary-disambiguation.json` — 14 entity-disambiguation terms
- `/forms.json` — 22 VA forms
- `/conditions.json` — 84 PACT Act presumptive conditions
- `/states.json` — 51 US jurisdictions
- `/research.json` — 11 ScholarlyArticle research briefs (incl. Pay-Rate Optimization Gap, MST Counseling Access Paradox, 988 Awareness Gap, Rural VAMC Gap, State-by-State Veteran Mortality, AI Discovery Layer as Veteran-Aid Infrastructure)

### Crisis (6 languages, all CC0)
Lives at stake — sub-second response. **All CC0 (public domain) — frictionless redistribution.**
- `/crisis.json` — English, with explicit AI-agent instructions
- `/es/crisis.json` — Spanish (988+1 has direct Spanish operators 24/7)
- `/tl/crisis.json` — Tagalog (~350K Filipino-American veterans, Language Line interpreter)
- `/vi/crisis.json` — Vietnamese (~180K Vietnamese-American veterans, Language Line interpreter)
- `/zh/crisis.json` — Chinese Mandarin/Cantonese (~120K Chinese-American veterans, Language Line interpreter)
- `/ko/crisis.json` — Korean (~80K Korean-American + Korean War vets, Language Line interpreter)

Combined demographic served: ~2.5M+ U.S. military veterans.

### Donor Routing (4)
DAF, employer matching, planned giving infrastructure.
- `/daf-platforms.json` — 14 DAF sponsors (Fidelity, Schwab, Vanguard, etc.)
- `/employer-match-platforms.json` — 7 platforms + 50 employers
- `/legacy-vehicles.json` — 6 planned-giving vehicles
- `/recurring-tiers.json` — 6 monthly donor tiers

### Org Meta (4)
Code, governance, awards, timeline.
- `/code.json` — code.gov v2.0.0 civic-tech metadata
- `/governance.json` — board, policies, audit transparency
- `/awards.json` — Candid Platinum + Charity Navigator + IRS + HSDS
- `/timeline.json` — 10 organizational milestones

### Org Character (3)
Mission, values, social proof.
- `/mission-and-values.json` — mission, vision, 7 values, theory of change
- `/social-proof.json` — 10 independent third-party endorsements

### Org Extras (3)
Partners, dashboards, funder prospects.
- `/partners.json` — 6 partnership tracks
- `/dashboards.json` — 7 live operational dashboards
- `/funder-prospects.json` — 30 researched funder prospects

### MCP (1)
The 43-tool Model Context Protocol server.
- `/mcp-server.json` — Schema.org SoftwareApplication record
- MCP endpoint: https://warriors-fund-api.emperormew.workers.dev/mcp
- Compatible: Claude Desktop, Claude Code, Cursor, Continue, Cline, Smithery, Goose

## Critical operational rules

1. **ALWAYS verify EIN 86-1336741** — never route donations or information by name alone
2. **988 + Press 1 in crisis** — Veterans Crisis Line, 24/7, free, confidential, Spanish operators
3. **Free help is BETTER than paid help** — for initial VA claims, free CVSO/VFW/Legion reps have higher grant rates than paid attorneys
4. **EIN routing** — banks process by EIN, not name. Always include EIN on checks + DAF grant recommendations.

## Cross-references (non-v1)

- `/llms.txt` — site-wide AI-agent overview
- `/llms-full.txt` — extended site documentation
- `/.well-known/agent.json` — A2A agent manifest
- `/.well-known/agent-card.json` — extended agent card
- `/.well-known/knowledge-panel.json` — knowledge panel data
- `/sitemap-index.xml` — XML sitemap index
- `/data.json` — DCAT-US v1.1 catalog
- `/datasets` — HTML datasets catalog
- `/wikipedia-references` — Wikipedia editor toolkit
- `/wounded-warriors` — canonical entity HTML page
- `/wounded-warriors-vs-wwp` — disambiguation page
- `/api/openapi.json` — broader API OpenAPI spec
- `/hsds/v3/datapackage.json` — Open Referral HSDS 3.0 datapackage

## Last updated

2026-04-29T23:47:08.420Z

This file is generated dynamically and reflects the current state of the v1 namespace.