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

Install Server

HTTP connection URL

security – no known vulnerabilities

license - not found

quality - confirmed to work

How are these scores calculated?

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.

Tools

flip_coin

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.

Related Resources

Reddit Discussion about this server

Related MCP Servers

MCP Rand
turlockmike
A
security
A
license
A
quality
Provides random number generation utilities, including a secure UUID generator powered by Node's crypto module.
Last updated -
7
253
3
TypeScript
MIT License
Meme MCP Server
haltakov
A
security
A
license
A
quality
A simple Model Context Protocol server that allows AI models to generate meme images using the ImgFlip API, enabling users to create memes from text prompts.
Last updated -
1
435
31
JavaScript
Apache 2.0
CCXT MCP Server
lazy-dinosaur
A
security
A
license
A
quality
A server that allows AI models to interact with cryptocurrency exchange APIs through the Model Context Protocol, providing access to over 100 exchanges and their trading capabilities.
Last updated -
20
267
55
TypeScript
MIT License
Minesweeper MCP Server
Vic563
A
security
F
license
A
quality
Provides Minesweeper game functionality through the Model Context Protocol, allowing users to create and play custom-sized minesweeper boards through AI assistants.
Last updated -
6
JavaScript

View all related MCP servers

Coin Flip MCP Server