school_lookup

Find B.C. K-12 schools (public and independent) from the Ministry of Education and Child Care's school list on DataBC, read live: the school's name, district, category, level, address, phone and website, coordinates, and whether it offers Core French, Early or Late French Immersion or a Francophone program. Filter by name words, school district, town, public or independent, education level, a French program, or search near a point (lat, lon, radius_km). Institutions and locations only: no student, teacher or principal data. Enrolment, class size and results are in education_files.

Cost: 5 units of your allowance (see Rate limits).

ParametersCopy Anchor Link

• name (string, optional): min length 1, max length 60
• district (string, optional): min length 1, max length 60
• locality (string, optional): min length 1, max length 60
• category (public, independent, optional)
• education_level (elementary, elementary_junior_secondary, elementary_secondary, middle, junior_secondary, senior_secondary, secondary, optional)
• french (core_french, early_french_immersion, late_french_immersion, francophone_program, optional)
• lat (number, optional): min 47.5, max 61
• lon (number, optional): min -140, max -113
• radius_km (number, optional): min 0.5, max 50
• limit (integer, optional): min 1, max 50, default 20

RESTCopy Anchor Link

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

MCPCopy Anchor Link

Call the tool school_lookup 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":"school_lookup","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.