ValoDesk

ValoDesk preview

Stack

Python, LangGraph, LangChain, MCP, OpenAI, SQLite

Background

I built ValoDesk because I kept looking up VCT stats while watching matches. Something simple like checking a team’s record on a certain map or seeing how two teams had done against each other usually meant jumping through a few pages on vlr.gg.

I thought it would be a lot nicer if I could just ask for the stat directly from my terminal and get the answer back, which is what ValoDesk became.

Overview

ValoDesk is a conversational CLI for asking questions about Valorant Champions Tour esports. You can ask about upcoming matches, map records, head-to-heads, or regional player leaderboards directly from the terminal.

Under the hood, a LangGraph agent decides which tool it needs based on the question. Those tools are exposed through a local MCP server and pull VCT data using vlrggapi, an unofficial API wrapper around vlr.gg. Conversations are stored in SQLite, so follow-ups work without having to repeat the team or previous question. You can also close ValoDesk and come back to an old conversation later.

All match and stats data comes through vlrggapi, created by axsddlr.