home / mcp / cloudbet sports mcp server

Cloudbet Sports MCP Server

Single-file MCP server exposing Cloudbet sports data and tools via HTTP on localhost and via a local Go runtime.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "cloudbet-sports-mcp-server": {
      "url": "http://localhost:8080/"
    }
  }
}

This Cloudbet Sports MCP Server provides a minimal, single-file implementation of the Model Context Protocol (MCP) to expose sports data and betting tools from the public Cloudbet API. It runs locally and can be explored and invoked by an MCP client to discover available tools and execute actions such as finding events and markets by competition.

How to use

You interact with the MCP server using a client that speaks the MCP protocol. Start the server, then discover which tools are available, and finally invoke a tool to retrieve data. The server exposes a HTTP endpoint you can query to list tools and to call specific tools by name. Use your MCP client to perform these steps: start the server, list tools, and call a tool like findEventsAndMarketsByCompetition with a competitionName parameter.

How to install

Prerequisites you need before running the server: a Go 1.20+ toolchain (or newer) installed on your system.

Install Go (if needed) and verify the installation by checking the version.

Run the server locally from its directory using the Go run command.

go version

go run .

Additional notes

The server serves HTTP on port 8080 by default. You can use an MCP client to list available tools and call specific tools by name. The following actions are supported by the sample server: listing tools and calling a tool named findEventsAndMarketsByCompetition with a competitionName argument such as Premier League.

Security and usage notes

Treat this as a demonstration and use responsibly. Do not expose the server to untrusted networks without proper access controls. When integrating in production, consider adding authentication, rate limiting, and proper error handling in your client and server setup.

Troubleshooting

If the server fails to start, verify that Go is installed and that you are running the command from the server’s directory. Ensure no other process is listening on port 8080. If you see permission or network errors, check your firewall or proxy settings and adjust accordingly.

Available tools

tools_list

Lists all available MCP tools provided by the server.

tools_call

Calls a specific MCP tool by name with the given arguments.

find_events_and_markets_by_competition

Finds events and markets by a given competition name, such as Premier League.