Minakeep MCP

Use this public showroom as a source of truth repository

Published notes and links can be read by MCP clients as markdown resources. Private drafts, owner search, settings, and token state stay outside this public boundary.

Live check

Test this repository

Runs initialize, list, and call as separate MCP requests. Each step maps to its own curl command.

initializeidle

Open a protocol session with the MCP server.

curl -s https://minakeep.mina.asia/mcp \
  -H 'content-type: application/json' \
  --data '{
  "jsonrpc": "2.0",
  "id": "initialize",
  "method": "initialize",
  "params": {
    "protocolVersion": "2025-06-18",
    "capabilities": {},
    "clientInfo": {
      "name": "minakeep-public-guide",
      "version": "1.0.0"
    }
  }
}'

Ready

listidle

List published note and link resources.

curl -s https://minakeep.mina.asia/mcp \
  -H 'content-type: application/json' \
  --data '{
  "jsonrpc": "2.0",
  "id": "resources/list",
  "method": "resources/list"
}'

Ready

callidle

Read the first resource returned by list.

curl -s https://minakeep.mina.asia/mcp \
  -H 'content-type: application/json' \
  --data '{
  "jsonrpc": "2.0",
  "id": "resources/read",
  "method": "resources/read",
  "params": {
    "uri": "minakeep://articles/note/example-slug"
  }
}'

Waiting for list result

Endpoint

Connect with Streamable HTTP

URL: https://minakeep.mina.asia/mcp
Access: Public resources are open
Resources: Published notes and safe published links

curl

List public resources

curl -s https://minakeep.mina.asia/mcp \
  -H 'content-type: application/json' \
  --data '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "resources/list"
  }'

Mina CLI

Inspect with mmcp

@minasoft/mmcp-cli is a command line MCP inspector for resources, tools, prompts, completion, and raw JSON-RPC calls.

npm install -g @minasoft/mmcp-cli
mmcp resources list https://minakeep.mina.asia/mcp
mmcp resources templates https://minakeep.mina.asia/mcp
mmcp resources read https://minakeep.mina.asia/mcp --uri minakeep://articles/note/example-slug

Resource templates

Read a note or link

minakeep://articles/note/{slug}
minakeep://articles/link/{id}

curl -s https://minakeep.mina.asia/mcp \
  -H 'content-type: application/json' \
  --data '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "resources/read",
    "params": {
      "uri": "minakeep://articles/note/example-slug"
    }
  }'