OxyPages
Start Free

Cursor And OxyPages

Publish From Cursor And VS Code

Add OxyPages to your editor's mcp.json once. Then the agent in Cursor or VS Code can publish your page, or deploy your built app, and hand you the link.

Start With No AccountConnect Your Account

No Account

Start With No Account In Cursor

With no key, the server offers publish_page and deploy_app. The agent gets a link that lasts 30 minutes and a claim link to keep it.

  1. 1

    Add The Server To Mcp.json

    Use ~/.cursor/mcp.json for every project, or .cursor/mcp.json in one project.

    {
  "mcpServers": {
    "oxypages": {
      "url": "https://mcp.oxypages.com/mcp"
    }
  }
}
  2. 2

    Ask The Agent To Publish

    In the agent chat, ask in plain words. For a framework app, it runs your build and sends only the output folder.

    Build this app and deploy it to OxyPages with no account. Give me the link and the claim link.

Your Account

Connect Your Account In Cursor

With your account connected, the agent can work on your projects much as you do in the dashboard, on your plan. Pick one of these.

  1. 1

    Use Your Key From The Environment

    Cursor fills ${env:NAME} from your environment. Set OXYPAGES_API_KEY in your shell profile to your own key from Profile, API Keys.

    {
  "mcpServers": {
    "oxypages": {
      "url": "https://mcp.oxypages.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:OXYPAGES_API_KEY}"
      }
    }
  }
}
  2. 2

    Or Sign In Instead Of A Key

    Use the account address. Cursor opens your browser so you can log in on oxypages.com and approve.

    {
  "mcpServers": {
    "oxypages-account": {
      "url": "https://mcp.oxypages.com/mcp/account"
    }
  }
}

Do not commit a file that holds a real key. The ${env:...} form keeps it out of your project.

Create An API KeyStart Free

VS Code

The Same In VS Code

VS Code keeps MCP servers in .vscode/mcp.json, or in your user profile through MCP: Open User Configuration. Its format uses servers and a type.

  1. 1

    No Account

    Add this entry, or run the command line below once.

    {
  "servers": {
    "oxypages": {
      "type": "http",
      "url": "https://mcp.oxypages.com/mcp"
    }
  }
}
  2. 2

    Or From The Command Line

    Adds the same no-account entry to your profile.

    code --add-mcp '{"name":"oxypages","type":"http","url":"https://mcp.oxypages.com/mcp"}'
  3. 3

    With Your Key

    VS Code asks for the key the first time the server starts and stores it for you, so it never sits in the file.

    {
  "inputs": [
    {
      "type": "promptString",
      "id": "oxypages-key",
      "description": "OxyPages API key",
      "password": true
    }
  ],
  "servers": {
    "oxypages": {
      "type": "http",
      "url": "https://mcp.oxypages.com/mcp",
      "headers": {
        "Authorization": "Bearer ${input:oxypages-key}"
      }
    }
  }
}

Tools

What Cursor Can Do On OxyPages

The no-account tools work for anyone. The account tools need your key or a sign-in, and cover most of what you can do in the dashboard.

Publish With No Account

No Account

Works with no key at all. Your agent gets a temporary link and a claim link.

  • publish_pagePublish an HTML page or a few static files to a live HTTPS link.
  • deploy_appDeploy the output folder of a built React, Vue, Svelte, Vite or Astro app. Your agent runs the build first.

Projects

Your Account

Create, inspect and change your projects, the same as in the dashboard.

  • list_sitesSee your projects and their live addresses.
  • create_siteCreate a new website on a free subdomain.
  • get_projectRead one project's settings and what your plan allows.
  • update_projectRename a project, change its subdomain, switch Single-Page App mode, or set a site password on paid plans.
  • archive_projectTake a project offline and keep every file, so it can come back.
  • unarchive_projectBring an archived project back online.
  • list_archived_projectsSee your archived projects.
  • delete_projectDelete a project. This cannot be undone.
  • list_mediaSee the files in a project's media library.

Deployments And Versions

Your Account

Publish new versions and switch what is live.

  • read_site_filesRead a website's live files so your assistant can edit them.
  • update_site_filesPublish your assistant's changes: only the edited files, everything else kept.
  • deploy_sitePublish a complete new version of a website.
  • deploy_appDeploy a built app's output folder into your account.
  • list_deploymentsRead a website's version history.
  • restore_versionMake an earlier version live again, on plans with version restore.
  • list_app_deploymentsSee an app project's uploaded deployments.
  • make_app_deployment_liveMake an earlier app deployment live, on paid plans.
  • rollback_deploymentRoll a Git project back to an earlier deployment.
  • promote_buildPromote a preview build to production.
  • undo_rollbackUndo the last rollback.

Domains

Your Account

List domains now. Connecting domains from your agent is coming soon.

  • list_domainsSee a project's custom domains and the DNS records to create.
  • add_domainComing SoonConnect a domain you own.
  • check_domainComing SoonRe-check a domain's DNS and certificate.
  • remove_domainComing SoonRemove a domain from a project.

Insights

Your Account

Read your websites' visitor statistics.

  • get_analyticsRead page views, top pages, referrers and countries for 7, 30 or 90 days.

Git And Builds

Your Account

Deploy from GitHub. Connect GitHub once in the dashboard, then your agent can do the rest.

  • get_github_connectionCheck which GitHub account is connected.
  • list_github_reposList the repositories OxyPages can see.
  • list_repo_branchesList a repository's branches.
  • detect_repo_frameworkDetect a repository's framework and build settings.
  • import_repoImport a repository as a new project.
  • connect_repoConnect a repository to an existing project.
  • reconnect_repoReconnect a project to your GitHub connection.
  • get_git_settingsRead a project's Git and build settings.
  • update_git_settingsChange branches, framework, commands, Node.js version and preview rules.
  • list_buildsSee a project's builds.
  • get_buildRead one build in full.
  • get_build_logRead a build's log.
  • redeployBuild and deploy again.
  • cancel_buildCancel a queued or running build.

Previews, Deploy Hooks And Env Names

Your Account

Manage preview protection and deploy hooks, and read environment variable names.

  • list_previewsSee preview protection and open pull request previews.
  • set_preview_protectionTurn password protection for previews on or off, on paid plans.
  • rotate_preview_passwordReplace the preview password.
  • list_deploy_hooksSee a project's deploy hooks.
  • create_deploy_hookCreate a deploy hook URL.
  • delete_deploy_hookDelete a deploy hook.
  • list_env_varsRead environment variable names. Never their values.

Account

Your Account

Keep a no-account link, and check your plan.

  • claim_dropClaim a no-account link into your account before it expires.
  • get_usageRead your plan limits and what you have used.
  • get_billingRead your plan, renewal date and invoices. Read only.

Stays in the dashboard: environment variable values and changes, API keys, billing changes, password, email and two-factor, team members, project transfers and connecting GitHub.

Good To Know

The Limits, Plainly

Current sizes come straight from the platform, so this list is always up to date.

  • No-account links last 30 minutes. Open the claim link inside that time to keep the site in a free account, at a new address of its own.
  • A no-account page or static site takes up to 25 MB and 10 files. A built app takes up to 25 MB and 500 files.
  • OxyPages does not build a no-account deploy. Your agent runs the build and sends the output folder. Source code is refused.
  • The Free plan is for personal and non-commercial websites. Business, shop and client websites need a paid plan.
  • Git deploys are new: connect GitHub once in the dashboard, then your agent can import a repository and follow its builds.
  • A connected agent can archive or delete a project, like you can. It cannot see your password, change billing, manage API keys or change your email, two-factor or team.

Questions

Cursor FAQ

Yes. Connected with the plugin, the MCP server or just your API key, it reads your website's live files, makes the change, and publishes only the files it changed as a new version. With only a key it uses the REST API, which oxypages.com/llms.txt explains to agents. Your images and everything else stay as they are.

Every path, explained for people, is in Help: publishing from an AI agent.

Other Agents

Using Something Else?

Claude Code

Works with no setup at all. Add the plugin or a key for your own projects.

See The Setup

Claude

Add a custom connector. No account to try it, sign in for your own sites.

See The Setup

ChatGPT

Add it in Developer mode. No account to try it, sign in for your own sites.

See The Setup

Codex

One entry in config.toml. No key to try it, your key for your own projects.

See The Setup

Any MCP Client

The address and the header, for any other client.

See The Setup