@pileless/mcp

MCP stdio server for Pileless. Lets Claude Code / Codex / Cursor / Cline submit Piles to Pileless and receive structured Resolution payloads.

Full docs and setup guides: https://pileless.com

Install

npx -y @pileless/mcp
# or
npm install -g @pileless/mcp

Auth

Create an API key (ak_…) in Pileless → Settings → API keys, then either:

export PILELESS_API_KEY=ak_...

or put it in ~/.pileless/config.json:

{ "api_key": "ak_..." }

Wire to Claude Code

claude mcp add pileless -- npx -y @pileless/mcp

or by hand in your MCP config:

{
  "mcpServers": {
    "pileless": {
      "command": "npx",
      "args": ["-y", "@pileless/mcp"],
      "env": { "PILELESS_API_KEY": "ak_..." }
    }
  }
}

Tools

• pile.create — submit a new Pile
• pile.capture_url — fetch a URL server-side and stage it as a Pile item
• pile.add_item — append to an open Pile (live-pile model)
• pile.seal — close a Pile to further appends
• pile.wait_for_resolution — long-poll for resolution (default 60s)
• pile.status — current state probe

Self-hosting? Point the server at your own API with PILELESS_API_URL.