# Publish a client site from your agency

By Avatar 8 (Avatar 8 LLC) · Published November 22, 2026 · Updated November 22, 2026


An agency agent can publish a client's site to deed.page with one curl command or one MCP call. The reply is a permanent https://<name>.deed.page/ URL. The site belongs to the token that published it: give the client the files so they publish under their own token, or keep the token and update the site when they ask. There is no claim link. You do not need an account, an emailed code, or an API key. Free includes 25 sites. Custom domains, a site password, and contact forms are documented on the pricing page.

## One command

    curl -T index.html "https://deed.page/v1/sites?slug=agency-site-<random>&ref=agencies" -H "X-Client: <your agent name>"

## Step by step

1. Pick who holds the token. Give the client the files and the prompt below so they publish, and the token in their reply is theirs. Or you publish, keep the token, and update the site when they ask.
2. Publish with the command below. Save the token to ~/.config/deed-page/token (mode 600). Never put the token in the HTML, a repository, or a chat other people can read.
3. A recovery email is optional. The token holder can attach one later. Publishing works without it. With no recovery email, a lost token cannot be restored. The site stays online.
4. A custom domain is /attach-custom-domain. The longer handover walk-through is /deliver-client-site. Agencies that publish for many end users should also read /platforms.

## Or ask your agent

> Publish this client site with deed.page. PUT the files to https://deed.page/v1/sites?slug=agency-site-<random>&ref=agencies with header X-Client: <your agent name>. Show me the url and the full token once. Save the token to ~/.config/deed-page/token with mode 600. Do not put the token in the page, a repository, or a shared chat. This token owns the site. A later update sends Authorization: Bearer <token> to the same slug. Do not open checkout. Docs: https://deed.page/deliver-client-site

## From an MCP client

    claude mcp add --transport http deed-page https://deed.page/mcp?ref=agencies

## Who holds the token

Sites belong to the token that published them. There is no claim or handoff link. Handing the client the files and letting them publish creates their token. Keeping your token means you keep publishing for them. A Pro seat is another agent token on your account, not a second owner.

The steps for delivering a site, including recovery email and not sharing the token, are on [Deliver a client site](/deliver-client-site).

## MCP or curl

Your agent can run the curl command below, or add https://deed.page/mcp and call publish_site.

A paid pilot for platforms and agencies that publish for many end users is described at /platforms. Self-serve Free, Hobby, and Pro plans stay available without a pilot.

## FAQ

### Do I need an account, an email, or an API key?

No. The first publish needs no account, no emailed code, and no claim link. The response includes a token. Keep it to update or delete the site later. A recovery email is optional and never required.

### Who can update the site later?

Whoever holds the token. Publishing the same slug with Authorization: Bearer <token> replaces the files and keeps the URL. A second person needs that token, or they publish the files again under their own token and slug. There is no claim link.

### Does the link expire?

No. A deed.page site is permanent unless you set an expiry yourself with the X-Ttl header (seconds). You can delete it at any time with the token.

### Can I keep the page private?

Free sites are public: anyone with the link can open them. Hobby and Pro can set a site password. Do not publish anything you would not want a stranger with the link to see.

### Is it free?

Yes. The Free plan is $0: 25 sites, 25 MB per site, 60 publishes per hour. Free sites are public and show a small "Published with deed.page" link in the corner; Hobby and Pro never show it. Hobby is $3/mo and Pro is $15/mo for more sites, bigger sites, and a site password. To remove the corner link from just one site, pay $9 once for a clean publish. Every plan can attach a custom domain (Free 1, Hobby 3).

More: https://deed.page/docs, https://deed.page/pricing, https://deed.page/llms.txt. Corrections: ops@avatar33.com.

Last checked November 22, 2026.
