get_active_player_name
Retrieve the current player's name from the League of Legends client using the Live Client Data API.
Instructions
Returns the player name.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "get_active_player_name"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |
Implementation Reference
- main.py:90-97 (handler)The main handler function for the 'get_active_player_name' tool. It asynchronously fetches the active player's name from the League of Legends client API endpoint '/liveclientdata/activeplayername' and returns it as a string.
async def get_active_player_name() -> str: """ Returns the player name. """ async with get_lol_client() as client: response = await client.get("/liveclientdata/activeplayername") return response.text - main.py:88-89 (registration)The @mcp.tool() decorator registers the get_active_player_name function as an MCP tool. The @with_timeout decorator adds timeout and error handling.
@mcp.tool() @with_timeout - main.py:18-47 (helper)The 'with_timeout' decorator used by the tool to handle various HTTP errors and timeouts when communicating with the LoL client.
def with_timeout(func: Callable[..., Awaitable[T]]) -> Callable[..., Awaitable[T]]: """ Decorator to handle timeout exceptions for async functions. """ @functools.wraps(func) async def wrapper(*args: Any, **kwargs: Any) -> T: try: return await func(*args, **kwargs) except httpx.TimeoutException: return { "error": "Game has not started or connection failed.", "code": "TIMEOUT" } except httpx.ConnectError: return { "error": "Cannot connect to the game client. Please check if the game is running.", "code": "CONNECTION_ERROR" } except httpx.HTTPStatusError as e: return { "error": f"Server error: HTTP {e.response.status_code}", "code": "HTTP_ERROR", "status": e.response.status_code } except Exception as e: return { "error": f"An error occurred: {str(e)}", "code": "UNKNOWN_ERROR" } return wrapper - main.py:50-58 (helper)Helper function to create an httpx.AsyncClient configured for the LoL client API, used inside the tool handler.
def get_lol_client(): """ Create an HTTP client for the League of Legends client. """ return httpx.AsyncClient( base_url=LOL_CLIENT_HOST, verify="./certs/riotgames.pem", timeout=DEFAULT_TIMEOUT )