# MySched developer resources

> Public integration and agent resources for MySched, a college class schedule and student planner.

MySched publishes Markdown content for agents, a typed OpenAPI document for documented public routes, a dependency-free CLI source package, and an external MCP endpoint for supported agent integrations. The OpenAPI document does not describe private app or admin routes. Do not infer private routes to be a public API.

## Agent and content resources

- [MySched developer page](https://getmysched.com/developers): human-readable resource index and integration boundaries.
- [MySched agent guide](https://getmysched.com/llms.txt): concise site context and links to useful content.
- [MySched full help corpus](https://getmysched.com/llms-full.txt): public help content in Markdown.
- [MySched home in Markdown](https://getmysched.com/llms.mdx): landing-page representation for agents.
- [MySched help docs](https://getmysched.com/docs): human-readable product and support documentation.
- [MySched OpenAPI specification](https://getmysched.com/openapi.json): machine-readable public operation and schema contract.
- Official CLI package: `mysched-cli`. Its dependency-free source, usage, and tests are in `packages/mysched-cli`. npm publication is pending project credentials.
- [MySched sitemap](https://getmysched.com/sitemap.xml): public URL inventory.

## Agent integration

- [MySched MCP server](https://mcp.getmysched.com): external Model Context Protocol access. It requires authentication before `initialize` and `tools/list`. Check the server response before use.
- [OAuth authorization-server metadata](https://getmysched.com/.well-known/oauth-authorization-server): RFC 8414 metadata. It returns 200 only when the provider endpoints are configured.
- [OAuth protected-resource metadata](https://getmysched.com/.well-known/oauth-protected-resource): RFC 9728 metadata for the protected resource. It returns 200 only when the resource and provider are configured.
- OAuth scope catalog: `schedule:read`, `docs:read`, and `calendar:read`. The catalog is a configuration default, not an active grant on the public REST routes.
- REST versioning: send `X-MySched-API-Version: 1`, or omit it to use version 1. The API publishes a deprecation timeline on this page before it removes a version.
- REST quota headers: read `RateLimit-Policy` and `RateLimit` when present. A `429` response includes `Retry-After`.
- Start without credentials: fetch `/openapi.json`, then call `/api/search?query=next%20class` or use the `mysched-cli` source package. Public routes do not require an account or API key.
- [MySched contact](https://getmysched.com/contact): ask about integration access, security, or a future public API.

## API and delivery status

MySched does not publish a general authenticated student-data API, webhook catalog, or separate authentication SDK. Do not infer private app routes to be a public API.

- [MySched developer status](https://getmysched.com/developers): current status of REST, OpenAPI, OAuth metadata, MCP, and CLI resources.