{"name":"MyNursingSchools Agent API","version":"1.0.0","description":"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.","documentation_url":"https://mynursingschools.com/developers","openapi_url":"https://mynursingschools.com/api/agent/v1/openapi.json","agent_instructions_url":"https://mynursingschools.com/agents.md","authentication":"none","coverage":"United States (50 states + District of Columbia)","when_to_use":["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."],"not_for":["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."],"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.'"],"content_negotiation":{"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.","example":"curl -H 'Accept: text/markdown' https://mynursingschools.com/"},"endpoints":[{"method":"GET","path":"/api/agent/v1","description":"This index. Add ?format=openapi for the OpenAPI 3.1 document."},{"method":"GET","path":"/api/agent/v1/calculators","description":"Directory of deterministic calculators with parameters and examples. Add ?format=openapi for the spec."},{"method":"GET","path":"/api/agent/v1/calculators/nursing-roi","description":"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.","example_request":"https://mynursingschools.com/api/agent/v1/calculators/nursing-roi?state=california&degree=BSN&current_income=45000"},{"method":"GET","path":"/api/agent/v1/calculators/lpn-pathway","description":"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.","example_request":"https://mynursingschools.com/api/agent/v1/calculators/lpn-pathway?starting_point=none&end_goal=become_rn&priority=speed&timeline=asap&budget=tight"},{"method":"GET","path":"/api/agent/v1/calculators/admission-readiness","description":"Scores an applicant profile (GPA, entrance exam, prerequisites, experience, target program) 0–100 and returns the readiness band with concrete next steps.","example_request":"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"},{"method":"POST","path":"/api/mcp","description":"Model Context Protocol endpoint (Streamable HTTP) exposing the find_nursing_programs tool."}],"calculators":[{"id":"nursing-roi","title":"Nursing education ROI","summary":"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.","when_to_use":["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."],"endpoint":"https://mynursingschools.com/api/agent/v1/calculators/nursing-roi","method":"GET","example_request":"https://mynursingschools.com/api/agent/v1/calculators/nursing-roi?state=california&degree=BSN&current_income=45000","human_page":"https://mynursingschools.com/nursing-roi-calculator","sources":["U.S. Bureau of Labor Statistics, Occupational Employment and Wage Statistics (state RN means)","NCES IPEDS 2023 nursing program tuition","AACN salary surveys (credential multipliers)"],"parameters":[{"name":"state","type":"string","required":true,"description":"State slug (lowercase, hyphenated) — for example `california`, `new-york`, `district-of-columbia`.","enum":["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"],"example":"california"},{"name":"degree","type":"string","required":true,"description":"Target nursing credential.","enum":["LPN","ADN","RN_TO_BSN","BSN","RN_TO_MSN","MSN","DNP","PHD","CERTIFICATE"],"example":"BSN"},{"name":"current_income","type":"number","required":false,"description":"Current annual income in USD. Drives the salary-increase and break-even figures. Defaults to 0 (not currently employed).","default":0,"example":45000}]},{"id":"lpn-pathway","title":"LPN vs RN pathway planner","summary":"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.","when_to_use":["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."],"endpoint":"https://mynursingschools.com/api/agent/v1/calculators/lpn-pathway","method":"GET","example_request":"https://mynursingschools.com/api/agent/v1/calculators/lpn-pathway?starting_point=none&end_goal=become_rn&priority=speed&timeline=asap&budget=tight","human_page":"https://mynursingschools.com/tools/pathway-planner","sources":["BLS Occupational Employment and Wage Statistics (LPN and RN national medians, May 2024)","MyNursingSchools program catalog (program lengths and tuition ranges)"],"parameters":[{"name":"starting_point","type":"string","required":true,"description":"Where the person is today: `none` (new to healthcare), `healthcare` (CNA/MA/EMT/caregiver), `degree_holder` (holds a non-nursing bachelor's).","enum":["none","healthcare","degree_holder"],"example":"none"},{"name":"end_goal","type":"string","required":true,"description":"`nurse_now` (become a licensed nurse the practical way), `become_rn`, or `advanced` (RN now, advanced practice later).","enum":["nurse_now","become_rn","advanced"],"example":"become_rn"},{"name":"priority","type":"string","required":true,"description":"What matters most: speed to work, long-term pay, cost, or flexibility.","enum":["speed","pay","cost","flexibility"],"example":"speed"},{"name":"timeline","type":"string","required":true,"description":"`asap` (starting within months), `year`, or `open`.","enum":["asap","year","open"],"example":"asap"},{"name":"budget","type":"string","required":true,"description":"Out-of-pocket budget: `tight`, `moderate`, or `flexible`.","enum":["tight","moderate","flexible"],"example":"tight"}]},{"id":"admission-readiness","title":"Nursing school admission readiness","summary":"Scores an applicant profile (GPA, entrance exam, prerequisites, experience, target program) 0–100 and returns the readiness band with concrete next steps.","when_to_use":["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."],"endpoint":"https://mynursingschools.com/api/agent/v1/calculators/admission-readiness","method":"GET","example_request":"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":"https://mynursingschools.com/tools/admission-calculator","sources":["MyNursingSchools admissions rubric (published weighting, see /tools/admission-calculator)"],"parameters":[{"name":"gpa","type":"number","required":true,"description":"Prerequisite or science GPA on a 0–4 scale. Values outside the range are clamped.","example":3.4},{"name":"entrance_exam_score","type":"number","required":true,"description":"TEAS or equivalent entrance exam score, 0–100. Values outside the range are clamped. Alias: `teas_score`.","example":78},{"name":"program_type","type":"string","required":true,"description":"Target program: `ADN` (ADN (Associate's)), `BSN` (Traditional BSN), `ABSN` (Accelerated BSN), `RN_TO_BSN` (RN to BSN), `MSN` (MSN / Advanced practice).","enum":["ADN","BSN","ABSN","RN_TO_BSN","MSN"],"example":"BSN"},{"name":"experience","type":"string","required":true,"description":"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).","enum":["none","volunteer","cna","lpn","rn"],"example":"cna"},{"name":"science_prereqs_complete","type":"boolean","required":false,"description":"Core science prerequisites complete or in progress. Defaults to true.","default":true,"example":true},{"name":"has_retakes","type":"boolean","required":false,"description":"One or more repeated prerequisite courses on the transcript. Defaults to false.","default":false,"example":false}]}],"resources":[{"id":"agent_instructions","title":"Agent instructions","url":"https://mynursingschools.com/agents.md","description":"When to use this site, how to call it, and the citation rules. Start here."},{"id":"llms_txt","title":"llms.txt","url":"https://mynursingschools.com/llms.txt","description":"Retrieval index: the canonical page for each core question, plus answering guidance."},{"id":"llms_full_txt","title":"llms-full.txt","url":"https://mynursingschools.com/llms-full.txt","description":"Long form: scoring weights, suppression thresholds, per-state reference tables, data dictionary."},{"id":"agent_api","title":"Agent API v1","url":"https://mynursingschools.com/api/agent/v1","description":"Read-only JSON endpoints. No key required."},{"id":"openapi","title":"OpenAPI 3.1 spec","url":"https://mynursingschools.com/api/agent/v1/openapi.json","description":"Machine-readable spec for the agent API; also at /api/agent/v1?format=openapi."},{"id":"mcp_server","title":"MCP server","url":"https://mynursingschools.com/api/mcp","description":"Model Context Protocol endpoint (Streamable HTTP, POST) exposing find_nursing_programs."},{"id":"developer_portal","title":"Developer portal","url":"https://mynursingschools.com/developers","description":"Human documentation for every endpoint above, with copy-paste examples."},{"id":"open_data","title":"Open data (CC BY 4.0)","url":"https://mynursingschools.com/data","description":"Full NCLEX pass-rate dataset as CSV and JSON, free to reuse with attribution."},{"id":"sitemap","title":"Sitemap index","url":"https://mynursingschools.com/sitemap.xml","description":"Every indexable URL, sharded by content type."}],"data_license":{"name":"CC BY 4.0","url":"https://creativecommons.org/licenses/by/4.0/","attribution":"MyNursingSchools NCLEX Pass Rate Dataset v1.0.0 by MyNursingSchools.com, licensed under CC BY 4.0. Source: https://mynursingschools.com/data"},"contact":{"email":"info@mynursingschools.com","url":"https://mynursingschools.com/contact"}}