# put.io MCP

Private TypeScript MCP service for conversationally managing authorized content in one put.io account.

The repository is in pre-implementation planning and risk retirement. It does not yet expose working MCP tools, authenticate ChatGPT, or mutate put.io.

## Local setup

Requirements:

- Node.js 24.19.0 or newer
- pnpm 11.19.0

```sh
pnpm install --frozen-lockfile
cp .env.example .dev.vars
pnpm dev
```

The local health endpoint is `http://localhost:8787/health`. The Streamable HTTP MCP endpoint is `http://localhost:8787/mcp`. During the transport spike it exposes only `get_storage`, which safely returns `PUTIO_UNCONFIGURED` without a put.io credential or live API request.

## Verification

```sh
pnpm lint
pnpm typecheck
pnpm test
pnpm test:contract
pnpm build
pnpm build:sdk-spike
```

Never commit `.dev.vars`, tokens, OAuth codes, raw magnets, release URLs, account data, or real media filenames.

See [`AGENTS.md`](./AGENTS.md), [`docs/STATUS.md`](./docs/STATUS.md), and [`docs/threat-model.md`](./docs/threat-model.md) before changing behavior.