{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_z6yr969rb7n9","handle":"usos-mcp","url":"https://wellknown.network/agents/usos-mcp","links":{"self":"https://wellknown.network/agents/usos-mcp/record.json","html":"https://wellknown.network/agents/usos-mcp","markdown":"https://wellknown.network/agents/usos-mcp/record.md","api":"https://wellknown.network/api/v1/agents/usos-mcp","status":"https://wellknown.network/api/v1/agents/usos-mcp/status","claim":"https://wellknown.network/agents/usos-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/usos-mcp/claim.json","badge":"https://wellknown.network/agents/usos-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/usos-mcp/history","tools":"https://wellknown.network/api/v1/agents/usos-mcp/tools"},"ard":{"identifier":"urn:air::server:usos-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"usos-mcp","summary":"MCP server for USOS (Uniwersytecki System Obsługi Studiów)","description":"# USOS Model Context Protocol (MCP) Server\n\nA standardized Model Context Protocol (MCP) server that bridges the official **USOS API** (Uniwersytecki System Obsługi\nStudiów) with generative AI clients (such as Claude Code, Claude Desktop, Cursor, and web-based assistants via tunnels).\n\nThis server allows students of Polish universities to query their schedules, track academic grades, monitor ECTS\naccumulation, search for lecturer contact data, and review study programs through natural language conversations.\n\n---\n\n## Usage with MCP Clients (e.g., Cursor, Claude desktop)\n\nYou can connect this server to any MCP-compatible client like Cursor.\n\n### Authenticating with USOS\n\nUse the `authenticate_me` prompt to guide the user through the interactive OAuth setup. It should be run one step at a\ntime, waiting for the user's response before continuing. Alternatively, the user can call the `login` tool directly.\nOnce authentication is complete, credentials are saved securely to local file storage (typically\n`~/.config/usos-mcp/store/auth/credentials.json`) so they do not need to be supplied as environment variables in later\nruns.\n\n### Option A: Running via PyPI (Recommended)\n\nIf you have `uv` installed, you can use `uvx` to fetch and run the package dynamically without manual installation:\n\n```json\n{\n  \"mcpServers\": {\n    \"usos\": {\n      \"command\": \"uvx\",\n      \"args\": [\n        \"--from\",\n        \"usos-mcp\",\n        \"server\"\n      ]\n    }\n  }\n}\n```\n\n### Option B: Running via Docker\n\nIf you prefer not to install Python/uv locally, you can use the Docker image. The `-i` flag is required for MCP to\ncommunicate over standard input/output.\n\n```json\n{\n  \"mcpServers\": {\n    \"usos\": {\n      \"command\": \"docker\",\n      \"args\": [\n        \"run\",\n        \"-i\",\n        \"--rm\",\n        \"ghcr.io/skalskidaniel/usos-mcp:latest\"\n      ]\n    }\n  }\n}\n```\n\n## Contributing\n\nContributions are welcome! This server is built with a modular registry pattern that makes adding new USOS API\nintegrations sim…","publisher":null,"homepage":null,"repository":null,"version":"0.4.0","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:usos-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"security.identity","name":"Identity & Access","confidence":1,"provenance":"derived"},{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":0.768,"provenance":"derived"}],"categories":["dev","security"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"usos-mcp","registry":"pypi","observedAt":"2026-09-10T15:25:02.157Z","publishedAt":"2026-06-03T20:19:06.955540Z","latestVersion":"0.4.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"usos-mcp","url":"https://pypi.org/project/usos-mcp/","firstSeenAt":"2026-09-10T15:23:00.554Z","fetchedAt":"2026-09-10T15:23:00.554Z","normalizedAt":"2026-09-10T15:23:00.554Z"}]},"firstSeenAt":"2026-09-10T15:23:00.554Z","updatedAt":"2026-09-10T15:25:02.157Z"}