Content
# 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
