Coin Flip MCP Server

Coin Flip MCP Server

By TeglonLabs GitHub

MCP server for flipping coins with true randomness from random.org

coin-flip randomness
Overview

What is Coin Flip MCP Server?

Coin Flip MCP Server is a server that provides true random coin flips using the randomness API from random.org, demonstrating the Model Context Protocol for generating random outcomes with configurable sides.

How to use Coin Flip MCP Server?

To use the Coin Flip MCP Server, install the dependencies, build the server, and configure it with an MCP client like Claude Desktop. You can then use natural language commands to interact with the coin flip tool.

Key features of Coin Flip MCP Server?

  • Flips a coin with configurable number of sides (default is 2)
  • Uses true randomness from random.org
  • Special handling for edge cases (0, 1, or negative sides)
  • Supports multiple sides for coin flips

Use cases of Coin Flip MCP Server?

  1. Flipping a coin for decision making
  2. Rolling dice for games
  3. Generating random numbers for various applications

FAQ from Coin Flip MCP Server?

  • Can I configure the number of sides for the coin flip?

Yes! You can configure the number of sides when flipping the coin.

  • How does the server ensure true randomness?

The server uses the randomness API from random.org to ensure true randomness in the outcomes.

  • Is it easy to integrate with other applications?

Yes! The server can be easily integrated with any MCP client.

Content

Coin Flip MCP Server

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.

Features

Tools

  • flip_coin - Flip a coin with configurable number of sides
    • Optional sides parameter (default: 2)
    • Uses true randomness from random.org
    • Special handling for edge cases (0, 1, or negative sides)
    • For 2 sides: Returns "Heads" or "Tails"
    • For 3 sides: Returns "Heads", "Tails", or "_"
    • For n>3 sides: Returns "It landed on side X"

Development

Install dependencies:

npm install

Build the server:

npm run build

For development with auto-rebuild:

npm run watch

Installation

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

{
  "mcpServers": {
    "coin-flip": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-coin-flip"]
    }
  }
}

Example Usage

Once connected to an MCP client like Claude Desktop, you can use natural language to interact with the coin flip tool. For example:

  • "Flip a coin"
  • "Roll a 6-sided die"
  • "Give me a random number between 1 and 20"

The server will use true randomness from random.org to generate the result.

Debugging

Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the MCP Inspector:

npx @modelcontextprotocol/inspector node build/index.js

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

MIT

No tools information available.
No content found.