education_files

Where B.C.'s published education statistics are: the K-12 school directory (names, addresses, coordinates, French program indicators), K-12 student enrolment and FTE, headcount, class size, Foundation Skills Assessment, graduation rate, grade-to-grade transition, course enrolment, exam results, satisfaction survey, school district information and teacher statistics, and public post-secondary FTE, headcount and graduate outcomes. Returns each CSV file with its columns, size, the dataset page and the download address. Small files can be read with fetch_record (upstream true); large ones are listed with their download address only. Aggregates by school, district or institution, small counts already suppressed by the ministries.

Cost: 1 unit of your allowance (see Rate limits).

ParametersCopy Anchor Link

• level (k12, post_secondary, optional)
• topic (enrolment, headcount, class_size, school_locations, fsa, graduation, transition, courses, exams, satisfaction, district_info, teachers, ps_fte, ps_headcount, ps_graduate_outcomes, optional)
• query (string, optional): min length 1, max length 60
• limit (integer, optional): min 1, max 50, default 40

RESTCopy Anchor Link

curl -X POST https://api.bcmcp.ca/v1/tools/education_files \
  -H "Authorization: Bearer $BCDATA_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

MCPCopy Anchor Link

Call the tool education_files with these arguments. Over raw JSON-RPC:

curl -X POST https://api.bcmcp.ca/mcp \
  -H "Authorization: Bearer $BCDATA_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"education_files","arguments":{}}}'

What comes backCopy Anchor Link

Every answer is the same envelope, over REST and over MCP: available, data, citations, freshness and notes. See Citations and freshness.