# Floppy docs

> Floppy turns any file into a short link, like `fpy.sh/k3x9`, and shows you who read it, page by page. It is free to start. These docs hold two guides: one for sharing from your Mac, one for AI agents and the API.

## Floppy for Mac guide

For people who share from their Mac. Set up the menu bar app, share from the menu bar and Finder, take screenshots and screen recordings, find them and your shared files in the Library, convert or compress a file before you send it, and read Markdown files as documents. Read it at https://fpy.sh/docs/mac, or as Markdown at https://fpy.sh/docs/mac.md.

- [Set up](https://fpy.sh/docs/mac#set-up)
- [Share a file](https://fpy.sh/docs/mac#share-a-file)
- [Convert and compress](https://fpy.sh/docs/mac#convert-and-compress)
- [Troubleshooting](https://fpy.sh/docs/mac#troubleshooting)

## Agent docs

For AI agents and developers. Connect Claude, ChatGPT, Cursor, Codex or VS Code over MCP, or upload with one HTTP call and no account. Every MCP tool, REST endpoint, plan limit and error code is listed. Read it at https://fpy.sh/docs/agents, or as Markdown at https://fpy.sh/docs/agents.md.

- [Connect your agent](https://fpy.sh/docs/agents#connect)
- [Upload with one HTTP call (no account)](https://fpy.sh/docs/agents#quickstart)
- [MCP server and tools](https://fpy.sh/docs/agents#mcp)
- [REST API endpoints](https://fpy.sh/docs/agents#rest)

## For machines

Plain files an AI agent or a script can read without opening the site.

- [llms.txt](https://fpy.sh/llms.txt): a summary of Floppy and a list of its pages
- [llms-full.txt](https://fpy.sh/llms-full.txt): the agent docs in one Markdown file
- [openapi.json](https://fpy.sh/openapi.json): the REST API as an OpenAPI 3.1 schema
- [auth.md](https://fpy.sh/auth.md): how an agent gets credentials
- [skill.md](https://fpy.sh/skill.md): an Agent Skill that teaches an agent to use Floppy
- [server.json](https://fpy.sh/.well-known/mcp/server.json): registry metadata for the MCP server at `fpy.sh/mcp`

## Related

- [Floppy](https://fpy.sh/index.md): what Floppy is, its plans and common questions
- [Floppy for Mac](https://fpy.sh/mac): the menu bar app
- [For AI agents](https://fpy.sh/agents.md): setup for Claude, ChatGPT, Cursor, Codex and VS Code
