An MCP server that provides true random coin flips using random.org's randomness API. This server demonstrates the Model Context Protocol by providing a tool for generating random outcomes with configurable sides.
flip_coin - Flip a coin with configurable number of sidessides parameter (default: 2)Install dependencies:
Build the server:
For development with auto-rebuild:
To use with Claude Desktop, add the server config:
On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
On Windows: %APPDATA%/Claude/claude_desktop_config.json
Once connected to an MCP client like Claude Desktop, you can use natural language to interact with the coin flip tool. For example:
The server will use true randomness from random.org to generate the result.
Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the MCP Inspector:
Contributions are welcome! Please feel free to submit a Pull Request.
MIT
You must be authenticated.
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Enables interaction with a tool for generating true random coin flips via random.org's API, supporting multiple custom side configurations and illustrating the Model Context Protocol.