Skip to main content
Glama
Vublox Agent Tools

Vublox Agent Tools

Official
by Vublox
README.md
# Vublox Agent Tools

> **Let AI agents discover live football matches, players, and fan clips on Vublox.**

An MCP (Model Context Protocol) server that lets AI agents find football matches and players on Vublox — which matches are live or recent, what the score is, player profiles, and links to fan-shot video clips. Each result links to the match or profile page on Vublox.

No API key required — just install and use.

## Quick Start

### 1. Install & Configure

**Claude Desktop:**
```json
// claude_desktop_config.json
{
  "mcpServers": {
    "vublox-sports": {
      "command": "npx",
      "args": ["@vublox/agent-tools"]
    }
  }
}
```

**VS Code Copilot:**
```json
// .vscode/mcp.json
{
  "servers": {
    "vublox-sports": {
      "type": "stdio",
      "command": "npx",
      "args": ["@vublox/agent-tools"]
    }
  }
}
```

### 2. Ask Your Agent

Try these in your agent:
- "What football matches are live right now?"
- "How did Arsenal do today?"
- "Show me today's Premier League scores"
- "Who is Kylian Mbappé?"
- "Tell me about the Barcelona vs Real Madrid match"

## Available Tools

| Tool | Description |
|------|-------------|
| `search_sports_events` | Search matches by team, league, or keyword |
| `search_players` | Search football players by name — returns profile links |
| `get_live_matches` | All currently live football matches |
| `get_match_summary` | Match info for a specific match |
| `get_todays_goals` | Recent match scores across leagues (last 48h) |
| `get_recent_matches` | Recently finished matches (last 48h) |

## Local Development

```bash
npm install
npm run dev
```

## Environment Variables

| Variable | Required | Description |
|----------|----------|-------------|
| `VUBLOX_API_BASE_URL` | No | Override API base URL (default: production) |

## License

MIT — Vublox

TDQS

A3.5/5.0

Scored across 5 tools

Disambiguation2/5

Two tools, get_recent_matches and get_todays_goals, have nearly identical descriptions covering the last 48 hours, creating confusion. The other tools are distinct, but this overlap makes it hard for an agent to choose correctly.

Naming Consistency5/5

All tools follow a consistent get_<noun> pattern using snake_case, making them predictable and easy to understand. No mixing of conventions or verb styles.

Tool Count5/5

With 5 tools, the set is well-scoped for retrieving football match data from Vublox. Each tool serves a clear purpose, and the count is appropriate without being excessive or insufficient.

Completeness4/5

The tools cover live matches, recent matches, today's goals, search, and a summary endpoint, which is sufficient for basic match information retrieval. Minor gaps exist, such as historical data beyond 48 hours, but the main use cases are covered.