Read-only catalog access

Connect an AI client to UniList

The hosted read-only endpoint works with clients that accept MCP over Streamable HTTP. It can search programs, universities, cities, degree summaries, dataset coverage, and identity-level comparisons.

Hosted connection

live endpoint

Add this Streamable HTTP URL to ChatGPT, Claude, Codex, or another remote MCP client. It exposes public catalog data only and does not access UniList accounts.

https://theunilist.org/api/mcp

Ranking and outcome fields are withheld from this endpoint until UniList retains public-redistribution rights evidence. Technical source matching alone is not publication authority.

Local stdio setup

1. Clone the UniList repository and install the pinned packages from integrations/requirements-mcp.txt.
2. Add this configuration to a local client that supports MCP over standard input/output. Replace the path with the absolute path to your clone.

{
  "mcpServers": {
    "unilist": {
      "command": "python3",
      "args": ["/absolute/path/to/unilist/integrations/mcp_server.py"]
    }
  }
}

The local Python server remains a development catalog tool. The hosted endpoint applies the stricter release-rights boundary described above. Neither transport can edit UniList data or user accounts.

Account access

MCP is public and read-only, so the same catalog tools work while signed out or signed in. An account only adds cross-device saved programs and profile access; MCP cannot read private account data.

[open sign in →]