How do I check that Codex sees the server?

Run codex mcp list in your terminal, or type /mcp inside Codex. OxyPages should be listed. With no key you see publish_page and deploy_app; with your key you see your account's tools.

Can Codex deploy a React or Vite app?

Yes, once it has built it. OxyPages does not build a no-account deploy, so Codex runs your build and sends the output folder. Source code is refused.

Can I keep the key out of config.toml?

Yes, and you should. bearer_token_env_var names a variable, and Codex reads the key from your environment when it connects.

What happens to a no-account link?

It lasts 30 minutes. Open the claim link before then to keep it in a free account, at a new address of its own.

Codex And OxyPages

Publish From The Codex CLI

Add OxyPages to Codex once. Then ask it to publish a page, or to build your app and deploy the output, and it hands you a live link.

Start With No Account Connect Your Account

No Account

Start With No Account

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

Add The Server

Run this once in your terminal.

codex mcp add oxypages --url https://mcp.oxypages.com/mcp

2
Or Edit Config.toml
The same thing by hand, in ~/.codex/config.toml.
```
[mcp_servers.oxypages]
url = "https://mcp.oxypages.com/mcp"
```
3
Ask Codex To Publish
Check the server with codex mcp list, or /mcp inside Codex, then ask in plain words. For a framework app, Codex 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 For Permanent Sites

With your key, Codex can work on your projects much as you do in the dashboard, on your plan. Codex reads the key from an environment variable, so it never sits in the config file.

Point The Server At Your Key

In ~/.codex/config.toml.

[mcp_servers.oxypages]
url = "https://mcp.oxypages.com/mcp"
bearer_token_env_var = "OXYPAGES_API_KEY"

2
Set The Variable
Add this to your shell profile, with your own key from Profile, API Keys. If the variable is missing, Codex connects without a key and you get the no-account tools.
```
export OXYPAGES_API_KEY=oxy_YOUR_KEY
```
3
Or Sign In Instead Of A Key
Add the account address, then run codex mcp login. Your browser opens oxypages.com, where you log in and approve.
```
[mcp_servers.oxypages-account]
url = "https://mcp.oxypages.com/mcp/account"

# then, in your terminal:
# codex mcp login oxypages-account
```
4
Or No MCP: Just Your Key
Skip the config block, set only the variable above, and ask in plain words. With only a key, Codex uses the OxyPages REST API, which oxypages.com/llms.txt explains: it reads your live files and publishes only what it changed.

Use a separate key for each agent, so you can revoke just that one.

Create An API Key Start Free

Tools

What Codex 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.

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

Codex 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

Publish From The Codex CLI

Start With No Account

Add The Server

Or Edit Config.toml

Ask Codex To Publish

Connect Your Account For Permanent Sites

Point The Server At Your Key

Set The Variable

Or Sign In Instead Of A Key

Or No MCP: Just Your Key

What Codex Can Do On OxyPages

Publish With No Account

Projects

Deployments And Versions

Domains

Insights

Git And Builds

Previews, Deploy Hooks And Env Names

Account

The Limits, Plainly

Codex FAQ

Using Something Else?

Claude Code

Claude

ChatGPT

Cursor

Any MCP Client

Publish From The Codex CLI

Add The Server

Or Edit Config.toml

Ask Codex To Publish

Point The Server At Your Key

Set The Variable

Or Sign In Instead Of A Key

Or No MCP: Just Your Key

Publish With No Account

Projects

Deployments And Versions

Domains

Insights

Git And Builds

Previews, Deploy Hooks And Env Names

Account

Can It Edit A Website I Already Have?

How Do I Check That Codex Sees The Server?

Can Codex Deploy A React Or Vite App?

Can I Keep The Key Out Of Config.toml?

What Happens To A No-Account Link?

Claude Code

Claude

ChatGPT

Cursor

Any MCP Client