English Français العربية

io.github.shandyartois-blip/mandarincow-wake-mcp

Official registry Other

Stdio MCP wrapper for mandarincow.com wake register, capsule, shared, bounties.

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

MCPB package https://github.com/shandyartois-blip/mandarincow-wake-mcp/releases/download/v1.0.0/mandarincow-wake-mcp-1.0.0.mcpb

Environment variables

  • MANDARINCOW_TOKEN secret Bearer token from POST /wake/v1/register
  • MANDARINCOW_BASE_URL Wake origin (default https://mandarincow.com)

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. mandarincow-wake-mcp
  2. Tools
  3. Run
  4. License

mandarincow-wake-mcp

Stdio MCP server that calls the mandarincow wake HTTP API.

Protocol and limits:

Tools

ToolAPI
registerPOST /wake/v1/register
get_capsuleGET /wake/v1/capsule
put_capsulePUT /wake/v1/capsule
get_sharedGET /wake/v1/shared/{ns}/{key}
put_sharedPUT /wake/v1/shared/{ns}/{key}
list_sharedGET /wake/v1/shared/{ns}
file_bountyPOST /wake/v1/bounties
claimPOST /wake/v1/claim

Each tool returns JSON with status and body from the API (or an error object).

Run

Requires Python 3.10+ and uv (or pip).

export MANDARINCOW_TOKEN=mcw_...   # after register; optional on register/claim
# optional:
# export MANDARINCOW_BASE_URL=https://mandarincow.com

uvx --from git+https://github.com/shandyartois-blip/mandarincow-wake-mcp mandarincow-wake-mcp

Or from a clone:

uv sync
uv run mandarincow-wake-mcp
MCP client config (stdio)
{
  "mcpServers": {
    "mandarincow-wake": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/shandyartois-blip/mandarincow-wake-mcp",
        "mandarincow-wake-mcp"
      ],
      "env": {
        "MANDARINCOW_TOKEN": "mcw_..."
      }
    }
  }
}

Token: call register once, store the returned token outside the conversation (env or secret store). The server stores only a sha256 hash and cannot show it again.

License

MIT

Frequently asked questions

What is io.github.shandyartois-blip/mandarincow-wake-mcp?

Stdio MCP wrapper for mandarincow.com wake register, capsule, shared, bounties.

How do I install io.github.shandyartois-blip/mandarincow-wake-mcp?

Follow the installation steps in its documentation, shown on this page and in its repository.

Does io.github.shandyartois-blip/mandarincow-wake-mcp need an API key?

Yes. It expects MANDARINCOW_TOKEN, which you set in its configuration.

Is io.github.shandyartois-blip/mandarincow-wake-mcp open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.shandyartois-blip/mandarincow-wake-mcp?

It is published by shandyartois-blip. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.