Posy

io.github.Himanshu-Sangshetti由 GitHub 帳號 Himanshu-Sangshetti 發布v2.0.0更新於 Oct 24, 2026

Make and edit a hand-made link-in-bio page: add links, pick a look, publish.

已驗證Streamable HTTP可網頁執行效率與工作流媒體與設計

概覽

AI 產生的概覽

Posy 的託管 MCP 伺服器，讓助理用你的帳號製作、調整樣式並發佈一個手作風格的 link-in-bio 頁面。

可以做什麼
  • 讀取目前的草稿、公開網址和下一步建議
  • 一次性認領使用者名稱建立頁面，或從頁面檔案匯入整頁
  • 新增一個或多個連結與卡片，並修改、排序或刪除
  • 設定外觀、配色、字型、名字和簡介，並列出可用選項
  • 發佈草稿，讓頁面正式上線
適用情境
適合想讓助理代你建立或改造個人 link-in-bio 頁面——加連結、換外觀、發佈——而不必在工作室裡手動編輯的情況。
執行需求
遠端端點 posy.page/api/mcp，使用 streamable HTTP，透過 OAuth 登入 Posy 帳號（無需複製金鑰）。免費帳號可用基本外觀，其他外觀需 Pro，每月 5 美元或每年 48 美元。自架實例使用自己的網址。
安裝前請注意
助理可以修改你的頁面並發佈，使草稿正式上線，發佈前請先檢查變更。發佈後名字、簡介、連結和電子郵件會出現在公開頁面上。Pro 付費功能需要花錢。REST API 另需 Agents 頁面產生的 Bearer 金鑰。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Posy，將其新增到工作區。
  2. 連接 所需的 憑證。它們會被私密儲存，絕不會在公開頁面上展示。
  3. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.Himanshu-Sangshetti%2Fposy/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。 客戶端會在首次連接時完成 OAuth 登入。

{
  "mcpServers": {
    "posy": {
      "type": "http",
      "url": "https://posy.page/api/mcp"
    }
  }
}

README

[posy: a link in bio that looks like you made it by hand. A girl works at her desk on a floating island in a painted sky, with a kite flying beside her.]

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.
Free and open source. Use it at posy.page or run it yourself.

[CI] [MIT licence] [Version] [Official MCP registry] [Docs] [GitHub stars]

Website · Docs · Connect your AI · Self-host · Contributing

[Add to Cursor] [Install in VS Code] [Install in VS Code Insiders] [Add to Claude] [Install in Goose] [Set up ChatGPT]

[圖片]

What is Posy

Posy is a link-in-bio page that looks hand-made. You pick a look, add your links, and publish. Edit it yourself in a calm studio, or ask your AI to do it for you. Your page is one small JSON file you can take anywhere.

[Three steps: 1, pick a look. 2, add your links, and Posy turns each one into the right tile. 3, publish to posy.page/you, or ask your AI to do all three.]

[圖片]

The looks

The same links, drawn as a wooden desk with polaroids, a Japanese print, a desktop left open, a watercolour, a two-ink print or a netrunner's screen. Each look has four palettes, and you can switch any time.

[A short tour of the looks on a desktop: Desk, Washi, Lofi, Painted, Cobalt and Night.]

[Desk: a wooden desk with polaroids, a record and letters.][Washi: a Japanese print with rice paper, ink and a red seal.][Lofi: a desktop left open where every tile is a window.]
[Painted: watercolour paper, letters and wax seals.][Cobalt: a vintage print in two inks, under a crescent moon.][Night: a netrunner's screen with one signal colour.]

On posy.page, Painted, Desk and Lofi are free, and the others come with Pro. Self-hosted, every look is unlocked. See them live in the looks gallery.

See each look on a desktop
[Desk: a wooden desk with polaroids, a record and letters.][Washi: a Japanese print with rice paper, ink and a red seal.]
[Lofi: a desktop left open where every tile is a window.][Painted: watercolour paper, letters and wax seals.]
[Cobalt: a vintage print in two inks, under a crescent moon.][Night: a netrunner's screen with one signal colour.]
Tiles, palettes and layouts
TileWhat it shows
LinkFavicon, title and an optional preview image
Social29 platforms (X, Instagram, GitHub, LinkedIn, YouTube, TikTok, Bluesky, Threads, Substack…) and email
NoteShort text with bold, italic and links
SectionA heading that starts a new group of tiles
ImageYour photo or artwork, with an optional caption and link
VideoYouTube, loads only when played
MusicSpotify embed
GitHubA repo with live stars and language, refreshed daily

Three layouts: bento (a grid), list (one column) and canvas (place tiles freely). Photos can be printed natural, mono, dither or ascii. On top of each look's palettes: Cream, Lavender, Mint, Sky, Peach, Paper, Blush, Sage, Midnight, Mocha, Dusk and Ocean, any accent colour, and font pairs.

[圖片]

Make your page

Claim your name at posy.page. Paste a link anywhere to add a tile, drag to arrange, and press Publish. Your page is live in a minute.

Just looking? Open posy.page/new, paste a few links and see your page before you sign up.

Free, Pro and self-hosted
posy.page Freeposy.page ProSelf-hosted
Tiles, editor, API, MCP, CLIAllAllAll
LooksPainted, Desk, LofiAllAll
Your own domainNoYes, HTTPS set up for youYes, point it at your server
AnalyticsBasic12 months + CSV12 months + CSV
"Made with Posy" footerShownHide itHide it
Setup and upkeepNoneNoneYou

Pro is $5 a month or $48 a year. Your page works the same everywhere: Settings → Download page.json on one, Import page.json on the other.

[圖片]

Connect your AI

Posy has a hosted MCP server, so your AI can make and edit your page. You sign in with your Posy account; there is no key to copy. Everything it does lands in your draft, and nothing goes live until you, or it, publish.

text
https://posy.page/api/mcp

One click

[Add to Cursor] [Install in VS Code] [Install in VS Code Insiders] [Add to Claude] [Install in Goose]

A few steps

[Set up ChatGPT] [Set up Claude Code] [Set up Codex]

bash
claude mcp add --transport http posy https://posy.page/api/mcp   # Claude Code, then /mcp → Authenticatecodex mcp add posy --url https://posy.page/api/mcp               # Codex

In ChatGPT, open Plugins, press +, choose Add custom MCP server, paste the URL and pick OAuth. On your own server, use https://YOUR-POSY/api/mcp. Posy is in the official MCP registry as io.github.Himanshu-Sangshetti/posy.

No connector? Hand it a page file

Any chat can write your page as one small JSON file. Paste it at posy.page/new and it becomes a page.

[A JSON page file on the left, with name Mira Sol, look washi and a few links. An arrow points to the same page rendered in the Washi look on a phone.]

Or skip the file: an AI can hand you a link that opens a live preview, no sign-in needed.

text
https://posy.page/new?name=Mira%20Sol&look=washi&links=https://github.com/mira,[email protected]
The page file, MCP tools, REST, llms.txt and the CLI
json
{  "posy": 1,  "name": "Mira Sol",  "bio": "Writer and editor.",  "location": "Lisbon",  "look": "washi",  "links": [    "https://substack.com/@mira",    "https://x.com/mira",    "[email protected]",    { "heading": "Writing" },    "https://mira.so/letters"  ]}

Every field: the page file.

ToolWhat it does
get_pageYour draft, public URL, and what to do next
create_pageClaim a username and create your page (once)
import_pageLoad a whole page from a page file
add_tileAdd one link, or many at once. Posy picks the right tile
update_tile, move_tile, remove_tileChange, reorder or delete a tile
set_theme, set_profileLook, colours, fonts, name and bio
publishMake the draft live
list_optionsAllowed looks, palettes, fonts and sizes
SurfaceWhere
REST/api/v1/page with a Bearer key from the Agents page. Spec: /openapi.json, guide: API reference
Public JSON/api/v1/public/<username> for any published page
llms.txtposy.page/llms.txt for the app, /<username>/llms.txt for any page
Schemasschema/page.schema.json and /schema/brief.schema.json
PluginClaude Code and Cursor skills in plugin/
bash
export POSY_URL=https://posy.page POSY_API_KEY=posy_...npm run posy -- add https://github.com/owner/repo --size wnpm run posy -- theme --preset moonlit --layout listnpm run posy -- publish

Full guide: docs/ai-agents.md. Working on this repo with a coding agent? Read AGENTS.md.

[圖片]

Run it yourself

[Deploy with Vercel]

Or with Docker:

bash
git clone https://github.com/Himanshu-Sangshetti/posy.git && cd posydocker build -t posy . && docker run -p 3000:3000 -v posy-data:/data \  -e NEXT_PUBLIC_SITE_URL=http://localhost:3000 -e BETTER_AUTH_URL=http://localhost:3000 \  -e BETTER_AUTH_SECRET=$(openssl rand -base64 32) posy

Open http://localhost:3000 and sign up: the first account owns the instance, and every look is unlocked. Domains, backups and every setting: self-hosting guide · .env.example

Built with

Next.js 16 · React 19 · TypeScript · Tailwind CSS 4 · Motion · dnd-kit · shadcn/ui · Better Auth · Drizzle + libSQL · Zod · MCP

One schema, src/lib/schema.ts, describes a page. It drives the JSON Schema, the REST API, the MCP tools and the editor, so they never drift apart.

How the pieces fit
mermaid
flowchart LR  studio["Studio<br/>(browser)"] --> app  agent["AI agents"] -- "MCP /api/mcp" --> app  scripts["Scripts, CLI"] -- "REST /api/v1" --> app  app["Next.js app<br/>page schema in Zod"] --> db[("SQLite or Turso<br/>(Drizzle + libSQL)")]  app --> files[("Uploads<br/>data dir or Vercel Blob")]  app --> page["/username<br/>+ llms.txt + public JSON"]
WhereWhat
src/components/page/styles/The looks, one .tsx + .css each
src/components/studio/The editor
src/app/api/REST (v1), MCP (mcp), auth and uploads
src/lib/Schema, looks, palettes, fonts, link detection

From source: npm install && npm run dev (Node 22 or 24). Your local data lives in ~/.posy.

Contributing

Issues and pull requests are welcome. Start with CONTRIBUTING.md.

  • Add a look. A look is a .tsx and a .css file plus a lab page to check it in every palette. The steps: Adding a look.
  • Pick up an issue. Good first issues and look ideas are a nice place to begin.
  • Before a PR: npm run check, npm test, and npm run e2e for UI changes.

Community, security and licence

  • Questions and ideas: issues. Please follow the Code of Conduct.
  • Found a vulnerability? See SECURITY.md and report it privately.
  • Posy is MIT licensed. The art that ships with the looks is public domain, CC0, or made for Posy; every file and its source is in public/looks/CREDITS.md. Some of it was generated with Krea 2, whose community licence allows commercial use only while your company makes under US$1M a year. Read the note in the credits file first.
  • Brand files and colours: BRAND.md.

[A painted meadow of wildflowers]

Made by hand, with a cat asleep on the desk.

來源：README.md，提交 253d020

工具

0
該伺服器需要登入，因此 SourceWeft 無法在沒有帳號的情況下讀取其工具，也未收錄。已連接帳號所能看到的內容可能因帳號及其權限而異。

版本歷史

1
  1. v2.0.0最新Oct 16, 2026

評分

已滿足適用檢查項的 85%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分