MyNursingSchools Developer & Agent API

Quick start

Start at the capability index. It describes what this site can answer, lists every endpoint, and links the OpenAPI document.

# Capability index
curl -sS https://mynursingschools.com/api/agent/v1

# OpenAPI 3.1 specification
curl -sS https://mynursingschools.com/api/agent/v1/openapi.json

# Any page as Markdown instead of HTML
curl -sS -H 'Accept: text/markdown' https://mynursingschools.com/

When to use the MyNursingSchools API

• 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 to use something else

• 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.

Calculator endpoints

Every calculator is a GET request, deterministic for a given query string, and returns its own assumptions, sources, and links back to the human page that runs the same logic. Invalid parameters return HTTP 400 with the offending parameter and its allowed values. The directory is at /api/agent/v1/calculators.

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

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

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"

Calling the API from code

There is no SDK to install — the API is plain HTTP and JSON, so the standard library of any language is enough. Generate a typed client from the OpenAPI document if you want one.

// JavaScript / TypeScript
const params = new URLSearchParams({
  state: "texas",
  degree: "BSN",
  current_income: "42000",
});
const response = await fetch(
  `https://mynursingschools.com/api/agent/v1/calculators/nursing-roi?${params}`,
);
const { result, assumptions, sources } = await response.json();
console.log(result.break_even_months, assumptions, sources);

# Python
import requests

response = requests.get(
    "https://mynursingschools.com/api/agent/v1/calculators/admission-readiness",
    params={
        "gpa": 3.4,
        "entrance_exam_score": 78,
        "program_type": "BSN",
        "experience": "cna",
    },
    timeout=10,
)
data = response.json()
print(data["result"]["readiness_score"], data["result"]["band_label"])

# Generate a typed client from the OpenAPI document
npx openapi-typescript https://mynursingschools.com/api/agent/v1/openapi.json -o mynursingschools.d.ts

MyNursingSchools MCP server

Assistants that speak the Model Context Protocol can call the program finder directly. The endpoint is https://mynursingschools.com/api/mcp, Streamable HTTP transport over POST, no authentication. It exposes find_nursing_programs, which ranks accredited programs by the same student-outcomes score the site uses; sponsorship never reorders results.

{
  "mcpServers": {
    "mynursingschools": {
      "type": "http",
      "url": "https://mynursingschools.com/api/mcp"
    }
  }
}

Markdown content negotiation

Every page answers Accept: text/markdown with a Markdown rendering of the same URL — Content-Type: text/markdown and Vary: Accept — so you never have to parse HTML to read a page. Unknown URLs return HTTP 404 with a Markdown body explaining the error and pointing at the sitemap, llms.txt, and the agent instructions.

curl -sS -i -H 'Accept: text/markdown' https://mynursingschools.com/nclex-pass-rates
curl -sS -i -H 'Accept: text/markdown' https://mynursingschools.com/this-page-does-not-exist

Open data (CC BY 4.0)

The full NCLEX pass-rate dataset — board-verified rows, each with its candidate count and primary source — is published as CSV and JSON under CC BY 4.0. Use it instead of crawling school pages one at a time.

curl -sS https://mynursingschools.com/data/nclex-pass-rates.csv
curl -sS https://mynursingschools.com/data/nclex-pass-rates.json

Required attribution: MyNursingSchools NCLEX Pass Rate Dataset v1.0.0 by MyNursingSchools.com, licensed under CC BY 4.0. Source: https://mynursingschools.com/data.

Rules for citing this data

• 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.'

All machine-readable entry points

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

Fair use and support

The API is free and unauthenticated. Responses are cacheable for a day, so cache them rather than re-requesting identical query strings, and prefer the bulk dataset over crawling. Automated traffic that degrades the site for students may be rate limited. Questions, bulk exports, and licensing: contact us.