sports

This MCP server, named 'sports', provides a minimal MCP implementation that exposes Cloudbet sports data and betting tools via the public Cloudbet API. It adheres to the MCP Server specification and can list available tools and execute tool calls in a standardized JSON-RPC format. Use the tools/list method to discover the available capabilities, and then call tools/call with the appropriate tool name and arguments to retrieve events, markets, or other sports data supported by the Cloudbet integration. The server is designed for educational and demonstration purposes, so expect sample or read-only endpoints suitable for experimentation.

Prerequisites:

• Go installed (go1.20+ recommended)
• Internet access to fetch dependencies (if required by the Go module setup)

Installation steps:

1. Clone or download the MCP server repository containing the Cloudbet Sports MCP server (the project that includes the main.go or single-file Go server).
2. Open a terminal and navigate to the project directory.
3. Run the server:

go run .

4. The server should start listening on http://localhost:8080 by default. If you need to run in a different environment, adjust the port or binding as needed in the code and re-run.

Optional: If you want to build a binary first:

go build -o sports-mcp-server .
./sports-mcp-server

Note: The exact build steps may vary slightly depending on how the single-file Go server is structured in your repository.

Tips and common considerations:

• Default endpoint: http://localhost:8080/
• Tools are accessed via JSON-RPC methods:
  • Tools listing: { "jsonrpc": "2.0", "id": 1, "method": "tools/list", "params": {} }
  • Tool invocation: { "jsonrpc": "2.0", "id": 2, "method": "tools/call", "params": { "name": "findEventsAndMarketsByCompetition", "arguments": { "competitionName": "Premier League" } } }
• The example tool name findEventsAndMarketsByCompetition suggests you can filter events by competition name; actual tool names may vary, so use tools/list to discover exact capabilities.
• Since this demo uses the public Cloudbet API, be mindful of API rate limits and terms of use.
• If you encounter port conflicts, adjust the server’s listening port within the source code and rebuild/run.