io.github.Vublox/sports
Live football scores, match summaries, and fan clip links from Vublox. No API key required.
Open source Open in the app JSON README (API)
About
Live football scores, match summaries, and fan clip links from Vublox. No API key required.
Details
- Kind
- MCP servers
- Topic
- No topic detected
- Publisher
- vublox
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 0.1.3
- Stars
- 1
- Forks
- 1
- Last push
- 2026-07-03T17:10:36Z
- Repository state
- ativo
- Language
- JavaScript
- Added
- 2026-08-29 03:02:19
- Updated
- 2026-08-29 03:02:19
- Origin id
io.github.Vublox/sports
README
# 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