# Magisterial connectors (MCP)

Magisterial runs a remote MCP (Model Context Protocol) server so AI
assistants can query college sports data directly — rosters, season stats,
games, careers, transfers — across seven sports and every covered division.
A connected assistant gets the same data access as the account's plan.

Connector URL: https://api.magisterial.ai/mcp
(streamable HTTP; OAuth 2.1 sign-in, or an API key as a bearer token)

Machine discovery: https://magisterial.ai/.well-known/mcp.json
OAuth metadata (RFC 8414/9728): https://api.magisterial.ai/.well-known/oauth-authorization-server

## Claude (claude.ai + desktop)

1. Settings -> Connectors -> Add custom connector.
2. Paste https://api.magisterial.ai/mcp
3. Sign in on magisterial.ai and approve.
4. Enable "magisterial" from the tools menu in any chat.

Custom connectors require Claude Pro, Max, Team, or Enterprise.

## Claude Code

    claude mcp add --transport http magisterial https://api.magisterial.ai/mcp

Then run /mcp inside Claude Code to sign in. For scripts and headless use,
authenticate with an API key instead:

    claude mcp add --transport http magisterial https://api.magisterial.ai/mcp \
      --header "Authorization: Bearer mag_live_..."

## ChatGPT (developer mode)

1. Settings -> Apps & Connectors -> enable Developer mode (under Advanced).
2. Create, name it Magisterial, paste the connector URL.
3. Pick OAuth as the auth method, sign in, approve.
4. Enable the connector from the composer's tools menu.

## Any other MCP client

Any client supporting remote MCP servers works: connect to the URL and sign
in when prompted. Clients that only support static credentials can send an
API key (self-serve at https://magisterial.ai/console) as a bearer token in
the Authorization header.

## Example prompts once connected

- Who were the top 10 goal scorers in D3 men's soccer last season?
- Which women's volleyball teams had the best win percentage in D2?
- Show me this player's career across every program they've played for.
- Build a shortlist of left-footed defenders in NAIA men's soccer.

## Access and security

Connections use OAuth: sign in on magisterial.ai, approve once per
assistant, no password shared. The connector reads exactly what the plan
allows; disconnect anytime from the assistant's settings. Paid plans
additionally unlock live transfer-portal data through the connector.