For agents · MCP
A safe publishing loop for agents.
Give Claude Code, Cursor or any MCP client an Agent key. It edits the preview, checks the result at a real URL and promotes a numbered release when the check passes. You can take any step yourself in the dashboard, including rolling back a release the agent made.
Connection
- Endpoint
- https://api.pagesprinter.com/mcp
- Transport
- Streamable HTTP
- Header
- Authorization: Bearer sk_…
- Key preset
- Agent
The loop
Edit, check, review, promote.
The server's help tool gives your agent this order. Production changes only at step 04, and step 05 undoes it.
-
Edit the preview
pagesprinter_write_file
pagesprinter_patch_file
pagesprinter_batchWrites land in the preview only. Each one returns the preview URL of the page it touched, so the agent knows where to look.
-
Check the preview
northwind-docs.pagesprinter.page/pricing
The agent fetches the page or opens it in a browser tool. Previews are real HTTPS sites, so what it sees is what visitors will get.
-
Review the changes
pagesprinter_changes
Lists every file added, changed or deleted since the live release. This is exactly what a promote would ship, so stray edits show up here.
-
Promote with a message
pagesprinter_promote
Creates the next numbered release and waits up to 60 seconds for it to go live. The result includes the production URLs and the release to roll back to.
-
Roll back if needed
pagesprinter_rollback
Points production at an earlier release. Nothing is copied, and the preview keeps the agent's work so it can fix the problem and promote again.
Setup
Connect in three steps.
-
1.
In the dashboard, open API keys, create a key with the Agent preset and copy it. The secret is shown once.
-
2.
Add the server to your client with one of the configurations shown here. The key goes in the Authorization header; there is nothing to install.
-
3.
Ask the agent to call pagesprinter_help. It returns the loop above and lists the sites the key can reach.
Claude Code · terminal
claude mcp add --transport http pagesprinter \
https://api.pagesprinter.com/mcp \
--header "Authorization: Bearer $PAGESPRINTER_KEY"
Cursor · .cursor/mcp.json
{
"mcpServers": {
"pagesprinter": {
"url": "https://api.pagesprinter.com/mcp",
"headers": {
"Authorization": "Bearer sk_…"
}
}
}
}
Any other MCP client
- URL
- https://api.pagesprinter.com/mcp
- Transport
- Streamable HTTP (POST)
- Header
- Authorization: Bearer sk_…
Example session
One request, one release: #13.
A Claude Code session with the key ci-agent. The agent changes one price, looks at the preview, reads the diff and promotes. The release shows up in the dashboard as promoted by ci-agent via MCP.
Claude Code
pagesprinter MCP
- >Change the Team plan to €12 on the northwind-docs pricing page and ship it.
- •pagesprinter_read_filenorthwind-docs · pricing.html · 6.1 KB10:13:48
- •pagesprinter_patch_fileold: "€9 / month" → new: "€12 / month"preview_url: https://northwind-docs.pagesprinter.page/pricing10:14:03
- •Fetched the preview200 · Team plan shows €12 / month10:14:27
- •pagesprinter_changesadded: 0 · changed: 1 (pricing.html) · deleted: 010:15:10
- •pagesprinter_promotemessage: "Update Team plan price" · wait_seconds: 3010:15:42
- ✓Release #13 is livehttps://docs.northwind.studio · 124 filesrollback: pagesprinter_rollback release #1210:16:01
Permissions
What an Agent key can do.
Each key carries scopes, and the server lists only the tools a key is allowed to call. No key can write production files: production changes only by promote or rollback, and each one records the key that made it.
| Action | Agent | Read-only | Full |
|---|---|---|---|
| List sites and read settings | Yes | Yes | Yes |
| Read preview and production files | Yes | Yes | Yes |
| Write, patch, move and delete preview files | Yes | No | Yes |
| Promote and roll back | Yes | No | Yes |
| See domains and their DNS status | Yes | Yes | Yes |
| Create, rename or delete sites | No | No | Yes |
| Add, rebind or remove domains | No | No | Yes |
| Write production files directly | No | No | No |
Tools
Every tool the server offers.
They map one to one onto the REST API, so anything an agent does you can repeat with curl.
- Sites
-
pagesprinter_list_sites
pagesprinter_create_site
pagesprinter_update_site
pagesprinter_delete_site
pagesprinter_help
- Files
-
pagesprinter_list_files
pagesprinter_read_file
pagesprinter_write_file
pagesprinter_patch_file
pagesprinter_move_file
pagesprinter_delete_file
pagesprinter_batch
pagesprinter_create_upload
- Releases
-
pagesprinter_changes
pagesprinter_promote
pagesprinter_list_releases
pagesprinter_get_release
pagesprinter_rollback
pagesprinter_reset_preview
- Domains
-
pagesprinter_list_domains
pagesprinter_add_domain
pagesprinter_verify_domain
pagesprinter_remove_domain
Give your agent a preview to work in.
Create a team, add a site and make an Agent key. Plans start at €9 a month.