Swolvy MCP server

Swolvy MCP server and skill: publish HTML from Claude, ChatGPT, Gemini and coding agents

Swolvy turns an HTML file into a shareable link. Drop a file on swolvy.com, or let your AI assistant (Claude, ChatGPT, Gemini) or coding agent publish it for you, and get a short link with optional password protection. No signup is needed. A page can be replaced later without changing its link, and Swolvy Pro adds pages that never expire, files up to 100 MB and your own domain.

This repository is the public home for the two ways AI assistants publish through Swolvy:

• the remote MCP server at https://swolvy.com/api/mcp, for Claude, ChatGPT, Gemini, Claude Code, Cursor and any other MCP client
• the swolvy skill for Claude Code, in skills/swolvy, built on the HTTP API

Swolvy itself is not in this repository. server.json describes the server in the MCP Registry format.

Add the MCP server

One address, OAuth sign-in, no API key. The server works without a Swolvy account: anonymous uploads return a link and an edit token. During sign-in you can also link the connector to a Swolvy account, so pages land in your dashboard and the account tools below are added.

https://swolvy.com/api/mcp

The transport is Streamable HTTP with OAuth 2.1 (dynamic client registration and PKCE).

Claude (claude.ai and desktop)

1. Open Settings, then Connectors.
2. Choose Add custom connector.
3. Paste https://swolvy.com/api/mcp and confirm.
4. Sign in when asked: continue without an account, or link your Swolvy account.

Claude Code

claude mcp add --transport http swolvy https://swolvy.com/api/mcp

Run /mcp inside Claude Code to complete the OAuth sign-in. Add --scope user to make the server available in every project.

ChatGPT

On chatgpt.com: Plugins, then +, then Add custom MCP server. Paste the address, choose OAuth as the authentication, then install the plugin. The desktop app's Add MCP server form (Streamable HTTP) works too, but without account linking.

Cursor

Add the server to .cursor/mcp.json in your project, or to ~/.cursor/mcp.json for every project:

{
  "mcpServers": {
    "swolvy": {
      "url": "https://swolvy.com/api/mcp"
    }
  }
}

Gemini

In the Gemini app: Settings & help, then Connected Apps, then Add a custom app, and paste the address.

For Gemini CLI, add the server to ~/.gemini/settings.json:

{
  "mcpServers": {
    "swolvy": {
      "httpUrl": "https://swolvy.com/api/mcp"
    }
  }
}

Any other MCP client

Add a remote server (Streamable HTTP) with the same address. Clients that support OAuth sign in through the browser; the server advertises its metadata at https://swolvy.com/.well-known/oauth-protected-resource/api/mcp.

Tools

Every connector gets the four publishing tools. A connector linked to a Swolvy account also gets the account tools. The team tools and the workspace parameter appear when the account belongs to a Swolvy Team.

Publishing tools (always available)

Shortened. The full README is on GitHub.