CustomJS MCP Server

A remote Model Context Protocol server that gives AI agents web superpowers — host HTML pages on a public URL, generate PDFs, capture screenshots, scrape sites, and run sandboxed code — using your own CustomJS API key.


Endpoint	`https://mcp.customjs.space/customjs/mcp`
Transport	Streamable HTTP
Auth	`x-customjs-api-key` header (per-user API key)

There's nothing to install or self-host — it's a hosted remote MCP server. Bring your CustomJS API key and connect.

Tools

Tool	What it does
`customjs_host_html_page`	Publish static HTML and get a public `lp.customjs.space` URL (upsert by name)
`customjs_list_html_pages`	List your hosted pages (name, url, pageId)
`customjs_delete_html_page`	Delete a hosted page by name or pageId
`customjs_html_to_pdf`	Convert HTML to PDF (Nunjucks templating)
`customjs_markdown_to_pdf`	Convert Markdown to PDF
`customjs_screenshot`	Capture a full-page website screenshot
`customjs_scrape_html`	Extract fully-rendered HTML (JavaScript-aware)
`customjs_run_code`	Run JavaScript in a secure sandbox
`customjs_help`	Built-in usage examples (topics: pages, pdf, screenshot, scraping, code)

Get an API key

Create a free key at https://www.customjs.space/integration/native-api/api-key. Your key is sent per request as the x-customjs-api-key header and is never stored by the connector.

Connect

Claude Code — plugin (recommended)

/plugin marketplace add customjs/claude-plugin
/plugin install customjs@customjs-tools

You'll be prompted only for your API key. (See customjs/claude-plugin.)

Claude Code — without the plugin

claude mcp add --transport http \
  --header "x-customjs-api-key: <your-key>" \
  customjs https://mcp.customjs.space/customjs/mcp

Claude Desktop (JSON config via `mcp-remote`)

{
  "mcpServers": {
    "customjs": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://mcp.customjs.space/customjs/mcp",
        "--header", "x-customjs-api-key:${CUSTOMJS_API_KEY}"
      ],
      "env": { "CUSTOMJS_API_KEY": "your-key" }
    }
  }
}

Other MCP clients (Cursor, VS Code, etc.)

Add a remote / HTTP MCP server pointing at https://mcp.customjs.space/customjs/mcp with the header x-customjs-api-key: <your-key>.

Hosting HTML pages

customjs_host_html_page publishes static HTML and returns a public https://lp.customjs.space/<shortId> URL. Hosting again with the same name updates the existing page (upsert by name).

Note: the public URL is served via CloudFront, so immediately after an update it may briefly show the previous content until the cache refreshes.

Official MCP Registry

This server is published to the official MCP Registry as space.customjs/customjs-mcp (DNS-verified on customjs.space) — see server.json. For how it's published and the full directory list, see PUBLISHING.md.

License

The contents of this repository (documentation and registry manifest) are released under the MIT License. The CustomJS service itself requires a valid API key and is governed by CustomJS's terms of service at https://www.customjs.space.