Connect an AI app

Posy has a hosted MCP server, so an AI can make and edit your page: “make me a link in bio page”, “add my latest video”, “switch to the dark look”. Everything an AI does lands in your draft. Nothing goes live until you (or it, when you ask) publish. The server is https://YOUR-POSY/api/mcp. On the hosted Posy that is https://posy.page/api/mcp. You sign in with your Posy account, so there is no key to copy.

Claude (claude.ai, Desktop and mobile)

Settings → Connectors → Add custom connector → name it Posy, paste the URL, then sign in to Posy when asked.

ChatGPT

Settings → Apps & Connectors → Advanced → turn on Developer mode → Create → paste the URL, choose OAuth, and sign in to Posy.

Claude Code

claude mcp add --transport http posy https://YOUR-POSY/api/mcp

Then run /mcp inside Claude Code and choose Authenticate. Or install the plugin, which adds a “make a page” skill:

/plugin marketplace add Himanshu-Sangshetti/posy
/plugin install posy@posy

Cursor, VS Code, Codex

Cursor: use the one-click install, or add the config below by hand.
VS Code: code --add-mcp '{"name":"posy","type":"http","url":"https://YOUR-POSY/api/mcp"}'
Codex: codex mcp add posy --url https://YOUR-POSY/api/mcp

A config file

Cursor reads ~/.cursor/mcp.json (or .cursor/mcp.json in a project). Other tools use .mcp.json in the project folder. Add this:

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

In Claude Code’s .mcp.json, add "type": "http" next to url. On your own server, change the URL to https://YOUR-POSY/api/mcp.

An API key instead

Scripts and tools that cannot open a browser can use a key from the dashboard’s Agents page:

claude mcp add --transport http posy https://YOUR-POSY/api/mcp --header "Authorization: Bearer posy_..."

No connector? Use a file

Any chat can write your page as a small JSON file, which you load at /new. See the page file.

What an AI can do

tool	what it does
`get_page`	Your draft, public URL, and what to do next.
`create_page`	Claim a username and create your page (once).
`import_page`	Load a whole page from a page file.
`add_tile`	Add one link, or many at once with `inputs`. Posy picks the right tile.
`update_tile`, `move_tile`, `remove_tile`	Change, reorder or delete a tile.
`set_theme`, `set_profile`	Look, colours, fonts, name and bio.
`publish`	Make the draft live.
`list_options`	Allowed looks, themes, fonts and sizes.

The looks an agent can pick (style): painted (the default), cozy (Desk), washi, lofi, cobalt and night. On posy.page, Painted, Desk and Cobalt are free and the other three come with Pro. More: the full guide.

​Claude (claude.ai, Desktop and mobile)

​ChatGPT

​Claude Code

​Cursor, VS Code, Codex

​A config file

​An API key instead

​No connector? Use a file

​What an AI can do