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

Related MCP server: time-messenger-mcp-server

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

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