Skip to main content
Glama
enesjakozh
TeglonLabs

Coin Flip MCP Server

by TeglonLabs
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Remote

코인 플립 MCP 서버

random.org의 난수 API를 사용하여 실제 무작위 동전 던지기를 제공하는 MCP 서버입니다. 이 서버는 구성 가능한 면으로 무작위 결과를 생성하는 도구를 제공하여 모델 컨텍스트 프로토콜(MCP)을 보여줍니다.

특징

도구

  • flip_coin - 면의 개수를 설정할 수 있는 동전 던지기

    • 선택적인 sides 매개변수(기본값: 2)

    • random.org의 진정한 난수성을 사용합니다.

    • 에지 케이스(0, 1 또는 음수 측면)에 대한 특별 처리

    • 2면의 경우: "앞면" 또는 "뒷면"을 반환합니다.

    • 3면의 경우: "앞면", "뒷면" 또는 "_"를 반환합니다.

    • n>3면의 경우: "X면에 착륙했습니다"를 반환합니다.

Related MCP server: MCP Lottery Demo

개발

종속성 설치:

지엑스피1

서버를 빌드하세요:

npm run build

자동 재빌드를 사용한 개발의 경우:

npm run watch

설치

Claude Desktop과 함께 사용하려면 서버 구성을 추가하세요.

MacOS의 경우: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows의 경우: %APPDATA%/Claude/claude_desktop_config.json

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

사용 예

Claude Desktop과 같은 MCP 클라이언트에 연결하면 자연어를 사용하여 동전 던지기 도구와 상호 작용할 수 있습니다. 예:

  • "동전 던지기"

  • "6면체 주사위를 굴려라"

  • "1에서 20 사이의 무작위 숫자를 주세요"

서버는 random.org의 진정한 난수성을 사용하여 결과를 생성합니다.

디버깅

MCP 서버는 stdio를 통해 통신하므로 디버깅이 어려울 수 있습니다. MCP Inspector 사용을 권장합니다.

npx @modelcontextprotocol/inspector node build/index.js

기여하다

기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.

특허

MIT

Available Tools

1 tool
flip_coinB

Flip a coin with n sides using true randomness from random.org. For 3-sided coins, try creative side names like:

  • past/present/future (temporal analysis)

  • true/unknown/false (epistemic states)

  • win/draw/lose (outcome evaluation)

  • rock/paper/scissors (cyclic relationships)

  • less/same/more (abstraction levels)

  • below/within/above (hierarchical positioning)

  • predecessor/current/successor (ordinal progression)

Meta-usage patterns:

  1. Use less/same/more to guide abstraction level of discourse

  2. Use past/present/future to determine temporal focus

  3. Chain multiple flips to create decision trees

  4. Use predecessor/current/successor for ordinal analysis

Ordinal Meta-patterns:

  • Use predecessor to refine previous concepts

  • Use current to stabilize existing patterns

  • Use successor to evolve into new forms

Default ternary values are -/0/+

ParametersJSON Schema
NameRequiredDescriptionDefault
sideNamesNoOptional custom names for sides (must match number of sides)
sidesNoNumber of sides (default: 3)

TDQS

B3.2/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden. It discloses the randomness source ('true randomness from random.org') and default behavior ('Default ternary values are -/0/+'), but it doesn't cover potential rate limits, error conditions, or output format details. This provides some behavioral context but leaves gaps.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness2/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is overly verbose and poorly structured, with extensive examples and meta-patterns that may not all be necessary. It's front-loaded with the core purpose but then diverges into lengthy lists and patterns, reducing clarity and efficiency. Some content could be trimmed without losing essential information.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's low complexity (2 parameters, no output schema, no annotations), the description is somewhat complete but excessive. It covers purpose and usage ideas but lacks output details and could be more focused. The richness in examples compensates partially but doesn't fully align with the tool's simplicity.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema description coverage is 100%, so the baseline is 3. The description adds value by explaining creative uses for 3-sided coins and meta-patterns, which indirectly clarifies parameter semantics (e.g., how 'sideNames' might be applied). However, it doesn't explicitly detail parameter meanings beyond what the schema provides.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's purpose: 'Flip a coin with n sides using true randomness from random.org.' This specifies the verb ('Flip'), resource ('coin'), and randomness source. However, it doesn't distinguish from siblings since there are none, so it can't achieve a perfect 5.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides implied usage through examples of 3-sided coins and meta-usage patterns, suggesting when to use specific configurations. However, it lacks explicit guidance on when to use this tool versus alternatives (none exist) or clear exclusions, keeping it at an intermediate level.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 1 tool updatev1.0.0
    • First observedflip_coin
Deploy Server
RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

TDQS

B3.3/5.0

Scored across 1 tool

Disambiguation5/5

With only one tool, there is no possibility of confusion or overlap between tools. The tool 'flip_coin' has a single, clearly defined purpose.

Naming Consistency5/5

Since there is only one tool, naming consistency is inherently perfect. The tool name 'flip_coin' follows a clear verb_noun pattern.

Tool Count2/5

A single tool is too few for a server's purpose, as it limits functionality and suggests an incomplete or overly narrow scope. While the tool is versatile, the server would benefit from additional tools to support more complex operations.

Completeness2/5

The server's domain appears to be random generation or decision-making, but with only one tool, there are significant gaps. For example, there are no tools for setting parameters, retrieving results, or managing multiple flips in a structured way, which limits agent workflows.

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Scryfall MCP Server

    cryppadotta
    A
    license
    A
    quality
    D
    maintenance
    Enables interaction with the Scryfall API, allowing users to search for Magic: The Gathering card details, retrieve card rulings, and access pricing information using the Model Context Protocol.
    7
    21,790
    34
    MIT

  • MCP Lottery Demo

    pmhw
    F
    license
    A
    quality
    D
    maintenance
    Enables random selection tools including lottery drawing from option lists, dice rolling with customizable sides and counts, and coin flipping. Supports both single and multiple draws with duplicate control options.
    3
    2
    -

  • Dice MCP Server

    aaronmeis
    F
    license
    Not graded
    quality
    D
    maintenance
    Provides dice rolling and coin flipping functionality for AI assistants via the Model Context Protocol. It enables users to roll single or multiple dice with configurable sides and perform randomized coin tosses.
    1
    -

  • neon

    universal-mcp
    A
    license
    Not graded
    quality
    D
    maintenance
    Provides a standardized interface for interacting with Neon's tools and services through a unified API via the Model Context Protocol.
    MIT

Appeared in Searches