Foliyo

npx add-mcp 'https://foliyo.io/mcp'

Hosted by Foliyo. Sign in once in each client. Your saved projects, senders, guides and audiences stay with your account. Approve mcp workspace:write to edit pages created in other clients; a restricted mcp grant keeps its existing limits.

Choose your agent

Codex

Run these commands, then complete browser sign-in:

codex mcp add foliyo --url https://foliyo.io/mcp
codex mcp login foliyo --scopes 'mcp,workspace:write'

Or use Settings → MCP servers → Add server → Streamable HTTP. Save, restart and authenticate. The desktop app, CLI and IDE extension share host configuration.

Official setup documentation

Cursor

Add to .cursor/mcp.json or ~/.cursor/mcp.json, then enable Foliyo and sign in:

{
  "mcpServers": {
    "foliyo": { "url": "https://foliyo.io/mcp" }
  }
}

Cursor CLI shares this config:

agent mcp login foliyo
agent mcp enable foliyo
agent mcp list-tools foliyo

Editor docs · CLI docs

Claude Code

claude mcp add --transport http --scope user foliyo https://foliyo.io/mcp
claude mcp login foliyo

Use /mcp inside Claude Code to authenticate on older versions. Shared project configuration needs an explicit HTTP type:

{
  "mcpServers": {
    "foliyo": {
      "type": "http",
      "url": "https://foliyo.io/mcp"
    }
  }
}

Official setup documentation

Replit Agent

Add the hosted server and approve the browser sign-in. No local process or API key is needed.

Add Foliyo to Replit

Manual setup: Integrations → MCP Servers for Replit Agent → + Add MCP server. Name it Foliyo, enter https://foliyo.io/mcp, then choose Test & save.

Replit supports OAuth for custom servers and custom headers in Advanced settings. Review workspace permission during consent.

Connection guide · Install-link reference

Teach your agent the Foliyo workflow

Install the Foliyo skill, then ask: “Create me a Foliyo proposal for Acme using our saved project.” The skill supplies the workflow; the MCP connection supplies the account tools.

Agent	Save the skill as
Codex	.agents/skills/foliyo/SKILL.md
Cursor	.cursor/skills/foliyo/SKILL.md
Replit Agent	.agents/skills/foliyo/SKILL.md
Claude Code	.claude/skills/foliyo/SKILL.md

These are project paths. Give your agent the skill URL and ask it to install the document in the matching directory, or copy the complete skills/foliyo directory from the source repository when that revision is available.

01 · PREPARE

Start with your context

Your agent loads the matching project, sender, guide, audience and sharing policy before composing.

02 · CREATE

Make the work readable

It creates responsive static HTML, includes supported assets and checks the document before publishing.

03 · SHARE

Get a link that lasts

Get the live URL and PIN where applicable. Retrieve and update the source from another authorized client, keeping the same link.

A finished document, ready to hand over

Foliyo publishes static HTML. CSS, raster images and fonts can be sent as base64 assets and inlined. Script-driven charts and application screens need a static version first; Foliyo does not run arbitrary applications or backend services.

Your explicit or saved sharing policy wins. Without one, the agent can use a generated PIN and tell you, or ask one essential question. An unverified email gate records a claimed address; it does not prove identity. Publishing never implies permission to send announcement or update emails.

Use shell commands or publish a local file

Download the standalone CLI from Foliyo. It needs Node 20+ and connects to the hosted service:

curl -fsSL https://foliyo.io/cli.mjs -o foliyo.mjs
node foliyo.mjs login
node foliyo.mjs tools
node foliyo.mjs publish ./report/index.html --options publish-options.json
node foliyo.mjs doctor

No npm installation is needed. Use node /absolute/path/foliyo.mjs as a stdio MCP command, or call POST /api/integration/call with a Bearer credential and {"name":"prepare_foliyo","arguments":{}} from a shell.

The 0.4.0 source CLI bridges to the same hosted server. Until npm publication is confirmed, build it from a checkout with Node 20+:

npm --prefix mcp install
npm --prefix mcp run build
node mcp/dist/server.js login
node mcp/dist/server.js tools
node mcp/dist/server.js call brand_guide --json context.json
node mcp/dist/server.js publish ./report/index.html --options publish-options.json
node mcp/dist/server.js doctor

context.json can contain {}. Publishing options can contain {"title":"Client update","gate":"pin"}. call TOOL --json - reads stdin. With no arguments, the CLI starts a stdio bridge. After installing version 0.4.0, use foliyo in place of node mcp/dist/server.js.

Use PUBLISH_API_KEY for an explicit key and PUBLISH_API_URL to choose a backend. Keep credentials in the environment or a secret store.

Connect a stdio-only client

A generic third-party bridge forwards your client's MCP calls to hosted Foliyo:

{
  "mcpServers": {
    "foliyo": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://foliyo.io/mcp",
        "--transport", "http-only",
        "--static-oauth-client-metadata",
        "{\"scope\":\"mcp workspace:write\"}"]
    }
  }
}

The default OAuth flow needs a browser and loopback callback. Bridge documentation.

Check the connection

Inspect the tool list and ask your agent to load Foliyo context with prepare_foliyo or brand_guide. Preflight a small document, publish it with a PIN, then retrieve it with get_page. An update denied in a second client may require reconnecting with workspace:write.

Native setup follows official documentation checked on 5 September 2026. Protocol compatibility is separate from live client verification; these instructions do not claim end-to-end testing of the current Cursor or Replit UI against this deployment.