Coin Flip MCP Server

@TeglonLabs

About Coin Flip MCP Server

MCP server for flipping coins with varying degrees of randomness from random.org

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "coin-flip-mcp": {
      "command": "npx",
      "args": [
        "@modelcontextprotocol/inspector",
        "node",
        "build/index.js"
      ]
    }
  }
}

Tools

Flip a coin with configurable number of sides

Overview

What is Coin Flip MCP Server?

An MCP server that provides true random coin flips using random.org's randomness API. It demonstrates the Model Context Protocol by offering a tool for generating random outcomes with configurable sides.

How to use Coin Flip MCP Server?

Install dependencies with npm install, build with npm run build, then add the server configuration to your Claude Desktop config file. Invoke the tool using natural language commands such as "Flip a coin" or "Roll a 6-sided die."

Key features of Coin Flip MCP Server

Uses true randomness from the random.org API
Configurable number of sides (default 2)
Special handling for edge cases (0, 1, negative sides)
Human-readable results: Heads, Tails, or side numbers

Use cases of Coin Flip MCP Server

Adding true random coin flips to AI conversations
Simulating dice rolls with custom numbers of sides
Generating random numbers between 1 and n
Demonstrating MCP tool creation with external API integration

FAQ from Coin Flip MCP Server

What randomness source does it use?

It uses random.org's true randomness API, not pseudorandom generators.

How do I install and configure it?

Install via npm, build the server, then add the JSON config to your Claude Desktop configuration file (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json, Windows: %APPDATA%/Claude/claude_desktop_config.json).

What happens if I set sides to 0 or negative?

The server has special handling for edge cases; it will not crash and will return an appropriate result.

What transport does it use?

It communicates over stdio (standard input/output).

Frequently asked questions

What randomness source does it use?

It uses random.org's true randomness API, not pseudorandom generators.

How do I install and configure it?

Install via npm, build the server, then add the JSON config to your Claude Desktop configuration file (macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`, Windows: `%APPDATA%/Claude/claude_desktop_config.json`).