iddaa-mcp

⚡ What is iddaa-mcp?

iddaa-mcp is an MCP server that gives you structured access to:

• live and upcoming sportsbook events

• competitions and leagues

• detailed match data

• highlighted events

• historical league fixtures

👉 Built for AI agents, automation, and developer workflows.

Related MCP server: Soccer V3 Scores MCP Server

🚀 Quick Start

Run instantly:

npx iddaa-mcp --stdio

🧠 What you get

• clean, structured sportsbook data

• MCP-compatible tools

• ready-to-use endpoints for agents

• localized responses (tr, en)

🔥 Why use it?

Instead of:

• scraping sportsbook data

• handling inconsistent APIs

• writing custom parsers

👉 just plug into MCP and use ready tools.

⚡ Available Tools

• get_competitions

• get_events

• get_detailed_events

• get_highlighted_events

• get_league_fixture

🧠 Example

{
  "tool": "get_highlighted_events",
  "arguments": {
    "limit": 5,
    "locale": "en"
  }
}

📊 League Fixture + Strategy

get_league_fixture supports:

• full season data

• weekly queries

• comeback analysis (1→2, 2→1)

• optional strategies:

  • martingale

  • fibonacci

Example:

{
  "tool": "get_league_fixture",
  "arguments": {
    "league": "Bundesliga",
    "strategy": "martingale"
  }
}

🌐 Transport Options

stdio (default)

Best for local MCP clients like Cursor:

{
  "mcpServers": {
    "iddaa-mcp-stdio": {
      "command": "npx",
      "args": ["iddaa-mcp", "--stdio"]
    }
  }
}

HTTP (remote / local server)

Start server:

npx iddaa-mcp --http --port 4200

Connect:

{
  "mcpServers": {
    "iddaa-mcp-http": {
      "url": "http://localhost:4200/mcp"
    }
  }
}

🌍 Language Support

• default: tr

• optional: en

{
  "locale": "en"
}

⚙️ Features

• MCP-native tool system

• stdio + HTTP support

• structured and predictable outputs

• type-safe schemas (zod)

• league fixture analysis

• strategy simulation

• AI-ready responses

📦 Install

npm install -g iddaa-mcp

or:

npx iddaa-mcp --stdio

🧠 Use Cases

• AI betting assistants

• sports data automation

• odds analysis pipelines

• MCP-based agents

• research & strategy testing

💡 Philosophy

Give AI and developers clean, structured access to sportsbook data.

❤️ Support

If this tool helps you:

⭐ Star the repo
☕ Support via GitHub Sponsors

https://github.com/sponsors/borakilicoglu

🔗 Links

• GitHub: https://github.com/borakilicoglu/iddaa-mcp

• npm: https://www.npmjs.com/package/iddaa-mcp