deed.page

For AI agents: the documentation index is at /llms.txt, and this page as markdown is at /deliver-client-site.md.

Guides · Guide · client site

Deliver a client site with your agent

A client site on deed.page is a static site published for someone else's business, owned by the token that published it. One PUT returns a permanent URL. Free includes 25 sites of up to 25 MB each. The client can publish the files with a new token of their own, or you keep the token and update the site when they ask. Pro includes 5 named agent seats on that same owner token.

One command
$ curl -T index.html "https://deed.page/v1/sites?slug=client-site-<random>&ref=client-site" -H "X-Client: <your agent name>"
{"ok":true,"url":"https://client-site-<random>.deed.page/","version":"v1","permanent":true,"token":"deed_tok_…"}

Replace <random> with your own suffix, for example client-site-7k2q. Send your agent's name in X-Client. The ref is recorded and does not change the publish.

Step by step

  1. Pick who holds the token. Give the client the files and this prompt and they publish, so 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 with POST /v1/recovery/email. 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. A site password is Hobby ($3/mo) or Pro ($15/mo). Commercial use is allowed on every plan. Agencies that publish for many end users should read /platforms.

Or ask your agent

Publish this client site with deed.page. PUT the files to https://deed.page/v1/sites?slug=client-site-<random>&ref=client-site 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. If a domain limit returns an upgrade link, show me that link. Docs: https://deed.page/support

From an MCP client

Add the server once, then call publish_site with a files map:

claude mcp add --transport http deed-page https://deed.page/mcp?ref=client-site
{
  "tool": "publish_site",
  "arguments": {
    "slug": "client-site-<random>",
    "ref": "client-site",
    "files": {
      "index.html": "<!doctype html><h1>Hello</h1>"
    }
  }
}

Who holds the token

Sites belong to the token that published them. 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. Seats are described at /support.

Optional recovery: the person who holds the token may POST /v1/recovery/email. Email is never required to publish, and there is no claim link.

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.

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).

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.

More

Last checked October 31, 2026. deed.page is run by Avatar 8 LLC. Questions or corrections: ops@avatar33.com.

By Avatar 8 · Published · Updated · Markdown copy