tbank-edu-mcp

MCP server for edu.tbank.ru — connect your AI assistant to T-Bank Education.

Built with TypeScript on Cloudflare Workers. Uses the Model Context Protocol so Claude Desktop, Cursor, and other MCP clients can access your courses, timetable, and deadlines.

Python API client: mollyvita/tbank-edu-api

What It Does

Tool	What you get
get_timetable	Upcoming events — meetups, deadlines, course starts
get_my_courses	Your enrolled courses and activities
get_deadlines	Deadlines with progress tracking
get_completed_activities	Finished courses
search_catalogue	Search all available courses
get_selections	Exam selections and applications
get_notifications	Notification count
get_favorites	Your favorited courses
get_streams	Available programs and streams
get_user_info	Your profile — name, email, roles
login / logout / refresh_session	Session management

Quick Start

1. Deploy

Click the button above, or deploy manually:

git clone https://github.com/mollyvita/tbank-edu-mcp.git
cd tbank-edu-mcp
npm install
npx wrangler login
npm run deploy

2. Add Your Credentials

npx wrangler secret put TBANK_EMAIL
npx wrangler secret put TBANK_PASSWORD

This lets the server auto-login. Without secrets, you'd call the login tool manually each session.

3. Connect Your AI Client

Add to Claude Desktop or Cursor MCP config:

{
  "mcpServers": {
    "tbank-edu": {
      "url": "https://tbank-edu-mcp.<your-subdomain>.workers.dev/mcp"
    }
  }
}

That's it. Ask your AI about your courses, deadlines, or timetable.

Local Dev

npm install
npm run dev          # http://localhost:8787/mcp
npm run typecheck    # tsc --noEmit

For local testing, point your MCP client at http://localhost:8787/mcp.

Environment Variables

Variable	Default	Description
TBANK_BASE_URL	https://edu.tbank.ru	API base URL
TBANK_EMAIL	—	Auto-login email (Cloudflare secret)
TBANK_PASSWORD	—	Auto-login password (Cloudflare secret)

How It Works

src/
├── index.ts        # Worker entry point + routing
├── api-client.ts   # HTTP client — handles CSRF tokens + cookies
└── tools.ts        # MCP tool definitions

• Uses @modelcontextprotocol/sdk with Streamable HTTP transport (SSE)
• CSRF token extracted from x-edu-csrf-token response header
• Auth via JWT cookies from /api/auth/signin/v8
• Stateless per request — authenticates fresh using stored secrets

License

MIT