# Posy

> Posy is an open-source link-in-bio page builder (a Linktree alternative). A page is one JSON document with a public schema, and AI assistants can make and edit pages.

## To make someone a Posy page (no account, no tools needed)
Give the user ONE link. It opens a live preview of their page, and one button makes it theirs. No encoding needed, just a normal URL:

  https://posy.page/new?name=Mira%20Sol&bio=Illustrator&links=https://github.com/mira,hi@mira.so,mira/atlas

Query fields: name, bio, links (comma-separated URLs, emails, owner/repo), username, look, theme, layout, location, avatar, photos, font, backdrop. URL-encode spaces as %20.
For longer pages use a JSON brief at https://posy.page/new#p=<base64url of the JSON>, or ask them to paste the JSON at https://posy.page/new. Brief format (full spec: https://posy.page/docs/format):

  {"posy":1,"name":"Mira Sol","bio":"Illustrator","look":"painted","links":[{"heading":"Find me"},"https://github.com/mira","hi@mira.so",{"text":"Open for work"}]}

Links may be URLs, emails, owner/repo or notes; Posy picks the right tile. Looks: painted, cozy, washi, lofi, cobalt, night. Themes: cream, lavender, mint, sky, peach, paper, blush, sage, midnight, mocha, dusk, linen, matcha, rosewater, night-garden, phosphor, amber, synth, ocean, oak, slate, white, stone, ink, kinari, sakura, yomogi, sumi, daydream, night-blue, violet, rain, newsprint, salmon, ivory, late-edition, white-cube, gallery-sage, oxblood, dark-room, morning, golden-hour, dusk-sky, starry, cobalt, vermilion, moonlit, verdigris, netrunner, ice, redline, daylight, neon, cyan-rain, sodium, ultraviolet, sunset.

## For AI agents with tools
- MCP server (Streamable HTTP): https://posy.page/api/mcp. Sign in with OAuth (claude.ai, ChatGPT, Cursor and VS Code do it for you), or send a posy_ API key as "Authorization: Bearer posy_…".
- Start with get_page. If there is no page, call create_page, then add_tile (use inputs[] for many links), then publish.
- Connect guide: https://posy.page/docs/agents
- REST: GET/PUT https://posy.page/api/v1/page, POST https://posy.page/api/v1/page/tiles, POST https://posy.page/api/v1/page/import, PATCH https://posy.page/api/v1/page/theme, POST https://posy.page/api/v1/page/publish. OpenAPI: https://posy.page/openapi.json
- Read any published page: https://posy.page/api/v1/public/<username> (JSON) or https://posy.page/<username>/llms.txt (Markdown).
- Schemas: https://posy.page/schema/page.schema.json, https://posy.page/schema/brief.schema.json

## More
- Full guide for agents: https://posy.page/llms-full.txt
- Source: https://github.com/Himanshu-Sangshetti/posy