# Public MCP (/docs/mcp)



The public MCP is a coding helper, not an account API. It exposes only guidance
tools, so agents can fetch the install command, route-handler shape, and the
installable s3.delivery skill without touching your files or secrets.

```txt
https://api.s3.delivery/mcp
```

## Tools [#tools]

| Tool                | What it does                                   |
| ------------------- | ---------------------------------------------- |
| `write_upload_code` | Returns minimal install and upload-route code. |
| `get_agent_skill`   | Returns the s3.delivery agent skill markdown.  |

The MCP does not accept an API key and does not expose `upload`, `delete`, or
`listFiles`. For real file access, use the SDK with an API key from the
dashboard.

## Agent skill [#agent-skill]

The same skill is also available as a plain markdown file:

```txt
https://s3.delivery/s3delivery.skill.md
```

Install it into your agent's skills directory, then ask the agent to use the
`s3delivery` skill when adding uploads or AI-agent file tools.

## Real file tools [#real-file-tools]

When your own agent backend needs file access, use `s3delivery/ai` server-side:

```ts
import { S3Delivery } from "s3delivery";
import { createFileTools } from "s3delivery/ai";

const s3 = new S3Delivery();
const tools = createFileTools(s3, { readOnly: true });
```

Start read-only. Add `requireApproval` before exposing `uploadFile` or
`deleteFile` to autonomous flows.