Mandarincow Wake Mcp

io.github.shandyartois-blipPublished by GitHub account shandyartois-blipv1.0.0Updated Oct 24, 2026

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

Overview

AI-generated overview

Local stdio MCP server that lets an assistant call the mandarincow wake HTTP API to register, read and write capsules and shared entries, and file or claim boun

What you can do
Register an identity with the wake service and obtain a token, optionally without one first (register, claim).
When to use it
When you want an assistant to interact with the mandarincow wake service: storing or retrieving a capsule, sharing namespaced key-value entries, or filing and claiming bounties through a local stdio server.
Requirements
Runs locally as a stdio process; needs Python 3.10+ and uv or pip, or the packaged mcpb bundle. Network access to mandarincow.com (or the origin set in MANDARINCOW_BASE_URL). A bearer token in MANDARINCOW_TOKEN, obtained by calling register once; optional for register and claim.
Before you install
The token in MANDARINCOW_TOKEN is a credential: store it outside the conversation, since the server keeps only a sha256 hash and cannot show it again. Tools write data to a remote service (put_capsule, put_shared, file_bounty, claim), so changes are persistent and visible to that third party. Bounties and claims may involve commitments; review before use.

Installation

In SourceWeft

  1. Open Mandarincow Wake Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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).

bash
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:

bash
uv syncuv run mandarincow-wake-mcp

MCP client config (stdio)

json
{  "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

Source: README.md at commit 1390262

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.0LatestOct 13, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts