UH Course Search

MCP Server

Connect an AI agent (e.g. Claude) to UH course data in natural language. This is a public, read-only Model Context Protocol server exposing the course-search side of this site.

Connect

Add this URL as a remote MCP server in your client. No account or key required. 

https://uhcourses.ethanchung.dev/api/mcp

It speaks JSON-RPC 2.0 over HTTP (stateless Streamable HTTP, JSON responses).

Tools

  • list_terms — Available terms (code + description + backfilled flag).
  • list_filters — Valid values for a filter menu (subject, campus, college, …).
  • search_sections — Search sections in a term; or look up one CRN.
  • get_course — Catalog facts for one course at one campus.
  • get_section — Per-CRN detail: restrictions, fees, cross-list, syllabus.
  • get_instructor — Instructor contact card by Banner ID.

Limits

  • Rate limit: 30 tool calls per minute per IP address.
  • Page size: search_sections returns at most 50 sections per call (default 20).
  • Pagination: pageOffset is capped at 200 — narrow with filters (subject, course number, campus) rather than paging deeply.
  • Read-only: no write or mutation tools.
  • Public: no authentication; usage is best-effort and may change.

Data

Sourced from the University of Hawaii Student Information System. Past terms are immutable snapshots; the current term refreshes daily. Unofficial project, not affiliated with or endorsed by the University of Hawaii or Ellucian.