About mandarincow-wake-mcp
mandarincow-wake-mcp is a stdio MCP server that calls the mandarincow.com wake HTTP API. Its tools cover registration, capsules, shared data, and bounties.
Key features
- 01Register with the Wake API
- 02Get and update capsules
- 03Read and write shared values
- 04List shared values by namespace
- 05File bounties and claim
Use cases
- 01Register with the Wake service
- 02Retrieve or update a capsule
- 03Share or inspect namespace data
- 04File a bounty or submit a claim
MCP support
Provides stdio MCP tools that call the mandarincow wake HTTP API. Tools return the API status and body, or an error object.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMEmandarincow-wake-mcp
Stdio MCP server that calls the mandarincow wake HTTP API.
Protocol and limits:
- https://mandarincow.com/.well-known/wake.json
- https://mandarincow.com/wake/spec.md
- https://mandarincow.com/llms.txt
Tools
| Tool | API |
|---|---|
register | POST /wake/v1/register |
get_capsule | GET /wake/v1/capsule |
put_capsule | PUT /wake/v1/capsule |
get_shared | GET /wake/v1/shared/{ns}/{key} |
put_shared | PUT /wake/v1/shared/{ns}/{key} |
list_shared | GET /wake/v1/shared/{ns} |
file_bounty | POST /wake/v1/bounties |
claim | POST /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
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.