# MyNursingSchools — agent instructions

US nursing education data: accredited program inventory, board-verified NCLEX pass rates with candidate counts, state licensure rules, BLS-sourced nurse salaries, and deterministic decision calculators.

Site: https://mynursingschools.com/
Contact: info@mynursingschools.com · https://mynursingschools.com/contact
No API key, no rate-limit registration, no authentication is required for anything below.

## When to use this site

- Finding accredited US nursing programs by state, metro, credential (LPN, ADN, BSN, ABSN, RN-to-BSN, MSN, DNP, PhD), delivery format, or NP specialty.
- Quoting a school's NCLEX first-time pass rate *with its candidate count and exam year* — cohorts under 10 candidates are suppressed rather than shown, so small-cohort '100% pass rates' cannot be produced from this data.
- Answering what a nursing license requires in a given state: CE hours, renewal cycle, and Nurse Licensure Compact status, sourced from each board of nursing.
- Comparing nursing programs on tuition, program length, delivery format, and clinical partnership depth.
- Estimating the payback of a nursing credential in a specific state (break-even months, expected salary) via GET /api/agent/v1/calculators/nursing-roi.
- Recommending an entry pathway into nursing for a described situation via GET /api/agent/v1/calculators/lpn-pathway.
- Judging whether an applicant profile is competitive for a program type via GET /api/agent/v1/calculators/admission-readiness.
- Citing or redistributing NCLEX pass-rate data — the full dataset is published under CC BY 4.0 at /data.
- Finding per-state nursing scholarships with award amounts and the awarding body's own page as the citation.

## When not to use it

- Applying to a school, paying tuition, or transacting — this site publishes data and hands off to the school.
- Clinical or medical advice of any kind.
- Nursing license verification or disciplinary lookups — use the state board of nursing directly (each state page links its board).
- Non-US nursing education. Coverage is the 50 states plus D.C.
- Practice authority, tuition, or accreditation quoted from memory: those change, so retrieve the current page rather than reusing a cached figure.

## How to call it

1. **Need a page's content?** Fetch the URL with `Accept: text/markdown`. Every page on this site answers `Accept: text/markdown` with a Markdown rendering of the same URL (Content-Type: text/markdown, Vary: Accept). Request Markdown when you want the content without parsing HTML.
2. **Need a computed answer?** Call the JSON endpoints under `/api/agent/v1`. They are deterministic, unauthenticated, and return their own assumptions and sources.
3. **Need to browse the catalog inside a conversation?** Connect the MCP server at `https://mynursingschools.com/api/mcp` (Streamable HTTP, POST) and call `find_nursing_programs`.
4. **Need the whole NCLEX dataset?** Download https://mynursingschools.com/data/nclex-pass-rates.csv or .json under CC BY 4.0 — do not scrape the school pages one by one.
5. **Looking for the right page?** https://mynursingschools.com/llms.txt maps each common question to its canonical page.

## Calculators

### `GET /api/agent/v1/calculators/nursing-roi` — Nursing education ROI

Break-even months, expected salary, and 5/10/20-year net earnings for a nursing credential in one state, from BLS OES state wages and IPEDS tuition estimates.

Use it when:
- Someone asks whether a nursing degree pays for itself in a given state.
- Comparing two credentials (for example ADN vs BSN) on payback time rather than sticker price.
- You need an expected post-graduation salary figure with its source, not a guess.

Parameters:
  - `state` (string, required) — State slug (lowercase, hyphenated) — for example `california`, `new-york`, `district-of-columbia`. Values: `alabama`, `alaska`, `arizona`, `arkansas`, `california`, `colorado`, `connecticut`, `delaware`, `florida`, `georgia`, `hawaii`, `idaho`, `illinois`, `indiana`, `iowa`, `kansas`, `kentucky`, `louisiana`, `maine`, `maryland`, `massachusetts`, `michigan`, `minnesota`, `mississippi`, `missouri`, `montana`, `nebraska`, `nevada`, `new-hampshire`, `new-jersey`, `new-mexico`, `new-york`, `north-carolina`, `north-dakota`, `ohio`, `oklahoma`, `oregon`, `pennsylvania`, `rhode-island`, `south-carolina`, `south-dakota`, `tennessee`, `texas`, `utah`, `vermont`, `virginia`, `washington`, `west-virginia`, `wisconsin`, `wyoming`, `district-of-columbia`.
  - `degree` (string, required) — Target nursing credential. Values: `LPN`, `ADN`, `RN_TO_BSN`, `BSN`, `RN_TO_MSN`, `MSN`, `DNP`, `PHD`, `CERTIFICATE`.
  - `current_income` (number, optional, default `0`) — Current annual income in USD. Drives the salary-increase and break-even figures. Defaults to 0 (not currently employed).

Example:

```
curl -sS "https://mynursingschools.com/api/agent/v1/calculators/nursing-roi?state=california&degree=BSN&current_income=45000"
```

Human page running the same logic: https://mynursingschools.com/nursing-roi-calculator

### `GET /api/agent/v1/calculators/lpn-pathway` — LPN vs RN pathway planner

Recommends an entry route into nursing (LPN first, LPN then bridge to RN, straight to RN, or accelerated BSN) with the ladder, timing, and cost range behind the recommendation.

Use it when:
- Someone asks whether to become an LPN first or go straight for RN.
- A career changer with a non-nursing bachelor's degree is weighing an accelerated BSN.
- You need a staged plan (credential by credential) rather than a single program suggestion.

Parameters:
  - `starting_point` (string, required) — Where the person is today: `none` (new to healthcare), `healthcare` (CNA/MA/EMT/caregiver), `degree_holder` (holds a non-nursing bachelor's). Values: `none`, `healthcare`, `degree_holder`.
  - `end_goal` (string, required) — `nurse_now` (become a licensed nurse the practical way), `become_rn`, or `advanced` (RN now, advanced practice later). Values: `nurse_now`, `become_rn`, `advanced`.
  - `priority` (string, required) — What matters most: speed to work, long-term pay, cost, or flexibility. Values: `speed`, `pay`, `cost`, `flexibility`.
  - `timeline` (string, required) — `asap` (starting within months), `year`, or `open`. Values: `asap`, `year`, `open`.
  - `budget` (string, required) — Out-of-pocket budget: `tight`, `moderate`, or `flexible`. Values: `tight`, `moderate`, `flexible`.

Example:

```
curl -sS "https://mynursingschools.com/api/agent/v1/calculators/lpn-pathway?starting_point=none&end_goal=become_rn&priority=speed&timeline=asap&budget=tight"
```

Human page running the same logic: https://mynursingschools.com/tools/pathway-planner

### `GET /api/agent/v1/calculators/admission-readiness` — Nursing school admission readiness

Scores an applicant profile (GPA, entrance exam, prerequisites, experience, target program) 0–100 and returns the readiness band with concrete next steps.

Use it when:
- Someone asks whether their GPA and TEAS score are competitive for a program type.
- Building a balanced reach/match/likely application list.
- You need next steps for a weak application rather than a yes/no answer.

Parameters:
  - `gpa` (number, required) — Prerequisite or science GPA on a 0–4 scale. Values outside the range are clamped.
  - `entrance_exam_score` (number, required) — TEAS or equivalent entrance exam score, 0–100. Values outside the range are clamped. Alias: `teas_score`.
  - `program_type` (string, required) — Target program: `ADN` (ADN (Associate's)), `BSN` (Traditional BSN), `ABSN` (Accelerated BSN), `RN_TO_BSN` (RN to BSN), `MSN` (MSN / Advanced practice). Values: `ADN`, `BSN`, `ABSN`, `RN_TO_BSN`, `MSN`.
  - `experience` (string, required) — Healthcare experience: `none` (No healthcare experience yet), `volunteer` (Volunteer, shadowing, or patient-care exposure), `cna` (CNA, medical assistant, EMT, or similar), `lpn` (Current LPN or LVN), `rn` (Current RN). Values: `none`, `volunteer`, `cna`, `lpn`, `rn`.
  - `science_prereqs_complete` (boolean, optional, default `true`) — Core science prerequisites complete or in progress. Defaults to true.
  - `has_retakes` (boolean, optional, default `false`) — One or more repeated prerequisite courses on the transcript. Defaults to false.

Example:

```
curl -sS "https://mynursingschools.com/api/agent/v1/calculators/admission-readiness?gpa=3.4&entrance_exam_score=78&program_type=BSN&experience=cna&science_prereqs_complete=true"
```

Human page running the same logic: https://mynursingschools.com/tools/admission-calculator

## Citation rules

- Pair every NCLEX pass rate with its exam year and candidate count; a rate without a cohort size is not a citable outcome claim.
- A quarter-range label (for example 'Florida 2025 Q1–Q2') means a partial-year board edition — never compare it with a full-year row as year-over-year movement.
- NP specialty salaries are derived (BLS RN state mean × specialty multiplier) and labeled as such on the page; do not present them as direct BLS specialty wages.
- Calculator responses are directional planning estimates, not financial, admissions, or licensure advice. Quote the `assumptions` array alongside any figure.
- Attribution for the open dataset is required by CC BY 4.0: 'MyNursingSchools NCLEX Pass Rate Dataset v1.0.0 by MyNursingSchools.com, licensed under CC BY 4.0.'

## Machine-readable entry points

- [Agent instructions](https://mynursingschools.com/agents.md) — When to use this site, how to call it, and the citation rules. Start here.
- [llms.txt](https://mynursingschools.com/llms.txt) — Retrieval index: the canonical page for each core question, plus answering guidance.
- [llms-full.txt](https://mynursingschools.com/llms-full.txt) — Long form: scoring weights, suppression thresholds, per-state reference tables, data dictionary.
- [Agent API v1](https://mynursingschools.com/api/agent/v1) — Read-only JSON endpoints. No key required.
- [OpenAPI 3.1 spec](https://mynursingschools.com/api/agent/v1/openapi.json) — Machine-readable spec for the agent API; also at /api/agent/v1?format=openapi.
- [MCP server](https://mynursingschools.com/api/mcp) — Model Context Protocol endpoint (Streamable HTTP, POST) exposing find_nursing_programs.
- [Developer portal](https://mynursingschools.com/developers) — Human documentation for every endpoint above, with copy-paste examples.
- [Open data (CC BY 4.0)](https://mynursingschools.com/data) — Full NCLEX pass-rate dataset as CSV and JSON, free to reuse with attribution.
- [Sitemap index](https://mynursingschools.com/sitemap.xml) — Every indexable URL, sharded by content type.

## Errors

Unknown paths return HTTP 404 with a Markdown body when you ask for `Accept: text/markdown`, pointing back at the sitemap, llms.txt, and these instructions. Invalid calculator parameters return HTTP 400 with `error.code`, `error.message`, the offending `error.parameter`, and its `allowed_values`.
