Skip to main content
UNILIST
daynightauto

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. 1. Clone the UniList repository and install the pinned packages from integrations/requirements-mcp.txt.
  2. 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

Sign-in is separate from MCP. Saved programs work in this browser without an account; cross-device account access depends on the production authentication service.

[open sign in →]