# Posy

> Documentation for Posy, the open-source link in bio that looks like you made it by hand. You or your AI can make and edit it.

- [Introduction](https://docs.posy.page/index.md): Posy is a link-in-bio page that looks hand-made. Pick a look, add your links, publish. Edit it yourself or let your AI do it.
- [Quickstart](https://docs.posy.page/quickstart.md): Get a Posy page live on posy.page.
- [Your first page](https://docs.posy.page/first-page.md): Three ways to build a page: by hand, with an AI, or from a file.
- [Looks gallery](https://docs.posy.page/looks.md): Pick a look for your page. Each one draws your tiles in its own way, and switching never loses a thing.
- [Connect an AI app](https://docs.posy.page/agents/connect.md): Let Claude, ChatGPT, Cursor, VS Code, Claude Code or Codex make and edit your Posy page.
- [llms.txt](https://docs.posy.page/agents/llms-txt.md): Plain-text entry points for AI agents.
- [MCP tools](https://docs.posy.page/agents/tools.md): Every tool the Posy MCP server offers, with its inputs.
- [The page file](https://docs.posy.page/agents/format.md): One small JSON file describes a whole Posy page. Any chat can write it.
- [Agent guide](https://docs.posy.page/agents/guide.md): Rules, tile types, REST examples and the CLI for agents that edit a Posy page.
- [REST API](https://docs.posy.page/api-reference/introduction.md): The same operations as the MCP server, over plain HTTP.
- [Get your page](https://docs.posy.page/api-reference/get-your-page.md): Your page: draft, version, publish state
- [Replace the draft](https://docs.posy.page/api-reference/replace-the-draft.md): Replace the draft (send baseVersion to avoid overwriting newer changes)
- [Claim a username](https://docs.posy.page/api-reference/claim-a-username.md): Create your page (claim a username)
- [Import a page file](https://docs.posy.page/api-reference/import-a-page-file.md): Load a Posy page file (brief or full page JSON)
- [Add a tile](https://docs.posy.page/api-reference/add-a-tile.md): Add a tile from a link, email, owner/repo or note (auto-detected), or a full tile object
- [Change the theme (POST)](https://docs.posy.page/api-reference/change-the-theme-post.md): Change theme settings (same fields as the MCP set_theme tool); send only what should change
- [Change the theme](https://docs.posy.page/api-reference/change-the-theme.md): Change theme settings (same fields as the MCP set_theme tool); send only what should change
- [Publish](https://docs.posy.page/api-reference/publish.md): Make the draft live
- [Read a published page](https://docs.posy.page/api-reference/read-a-published-page.md): Read any published page as JSON
- [Check a username](https://docs.posy.page/api-reference/check-a-username.md): Check if a username is available
- [Self-hosting guide](https://docs.posy.page/self-host/guide.md): Run Posy with Docker, Compose, Vercel plus Turso, or any Node host.
- [Environment variables](https://docs.posy.page/self-host/environment.md): Every setting a Posy server reads.
- [Telemetry](https://docs.posy.page/self-host/telemetry.md): What a self-hosted Posy sends, and how to turn it off.
- [Contributing](https://docs.posy.page/contribute/guide.md): Dev setup, where things live, how to add a look, and what to run before a pull request.
- [Community and security](https://docs.posy.page/contribute/community.md): Where to ask questions, report problems and read the project rules.
- [Changelog](https://docs.posy.page/changelog.md): What changed in each Posy release.

## OpenAPI Specs

- [openapi](/api-reference/openapi.json)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.